A powerful tool to synchronize in real-time Adobe Flash Catalyst and Adobe Flash Builder.
CatalystBuilderSync 0.6.2
DISCLAIMER
This tool manipulates files on your computer so use it wisely. I decline any responsibility for any loss of data due to the wrong use of this tool.
This is an alpha version, not fully tested yet so use it at your own risk.
-
I know, it sounds scary, but you must be aware of these points. That said, there’s an automatic backup function to protect your data as much as possible so you can easily revert to previous versions.
_
[Edit: It's not possible anymore to edit Catalyst's preferences in its second beta but there's a workaround here]
Overview
Adobe Flash Builder 4 and Adobe Flash Catalyst (both in their first second beta version at the time I’m writing this) could make a great couple. The rough code, the power of data on one side, the fanciness of graphic design, the fun of animations on the other side, both are meant to end up together at some point. But obviously there are still some pretty rough edges and both just don’t seem to be ready to move in together. Builder can import Catalyst’s projects, but it means recreating a new project every time. And on the other hand, even if Builder can export its projects in FXP as well, Catalyst can simply not read them. Bummer.
So everyone goes with his own approach for an as-smooth-as-possible-workflow. I listed some and offered my own one not so long ago, remember. Ok, that was one step in the right direction, but one could hardly call that smooth and straightforward.
So I decided to come up with my own solution to speed a bit up the inevitable happy ending of the Catalyst/Builder love story. And that solution is CatalystBuilderSync.
Current Features
- - One-way (Catalyst or Builder data only) or two-way (merge) synchronization
- - Automatic synchronization
- - Can synchronize entire projects or simply sub-folders (like the default components folder for example)
- - Automatic activation: whenever a project is opened in Catalyst, if this project is registered in CatalystBuilderSync it is automatically activated (and the other projects are deactivated accordingly).
- - Deletions synchronization
- - Revert to previous version functionality: every time an operation is performed an incremental backup of both Catalyst and Builder projects are created so the user can restore his projects to a previous state
- - Auto-update functionality to automatically stay up to date with further versions of CatalystBuilderSync
- - File extension filter: CatalystBuilderSync copies only specific files (mxml, as, xml, png, jpg, jpeg, gif, ico, swf, swc, ttf, f4v) and doesn’t affect other files that might be present in the projects folders (like hidden subversion files for example). You can freely add other filetypes specific to your own projects.
Planned Features
- - Windowshade functionality to reduce the real estate occupied by CatalystBuilderSync to the active project only
- - Stay on top functionality
- - Notifications to give a visual feedback when a synchronization occurred. It might also become complementary to the auto-sync functionality: instead of synchronizing all the time a notification could pop up every time a modification in the projects occur (or at regular interval) and let the user decide when and what kind of synchronization he wants to trigger.
- - Improving CatalystBuilderSync UI: what’s the point in having a software that simplifies exchanges between Catalyst and Builder and doesn’t fully take all the benefit of it?
Screenshots
Screencasts
It might look a little bit long to watch all of them at first but I would most definitely advise you to do so. There are some precious informations there about how to set up Catalyst and Flash Builder, how the auto-synchronization works and a lot of other things. If you’re here to have a quick look at how CatalystBuilderSync works though, you can skip the 1st part and jump straight to the 2nd video: First Synchronizations, that’s where the tasty things begin.
Part 1 - CatalystBuilderSync Setup
Part 2 - First synchronizations
Part 3 - Work with multiple projects
Part 4 - Revert to previous version
Known Issues
- - The order the projects show up in your list can be different every time you restart the application. Not a major drawback but it’ll be fixed eventually
- - There’s a bug at the moment with the ApplicationUpdater framework and Flex 4. The only walk-around I’ve found for now is to deactivate the UI part of the updater so whenever the auto-update is activated in the preferences and that there’s a new version available on the server the update occurs automatically without asking for the user’s agreement. See the bright side: at least that way I’m sure everybody will be up to date until I come up with a better solution.
- - There’s currently no limit for the amount of backups so if you work with big projects it might become problematic at some point and you might want to delete manually some of your backup folders. I’ll explain in the next few days how to do that until I add an archive manager (pretty soon).
- - There’s a tiny issue with the dropdown lists which appear in an odd position. It’ll be sorted out as soon as I find out why it does that.
- - When you select a folder (for a project or the workspaces) the shown path on the left doesn’t update. The new selected path is correct though. To be fixed soon.
- - The result of the synchronizations doesn’t necessarily reflect automatically in Adobe Flash Builder and/or Adobe Flash Catalyst. This is a problem specific to both softwares, not CatalystBuilderSync. You can activate the Refresh automatically property but that won’t work every time. So don’t forget to sometimes refresh manually when swapping applications.
Remember: CatalystBuilderSync is here to simplify the workflow but we are still dealing with beta applications. - - I’m sure you’ll add plenty of other issues in the comments… (don’t throw stones at me please…)
Release Notes
Version 0.6.2:
- - First public alpha version.
Feedback would be most definitely appreciated (I just pray and hope you won’t totally break it in 5 minutes…)

Subscribe





You are giving more reasons to get into Catalyst.
Great tool, downloading to try right now.
Fantastic work Gilles!
Well, you should probably have tested it thoroughly before saying it’s a fantastic work but now it’s too late, you’ve already said it so I can just thank you
a video tutorial for this will be very convinent.
i lost all my files in my worspace with your app ! i’m so disappointed
Sorry to hear that but as shown in the videos you need to be careful when chosing which folders to synchronize. Never chose the entire workspace nor, in most case, a project’s root. Rather the src forlders or some subfolder. That said, you can always use the “Revert to previous version” function (accessible in your project’s details when clicking on Edit).
Also, all the files copied and/or deleted are backed up incrementally here:
/Users/gillesguillemin/Library/Preferences/CatalystBuilderSync.39CE7B966E62B7AC52B4EAB79DE5E1EB72BF8140.1/Local%20Store/Projects
This is an example with my own path on my Mac. You need to replace the username and the code after CatalystBuilderSync will likely be different on your computer.
Gilles… you Rock… I have now been using this tool in production, and it has saved me from having to refrain from using Flash Catalyst for real because of the inhering lack of roundtripping support with between Flash Builder and Flash Catalyst.
When I show it to people (many of whom are Adobe employees), everyone is excited !
I have come to a couple of ways to synchronize “for real” so I have support for changes made both places as well as adding business logic to application through SWC’s without compromising the structure and orchestration of the UI in the context of Flash Catalyst…
Its really too bad we didnt meetup at FOTB 2009, but you can rest assured that you have a couple of beers coming your way when it eventually happens !
Cheers,
Peter
Thanks a lot Peter I appreciate that. I was beginning to wonder whether this tool was eventually of any use to anyone but me. Obviously it is and I’m quite happy to hear that. My favourite pattern at the moment is the mediator described here. I’m going to publish soon a more complete example taking into account the deferred instantiation issues the new State system can generate.
And it’s too bad indeed I couldn’t come to FOTB but I’m sure we’ll find a way sooner rather than later!
When I go to choose a Catalyst project directory, Windows (XP) only shows me as far down as the directory in which the .fxp is stored. I don’t get a breakdown of the “sub-folders” that I see in Code view in Catalyst (src, libs, bin-debug, html-template). I don’t even see those when just browsing in Windows Explorer. But they are there in Code view of Catalyst. Is there some setting I’m missing? Not sure what I’m doing wrong. If I do select this top level directory as my project directly in CatalystBuilderSync, then the tool just spins its wheel but never finishes, and sync never happens.
Thanks for your help!
CatalystBuilderSync doesn’t synchronize the fxp files themselves. You must first open (or create) a project in Catalyst in order to be able to synchronize it. Let’s say the project you opened is called “TestSync.” When you open TestSync, Catalyst generates the following temporary project:
C:\Documents and Settings\[your profile]\Application Data\Adobe\Flash Catalyst\TestSync
That’s the folder (and its subfolders, like src, etc) you need to point at.
I hope that makes sense.
Hi! It is unable to download.
That’s weird. Just checked and everything looks fine to me. What’s your config? (OS, Browser, AIR’s version, etc) Anyone else has that problem?
Sorry! I had tons of problem in same time. Now everything is fine, and i updated AIR.
Thanks.
Sorry again! Could you give me a help? It’s not working, no syncronizing.
Windows 7
FB 4 + FC Beta2 (refresh.enabled=true write in)
Catalyst workspace:
C:\Users\[Username]\AppData\Roaming\Adobe\Flash Catalyst\workspace
FB4 workspace:
d:\WebDev\FB4 workspace
Syncronizing folders:
C:\Users\[Username]\AppData\Roaming\Adobe\Flash Catalyst\workspace\test\src
d:\WebDev\FB4 workspace\test\src
Users folder is able to write.
I haven’t got any idea.
Mmmhhhh, that’s bizarre. Ok, apologies if my questions sound stupid but:
- when you indicate [Username] in your various paths it actually is your real username (administrator or gillesguillemin or something else similar) correct?
- the automatic synchronization is OFF by default so you need to trigger it manually or to switch the autosync to ON (I know this is obvious but it’s often the obvious things that are forgotten).
I also take that you watched the 4 videos for a complete walkthrough, right? If not then you should probably do it as you might have missed something (but what exactly I confess I don’t quite know).
One last thing, check directly the content of the folders in windows explorer to see whether they really didn’t synchronize. It’s possible they did synchronize but Flash Builder and/or Catalyst projects didn’t actualize until you make a manual refresh.
I hope this helps. Tell me if not, I’ll keep trying to figure out what’s going on.
I also realize that your workspaces are located on 2 different volumes (C: for Catalyst and D: for FB). That’s something I’ve never tried before actually and even if there’s no obvious reason that shouldn’t work it still could be the reason. So if nothing else works you should consider trying to synchronize folders on the same volume see if it works.
Chanmé!!!
I was banging my head against the wall until I found your tool.
Thanks a lot dude.
Is it possible to get more than 25 states in catalyst with this?
I honestly don’t know but in my book 25 states hardly sounds like good practice anyway.
Hey gilles,
it didnt work on my windows 7 system.
I saw all your movies and i am sure i do everything like you would do.
Nothing happens if i use one of the FC->FB or FB<-FC Buttons. The Strange thing is, if i use the merge-Button FCFB, then your sync-app is hanging and i have to manuelly kill it with taskmanager. I tryed to change the directory access of both folders. Access didnt seem to be the problem. I am quite sure, that i set up the right directorys.
And i tryed to use, full Project folder, src-Folder and only components-Folder. Nothing happens, except the hang while using the merge-Button. I was always looking in the Folders in explorer, so it didnt have to do with reflesh-option of the programms. They still not syncronising. So i do it manuelly now ;(
Good luck
PS: do you test it on win? win7?
Hi Mike, that’s not a real surprise this is not working anymore but, anyway, don’t worry, it’s a matter of just a few days now (hint: MAX is beginning this weekend…) before CatalystBuilderSync is not of any use anymore…
Hi gilles, thanks for you answer. Sorry but I didnt understand. How will MAX changing the need of CatalystBuilderSync. You seem to know something, i didnt know. Can you explain that? A new version of Catalyst?
Hi Gilles. I am a french user of your App. Beau boulôt.
I am not a FB developper, just a FC user and need Wysiwyg interfaces to work on Flash.
I animate a HUB (groupe de discussion) on the Viadeo social network named Flash CATALYST and need people like you to add ressources and news. I wrote an article about you on it.
I did not find you among the Viadeo’s members.
I f you are interested in … It is there:
http://www.viadeo.com/groups/?containerId=00225ptfzx0od6e5
Thanks.
Article dedicated to you and your app on a FC’s forum hosted by MEDIABOX.FR.
http://creative.mediabox.fr/index.php?showtopic=46559
… written by myself.
Hi,
Thanks for this handy tool,works great. I found that, (since my Catalyst version will not allow for the preferences to be altered to auto refresh as shown in your tutorial) if I switched to Code view and opened up the files I was changing then Catalyst promts that files have been altered and updates them, same if I delete a file it offers to re-save or get rid.
Blessing.
Rod
Hi,
You need to include in default preferences File types: css, fxg or you will get broken catalyst projects.
apart from that I think this is a winner. Adobe should buy it off you.
rod