Please visit Straf Spul's main site. This is the nerdy corner.

Unique Random

swfLauncher vj-system

swfLauncher is a veejay system build entirely in Flash. It allows you to load several flash-movies on top of each other and manipulate some things in real-time like text messages and colors.

To view a demo and learn more about it's functionality read the straf spul's project-page first.


You can download a zip with a bunch of source-files by clicking this link.

Things you might need

swfLauncher makes use of Flash Media Server to establish connections between the controlpanel and the instances of the receptor. It might be usefull to obtain a copy of the server software at Adobe. You can download the developers-version for free.

A webserver like Apache is also desirable to host al the files on. I mostly use XAMPP, which can be downloaded from ApacheFriends.

Another optional thing you might need to compile some of the clips is the Papervision3D library. You can find this one at googlecode. However this is optional.

Server-side actionscript

If you succesfully installed the Flash Media Server and got it running, it is time to add some server-side actionscript. In the Applications folder of the Flash Media Server drop the folder ConnectToSharedObject which you will find in the server_side_application folder in the zip. Copy the whole folder ConnectToSharedObject to the Applications folder of FMS and not just the as-file.

Setting the paths to the server

The next thing you need to do is tell the controlpanel and receptor applications where they have to connect to.

We'll start with the controlpanel. Open the controlpanel.as file, you find in the controlpanel folder inside the zip. Locate the following line of code:

private var rtmpGo:String = "rtmp://localhost/ConnectToSharedObject";

Now replace localhost with the hostname or ip-adres your fms-server is running on. If you plan not to use the system over a network, but will only use one computer you will not have to change this.

You will need to do exactly the same with the receptor.as in the receptor folder inside the zip.

After you changed those values, you will need to compile both controlpanel.fla and receptor.fla again.

Setting the paths with flashvars

Both receptor and controlpanel have associated html-files, which embed the swf-files if deployed on a webserver like Apache. For the receptor this is the index.html and for the controlpanel this is the controlpanel.html. In both files you can set the path to the fms-server with flashvars so you don't have to recompile both applications if the ip-adress of your server changes.

If you want to set the paths with flashvars locate the following line of code in these html-files.

'salign', ''/*,
'flashvars', 'rtmpGo=rtmp://localhost/ConnectToSharedObject'*/

Uncomment it by removing /* and */ and then replace localhost with the desired ip-adress or hostname.

Adding your custom clips

When you have all this running, you might not be satisfied with the clips, text-messages and colorPallettes i have provided with the zip. And you might want to add your own flash-movies. To do this you open the swfLauncher.xml file. This is a simple xml-file with a very basic structure. Here you can add your own clips, text-messages and colorPallettes.

If you want to make flash-movies that have dynamic colors and textmessages applied to them by the controlpanel, you can study some of the as-files in the clips directory in the zip. I have included the source-files for the clips as well.

Final words

I know there are a lot of things you have to set up to use the sfwLauncher visual system and tons of things you have to configure. If you get stuck somewhere along the way, you can always drop me an e-mail at quintenclause[at]hotmail[dot]com. Also if you really enjoy it or actually use it or have coded to expand it in some way, i would also like to know.

Quinten Clause