VSA Info and FAQ

This page last updated January 29, 2022

Please note that this is a completely un-official FAQ for the Visual Show Automation (VSA) application and 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.

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.

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(ed) 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:

DLA Bobcat



This was released by two guys on the DLA site and is my favorite (but also the only one I have used) . Unfortunately while not readily available as a kit, it is possible to get a PCB and build your own. They do come up for sale on the DLA for sale list now and again. I am working on getting more PCBs available for anyone that wants to make one. It’s features include:

8 servo ports each with 300 mA resettable fuse (8 bit)

8 constant current led ports (20 mA per led, adjustable by replacing resistor)

Each servo port can have it’s direction and endpoints adjusted

Each of the servo and led ports can be set for any DMX channel

Configuration by software

Medusa  http://www.ohmmygadgets.com/medusadmx.html

The was released by a Halloween enthusiasts and is available for sale on his site. Its features include:

8 servo ports (8 bit)

8 on/off dc ports (max 150 mA per channel)

8 dimmable led ports (max 150 mA per channel)

Board has DMX start channel set and all 24 ports are numbered from that address

Configuration by board jumpers

Northlight  http://northlightdmx.com/dmx512toRCservo.htm

This is a stage lighting product company but the price seems pretty decent. It’s features include:

8 servo ports (8 bit)

Adjustable pulse width (one setting for all channels)

Board has DMX start channel set and all 8 ports are numbered from base address

Configuration by board jumpers

Board Of Chuckie  http://www.skulltronix.com/servocontrollers.shtml

This board was designed for 3 axis skull but is usable for other applications however the maker only supports it’s use with VSA. It’s features include:

16 servo ports (8 or 16 bit)

2 led ports

Each servo port can have it’s direction and endpoints adjusted

Each of the servo and led ports can be set for any DMX channel (as offset from base address)

Allows control of servo power to shut off servos when not being used which extends the lifetime of the servos.

Configuration by software (that only works with the ENTTEC OPEN dongle)

Son Of Chuckie  http://www.skulltronix.com/servocontrollers.shtml

This board was also designed for 3 axis skull but is usable for other applications however the maker only supports it’s use with VSA. It’s features include:

14 servo ports (8 or 16 bit)

3 led ports

Each servo port can have it’s direction and endpoints adjusted

Each of the servo and led ports can be set for any DMX channel (as offset from base address)

Allows control of servo power to shut off servos when not being used which extends the lifetime of the servos.

Configuration by software (that only works with the ENTTEC OPEN dongle)

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 (Halloween Bob 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 Videos:

A long list of videos with VSA related content.