This page last updated Jan 16, 2023

Please note that this is a completely un-official FAQ for the Visual Show Automation (VSA) application and that I have no affiliation with Brookshire Software. The following content is solely based on my own experience with the VSA and the various related applications.

Visual Show Automation (VSA) is a program used to sequence lighting, servos, motors, etc. in time with an audio soundtrack. It supports various controller boards connected via serial, USB and DMX. You will find more information here:

Brookshire software has a official FAQ on their site:

Below is a list of additional VSA related information that you may find useful. Let me know if you have any tips, comments or information that could be added. At the end are  links to YouTube videos and other sites with VSA information.

Why do I have to subtract one from the actual DMX address to enter it in the VSA address column?

The first version of VSA did not support DMX and was designed to work with the Mini-SSC servo controller. This serial connected controller supported eight servos and used zero for the first channel. Hence the first track in VSA started at zero which matched the first servo channel. However DMX uses one for the first channel rather than zero. When they added DMX support to VSA, I imagine they had to decide whether to add a dedicated DMX address column ( which would have most likely broken all existing users sequences) or use the original address column but require DMX users to subtract one from the DMX channel.

I have quite a few devices that use DMX. To manage the addressing I have spreadsheet that lists every channel. I have two columns for DMX addressing. One column is the actual DMX address. The other column simply subtracts one from the DMX channel to provide the VSA channel. Makes it a bit easier when configuring VSA so you don’t have to do any math in your head.

Why should I use a WAV file instead of a MP3 file?

Both will work with VSA but an MP3 audio file stores editing and other information in its header and this extra data can cause delays in the start of playing the audio. WAV files do not have this issue so it is recommended that you use them.

Why doesn’t VSA play my video file?

VSA only plays .AVI video files (assuming you have the video playing feature) and seems to be quite picky about type of .AVI file (and there is no mention of using video in the help section) Per the Brookshire web page it is recommended to avoid variable bit rate video and audio and they recommend you use raw RGB or XVID .AVIs. They recommend (and I have had success) with using VirtualDub to re-encode any video file into a format that VSA is happy with. Simply open your existing video file (even if it is already a .AVI file) and save as an AVI file. You may find that the file is now usable with VSA

Can I export or import VSA sequence information?

You can export the sequence data from a sequence into a spreadsheet (CSV file). It will have a line for each frame and a column for each track.

You can import data into a VSA file from a text file. The first line needs to just be the number of events. Each line after that needs to be the data for a single event in a specific order (check out the user manual for more information)

The only app I am aware of that creates VSA data for importing is Monkey Basic’s Track Skull. I’d love to have something that could generate lighting sequences for basic effects for both single lights and RGB fixtures.

However you can import a VSA file into xLights (an Xmas light sequencing program) and use it to control your props instead of running VSA. You can load the resultant xLights file into a Raspberry Pi based Falcon Player for a stand alone show controller.

Where do I get a user manual for VSA?

The only manual I know of is the Windows Help file that installs with VSA. This is a CHM (Compiled HTML Help) file called “vsahelp.chm” that you will find in your VSA folder. You can open it just by double clicking the file. I printed mine out for reference.

My version of VSA only supports 128 or 256 tracks. But I have DMX devices that are addressed above 256?

While your version of VSA can only support 128 or 256 tracks (depends on the version you have), each of the tracks can control any one of the 512 DMX channels.

Do I need to use DMX with VSA?

Not at all as VSA supports a number of control boards that connect via a serial or USB port (or even a parallel port if you have one still). However if you show starts to grow, you will find that DMX gives you much more versatility and makes connecting multiple props much easier especially if they are located any distance from the controlling PC.

Why doesn’t the DMX Relay type work with my DMX relay board?

The default Max value in the DMX Relay type is 1 (with a default of 0). This is fine if your DMX relay uses a value of 1 to activate but many DMX relay boards need a value of 128 (or higher). Just change the Max Position value of the DMX Relay track to 128 (or whatever your relay needs) and your event should then send the correct value

Why did I lose the sound file from my VSA sequence?

Your VSA sequence file (the .vsa file) does not include the sound file, it only includes the path to the sound file on your PC. So if you move the sound file, make sure you update file path information in the VSA Audio settings or it will not know where to find it.

Can I use some sort of library to store sequences of events I use often?

VSA supports something called Analysis that lets you save and import event sequences. The easiest way to do this is to first create a VSA file called “Library”. Create the sequence of events in this file. In each of the events make sure you use the same text for the Annotation. Make sure you only use this text for these events and no others. You can store multiple sequences in this Library file. Just make sure you use the same Annotation text for each event and make sure it is different from other sequences Annotations.

When you are in a new file you can import the sequence from your library file. Create an event in the new file. Right click on this new event and select “Analysis”. This will give you a dialog box where you can first select a library file (this would be the Library file you created above). Once you select the file you can use the “Import Function” drop down to select any of the event sequences you previously saved in the file. It helps if you use some sort of descriptive naming convention.

VSA will now paste the selected events into your new file. It will scale the imported events to match the time duration of the new event you had created. If your library sequence has multiple tracks it will paste the first track in the event you created and then add to tracks below that.

Is there a MAC version of VSA?

VSA only runs on a PC though I have seen people using it on a MAC by using a PC emulator. I have not tried this myself as I have a few old PC laptops that I use. You can run VSA on a pretty low end PC, pretty much something you’ll find people giving away these days.

Is there any other software like VSA?

Servo control is a pretty niche market and as far as I know VSA is the only inexpensive product that supports a wide range of controllers. Some of the high-end show control companies (GilderFluke) have software but it only works with their controllers. For other options check out my Animatronic Control Systems page.

What DMX adapters will work with VSA?

VSA supports the ENTTEC USB Pro, ENTTEC USB Open, and Velleman VM116/K8062 DMX dongles. For best performance and the least problems use the ENTTEC USB Pro. ENTTEC Open and Velleman dongle require processing from the PC to create the DMX stream and this can get affected if you PC gets bogged down. The ENTTEC Pro creates the stream on its own.

One caveat to the ENTTEC USB Pro is that it is quite pricey. The Christmas Lighting enthusiasts started making the move to DMX a few years back and have created quite a few ENTTEC USB Pro compatible USB based DMX dongles that you can get kits for. The are other compatible dongles on the market. Some of these will work with VSA and some may not. It will also depend on what version of VSA that you have.

Any way to make capturing events from a joystick easier?

Being able to capture the movement from a joystick is a great feature compared to using the software knob in the event properties however I find it difficult using a normal joystick. You have to press Button1 down in order to capture events and this can be kinda clunky, not to mention the typical game style joysticks don’t give a very linear motion..

What I really want is an old school pong style controller that simply has a single knob you can control with one hand and a button you can control with the other. The problem is that I could not find such a thing. Then I thought about using an Arduino.

This turned out to be pretty easy, I used an Arduino Micro (or any Arduino variant based on the ATmega32u4) as it has the USB controller built-in. This let me build a simple controller that works for my needs. You can find more details in this Instructable. Basically it is a joystick that just has the X axis and Button 1. If your version of VSA supports multiple capture channels you could add more channels. You can customize this to make it relevant for any sort of animatronics you may be working with.

What 3rd party apps exist for VSA?

Currently I am aware of the following third-party applications that are available from here:

Trackskull – This app is meant for 3 axis skull users. It allows you to create an importable VSA event file that you create listening to the audio track and using a 3 axis joystick or a IR head movement tracker to control the movements. It also has a puppet mode. Caveat to the IR head tracker is that it only works with TrackIR V4 which is out of production (and some versions of TrackIR V5).

Helmsman – This app provides scheduling and control of VSA sequences. You can add a USB based controller board that has 8 trigger inputs for starting sequences when a physical event happens. It also allows control over a network from a IOS or Android app.

Do I need the VSA Console add on?

While you can do some basic control of VSA by using DOS based batch commands it is pretty limited. The VSA Console provide some ActiveX controls that let third-party applications control VSA. This is needed for Helmsman. If you don’t plan on using the third-party applications or writing your own Director/Visual Basic/PowerPoint application then you probably don’t need it.

How can you do multichannel sound?

If you have multiple props controlled by VSA you may want the sound to come from various physical locations depending on what prop is being activated. You have a few options.

Stereo – A typical WAV or MP3 files supports two separate sound channels (left and right). If your show has two main props you could put the left speaker on one prop and then the right speaker on the other.  Then when you edit your audio file you can pan you source to the left or right side as required to make the sound appear to be coming from the prop of interest.

7.1 Surround Sound – The 7.1 surround system support 7 independent channels (though I have heard only 6 are usable as the 7th channel is the subwoofer and isn’t really usable). There are utilities that will allow you to encode a given sound file to make it play back on any one of the 6 channels. You then need a 7.1 sound card or USB sound adapter that will provide the independent outputs for each channel.

Multiple Sound Cards or USB Audio Modules – You can use multiple sound cards or USB sound modules with VSA. This allows you to pick a different sound card for different sound file. You could feed the audio from each sound module to a different prop.

DMX Speaker Switch – While I have not found anything commercially available you can make a DMX controlled speaker selector that lets you pick between 4 sets of stereo speakers. If you use this with the left right panning you can have 8 separate sound sources that you can locate with your props. It will require you controlling the speaker selector in your VSA sequence.

Other than the stereo panning I have not tried any of these methods although I am working on a DMX controlled speaker switch and will let you know how it turns out.

What DMX servo boards are available?

The great thing about using DMX is that is gives you a wide range of controller boards to choose from. The unfortunate thing is that the real market for DMX controllers is the entertainment business and they tend to have pretty hefty budgets compared to hobbyists. But a good thing is that over the last 10 years or so the DIY Xmas lighting and Halloween Haunt enthusiasts have embraced DMX and this has led to quite a few cheaper alternatives. Here is a list of the DMX based servo controllers I am aware of:



Board Of Chuckie & Son Of Chuckie

Blue Point Engineering

Fright Idea ServoDMX

Other VSA Information

VSA Related Web Sites:

The Animatronics Workshop – This site covers basic animatronic construction and includes information on using an Arduino as a USB connected servo driver for VSA.

Rampant Robots – Blog site with a post on using VSA.

SindySkinless – You can thank (or blame) the creator (HalloweenBob or Bob Robertson) of this site for the 3 axis skulls. The tutorial page has a great VSA Programming 101 primer and Bob has written an extremely detailed tutorial on recording audio and using the VSA Wavemotion Analysis to create your jaw servo movements: AUDIO RECORDING GENERAL TIPS AND USING AUDACITY. There are many other good resources here  and a link to the 3 axis skull build thread on Halloween Forum that he started. It is up to over 2000 postings now but is a worthy read.

PonyMaking – An Introduction to Animatronics site with some information on using VSA in the How To section.

VSA Related Forum Threads:

A great thread from HalloweenBob  on using a BoC (board Of Chucky) DMX  servo controller. It does have some great general VSA and DMX info:

HalloweenForum – Integrated Haunt Control using DMX/VSA

VSA Related Videos:

A long list of videos with VSA related content.