VISIBOX MANUAL
v3.3
Welcome to Visibox!
Visibox is a video and audio playback system for live performance. It is the âinstrumentâ you use to trigger visuals while you perform!
Use Visiboxâs drag-and-drop interface to create a song list and assemble the video clips, images, audio clips, or live camera feeds to accompany each song. While you perform, trigger your clips with a MIDI device such as a drum pad, piano-style keyboard, or foot pedals, or use your computerâs keyboard and mouse.
For more about Visibox, visit: https://spaceage.tv
In this guide, weâll look at:
- Visibox Terminology
- The Visibox Interface
- Setting Up Your Project
- Setting Up for a Live Performance
- Visibox Menu Tour
Visibox Terminology
Simply put, a Visibox Project contains a number of Songs, each of which may contain a number of Clips.
Project
The Project is the top level. It holds the Songs that make up your set list as well as their order, the Clips they contain, and their respective settings. The Project file collects all of your Songs and Clips into one place so that you can transfer it from one computer to another.
Song
A Song is the container Visibox uses to organize a grouping of Clips. It typically represents a piece of music, although it may be some other unit of a non-musical performance.
Note that a Song simply holds the visuals that play while you perform, so you do not need to upload an audio track for the song. However, you can attach audio clips to be used as backing tracks while you play. Attaching audio clips is discussed in the âSetting Up Your Projectâ section of this guide.
Clip
Clips are the visual elements that form the basic building blocks of a Visibox project. They are what the audience actually sees. Clips can be video files (MP4, M4V, MOV, or WEBM), image files (JPEG, PNG, GIF, BMP, SVG, TIFF, or WEBP), or cameras attached to the computer. You can adjust the speed of clips, the loop style, and what happens when you retrigger a clip once it is already playing. If the video used for a Clip has audio, that audio will play unless you Mute it (you can also adjust the relative volume).
Next, letâs get a birdseye view of the Visibox interface before moving onto more detailed instructions on how to use it.
The Visibox Interface
When you launch a Visibox Project, you see two windows: the Controller Window and the Output Window. Letâs take a look at the features of both.

Controller Window
The Controller Window is where you add and arrange the Songs and Clips that make up your Project. It is also used during the performance to see what Clip is currently playing or to select particular Songs and Clips. During a performance, the Controller Window would typically be on a display that only the performer can see, such as a laptop computer.

The Control Bar
At the top of the Controller Window is the Control Bar. This allows quick access to transport controls, readouts, and information that may be helpful to have during a performance. You can enable and disable the Control Bar in the
/ submenu.
The left side of the Control Bar contains transport buttons:
Play | Starts playback of the first Clip in the selected Song. |
Pause | Pauses playback of the currently playing Clip. |
Stop | Stops playback of the currently playing Clip. |
Previous Clip | Plays the previous Clip in the selected Song. |
Next Clip | Plays the next Clip in the selected Song. |
Previous Song | Cues the previous Song in the Project. |
Next Song | Cues the next Song in the Project. |
The right side of the Control Bar contains readouts and information.
Master Volume | This slider allows you to set the audio level of Visibox. |
Imaging | Click to set the audio imaging from stereo to mono. |
Audio Level | Visual indicator of audio playing in Visibox. |
Stopwatch | Click to start, stop, reset the timer. |
Time | The current time of day. Click to adjust readout settings. |
Battery Level | Current battery level with indicator for charging status. Note that the entire Control Bar will change color when on battery power. Additionally, it will flash when battery power is low. |
Fullscreen | Click to enter or exit full-screen mode. |
The Song List
The next section is the list of Songs in your Project. Thatâs the area where youâll add your Songs and Clips, which can then be dragged around and reordered.
Weâll talk more about the Song list later.
The Preview Pane
The bottom of the Controller Window shows a Preview Pane containing two sub-panes, the Output View and the Clip Preview. At the top of the Preview Pane is a handle that you can drag to resize. If you want to disable the Preview Pane, double-click on the handle or drag it all the way down.
The Output View
This area shows what is currently playing in the Output window. If the Output is showing on a screen behind you, this is a great way to see what is happening without having to turn around.
The Clip Preview
This area shows a more detailed view of the Clips in the active Song. Icons on the thumbnails indicate what happens when the Clips end or are retriggered. This is not a timeline â any of these Clips can be triggered at any time. The numbers on the thumbnails show the keys that trigger the Clips. The icons on the Preview thumbnails indicate what happens when a Clip ends or is retriggered (this is covered in detail in the âClip End Behaviorsâ and âClip Retrigger Behaviorsâ sections later in this guide).
Clicking on the progress bar in an active video Clip allows you to scrub and seek through the Clip.
Output Window
The Output Window is where your Clips play. During a performance, this will be what your audience seesâmost likely displayed using a video projector or other screen display. As you are designing your Project, you can view the Output Window alongside the Controller to see how things look as you assemble it and adjust settings.
While you are working on your Project, you can resize the Output window to any dimension that suits your workflow. When itâs time to perform, the Output resizes to fill the aspect ratio of the final display device (a projector, television, or other screen), so be aware that it may not match what you see while you work.

You can configure the Output to suit the needs of the projection device and environment. You can flip or rotate it to accommodate rear projection, ceiling-mounted projectors, or vertical projectors. You can also âLetterboxâ and âEnforce Aspect Ratioâ to control cropping of your content. And Visibox has the ability to work with video wall controllers to spread your output across multiple TV screens or projectors. This is covered in more depth in the section âSetting Up for Your Live Performance" later in this manual.
With the Output View enabled in the Controller Window, you may not want the Output Window open while you are editing and setting up your project. If you close the Output Window, you can reopen it by selecting from the Window menu or by using the keyboard shortcut.
Project Files and Folders
Visibox automatically saves your Project as you work, so you donât have to worry about losing your work. Additionally, Visibox automatically saves backups as you work, so if your Project file becomes corrupted, you can restore it quickly and easily. Visibox also has "undo" and "redo" functionality, so you can step back through your changes if you make a mistake.
On Macs, the Project data file and media files are kept in a self-contained Project file (.vsbx) that can be moved from one computer or drive to another. On Windows, the data file (.vsbp) and media files are stored together in a directory. To move a Windows Project to another computer or drive, you will need to copy the entire directory.
Note that Mac and Windows Projects are interchangeable, so you can move a Project from one platform to another without issue.
Setting Up Your Project
Visibox makes adding visuals to your live performance simple and intuitive. Visibox is not video editing software, but it does provide shortcuts that mean you wonât have to specially format videos before you use them. You may find alternative uses for the tools Visibox offers, but it was designed to add ambient, atmospheric visuals that play in the background to enhance the overall experience or heighten the emotional impact of your performance.
In this section, weâll look at the process of putting your show together.
Gather your visuals
The first step is to gather video and/or images (that will show on the screen during each song. The following formats will play natively:
Video:
- MP4 / MPEG4 (mp4, m4v, mpeg, mpg, mpv, m4p)
- QuickTime (mov, qt)
- Ogg (ogg, ogv)
- WebM (webm)
Codecs: h.264, VP8, VP9, AV1, Theora
Video conversion: Visibox will attempt to convert video files with non-native formats and codecs into a native format so they can be used in your Project. If the file cannot be converted, an error will appear.
Images:
- JPEG (jpg, jpeg, pjpeg, pjp)
- PNG (png, apng)
- WebP (webp)
- GIF (gif)
- BMP (bmp)
- SVG (svg)
The videos you find may be in different resolutions or aspect ratios. Thatâs fine! Visibox will make them work.
Animated GIF files will be converted to video to optimize file size and allow for greater control.
Creating a new Project
Launch Visibox and create a new Project (
). All of the Clips you add to Songs will be stored along with the Project.Adding Songs
When you create a Project, it is populated with one Song automatically.
The quickest way to add a new song is with the âN keyboard shortcut. You can also use the menu option.
To rename a Song, double-click in the Song frame to highlight the text and simply start typing. You can also use the
menu option.Customizing the Song list display
Note that by default, Visibox gives new Songs random spaceage-related names, but if you donât like that feature, you can have them named âNew Songâ instead. Look for the setting in
.Notice also that Song names are in all UPPERCASE by default. If youâd rather they appear the way you type them in, toggle the
menu item.Finally, you will find that text for the Song list is BIG! It may look clunky at first, but this is a feature that makes it easy to see the list at a distance when you are using Visibox during your show. You can control the size of the Song list using the Zoom feature: â+ to Zoom in and make it larger; â- to Zoom out for smaller text. (These options are also available in the menu.)
Rearranging Songs
You can change the song order by grabbing the handle at the top of a Song and dragging it into a new position. (Bonusâthe song numbering updates automatically!) If keyboard control is your thing, select the Song and use the ââ and ââ keys to move it up and down in the stack.

To make a duplicate of a Song and all the Clips it contains, type âD (or use the menu).
Continue adding and rearranging songs until you have your set list generally the way you want it. Itâs easy to update on the fly.
Copying Songs between Projects
You can also drag a Song from one Project to another. This is a great way to reuse a Song or a set of Songs across multiple Projects. Simply open both Projects at once, grab the Song by its handle, and drag to the target Project. This will copy the Song, along with all of its Clips and settings to the target Project. Note this will copy the media files as well, so it may take a moment depending on the size and quantity of these files.
Attaching audio to a Song
You can attach an audio file to a song to be used as a backing track while the Clips for that Song play. Native audio formats include:
- Mpeg-3 (mp3)
- Advanced Audio Codec (aac)
- Mpeg-4 audio (m4a)
- WAV (wav)
- FLAC (flac)
- Ogg (oga)
- OPUS (opus)
If you add an audio file that Visibox does not play natively, it will attempt to convert it to a native format. If the file cannot be converted, an error will appear.
To attach an audio track, right-click on the Song and choose
from the contextual menu (the option is also available in the menu at the top.) When there is an audio attached to a Song, its waveform displays in the background of the Song frame.
There can only be one audio track attached to each Song. Be aware that if your videos have audio, the Clip audio and the Song backing track will play at the same time.
Seeking/Scrubbing Through Audio
Below the waveform display, you will see a seek bar that allows you to scrub through the audio. Click and drag the seek bar to move to a specific point in the audio.
Selecting Multiple Songs
You can select multiple Songs at once by clicking the mouse outside of a Song handle and dragging the selection rectangle around multiple Songs handles at once. Selected Songs are outlined in blue. Repeat this behavior while holding down the shift (â§) key to add more Songs to the selection. Hold down the alt/option (â„) key to remove Songs from the selected group. Hold down the command (â) key on Mac or control (â) key on Windows and click individual Song handles to toggle their selection status.

Setting Options For Multiple Songs At Once
When multiple Songs are selected, you will be able to drag them, duplicate them, or edit them together. You will also be able to edit their common options together. For instance, if all selected Songs have audio attached, you can change the volume of all of them at once. If some of the selected Songs do not have audio attached, the volume option will not be available.
If you have multiple Projects open, you can copy single or multiple Songs by dragging from one Projectâs Controller window to another. This will copy the Songs, their settings, as well as all of their Clips and settings.
Working with Clips
Once you have one or more Songs added to the Project, you can begin adding the visual Clips.
The easiest way to add a Clip is to drag the video or image file from the desktop directly into the Song frame. Alternately, you can select single or multiple files from the desktop and use the Explorer/Finderâs âCopyâ command. Then, select the target Song in Visibox and use the âPasteâ command. You could also add a Clip with a menu option (â§âC will get the job done. When the Clip is added to the Song, its thumbnail appears in the Song frame.
) or by right-clicking on the Song and selecting there. Or if keyboard shortcuts are your thing,Rearrange the Clip sequence by grabbing a Clip thumbnail and dragging it into the new position. The â< and â> shortcuts move the selected Clip to the left and right, respectively. You can also drag a Clip from one song to another.
To duplicate a Clip, right-click on its thumbnail and select âD shortcut. Duplicate Clips can be dragged into other Songs. Visibox is optimized to use a single media file as the source for all duplicates of a Clip, so duplicates do not use up more disk space.
or use theSelecting Multiple Clips
Similar to the Mac or Windows operating system, multiple Clips can be selected at once by clicking the mouse outside of a Clip and dragging a rectangle around multiple clips at once. Selected Clips are outlined in blue. Repeat this behavior while holding down the shift (â§) key to add more Clips to the selection. Hold down the alt/option (â„) key to remove Clips from the selected group. Hold down the command (â) key on Mac or control (â) key on Windows and click individual Clips to toggle their selection status.
You can select all Clips with the âA) menu item. You can deselect any selected Clips with (â§âA or by clicking outside of any selected Clips in the Controller window.
(
Setting Options For Multiple Clips At Once
When multiple Clips are selected, you will be able to drag them, duplicate them, or delete them together. You will also be able to edit their common options together. For instance, if all selected Clips are video Clips, you can change all of the âWhen Clip Endsâ behavior for all Clips at once. However, if you have a mix of different types of Clips, some options may not be available. For instance, if you have both video and image Clips selected, you will not be able to edit the âWhen Clip Endsâ behavior because this is not an option for image Clips.

Copying Clips between Projects
Clips can be copied between Projects by dragging them from one Project to another. You can drag one clip, or select multiple Clips and drag them all at once. This is a great way to reuse Clips across multiple Projects. Simply open both Projects at once, select the clips you want to copy, and drag them to the target Project. This will copy the Clips, along with all of their settings, to the target Project. Note that this will copy the media files as well, so it may take a moment depending on the size and quantity of these files.
Clip audio
If the video file has audio, that audio plays when the Clip plays. To prevent the audience from hearing the audio, you can mute it by right-clicking the Clip thumbnail and selecting
(that option is also available in the Clip menu at the top). You can also adjust the volume for the Clip, which is useful for balancing the sound level across Clips and with your performance.Clip resuming behaviors
The very first time you play a clip, it will play from the beginning. The
options allow you to choose what happens when you come back to play this Clip again after playing another Clip. You can choose to either or . The second of these is good if youâve got a longer video clip and you want to pick up where you left off when you switched away.To change the resuming behavior, right-click on the Clip and select an option from the
menu (you can also access the options from the menu at the top).Clip retriggering behaviors
âRetriggeringâ happens when you trigger a Clip that is already playing. The default behavior is to
a video from the beginning. However, allows you to jump back about 1 second. If you want to ensure that you do not accidentally retrigger a playing video, choose the option.The retrigger behavior is indicated with an icon that displays centered below the progress line when the Clip is playing. Options include:

![]() |
Restart | (default) Clip plays from the beginning |
![]() |
Stutter | Clip jumps back a short amount of time |
![]() |
Scratch (Beta) | Clip scratches like a record, reversing and fast-forwarding at high speed for a moment |
![]() |
Reverse (Beta) | Reverse playback direction |
![]() ![]() |
Pause/Resume | Clip pauses, next trigger will resume from the paused position |
![]() ![]() |
Pause/Restart | Clip pauses, next trigger will restart |
![]() |
Stop | Clip stops and goes to black/background |
![]() |
Do Nothing | Nothing happens |
Clip end behaviors
Visibox gives you a lot of control over what happens when a particular Clip ends. By default, the Clip loops automatically, allowing it to continue playing until you trigger the next Clip while performing. To change the end behavior, right-click on the Clip and select an option from the
menu (you can also access the options from the menu at the top).An icon in the bottom-right corner of the thumbnail (in both the Song frame and the Preview) indicates what happens at the end of the Clip. The options with their respective icons are as follows:

![]() |
Loop | (Default) Clip starts over |
![]() |
Bounce (Beta) | Clip reverses direction when it reaches end/beginning |
![]() |
Stop | Clip ends and goes to black or the background image; audio stops playing |
![]() |
Freeze | Clip pauses on the last frame |
![]() |
Start next clip | The next Clip starts playing automatically |
![]() |
Cue next song | Activates the next Song but does not start playing |
Fade In/Out (Beta)
The
and submenus let you apply a fade in or fade out to each Clip individually. Fades are applied to the Clip in real time, so they do not affect the original video file. additionally defines the crossfade (dissolve) time between the previous Clip and the current Clip. Any value on the previous Clip is ignored when switching directly from one Clip to the next.To apply a fade, right-click on the Clip(s) and select a time value from the
or submenus. Fade In and Fade Out icons appear in the lower left and lower right of the thumbnail when a value is set.
![]() |
Fade In | Fade in or crossfade between Clips |
![]() |
Fade Out | Fade out to black or Background Clip |
Rotate and Flip
The
and submenus let you rotate and/or flip each Clip individually.Filters
The
submenu lets you apply filters to each Clip individually. Filters are applied to the video image in real time, so they do not affect the original video file. You can apply multiple filters to a single Clip. Filters include: , , , , , , , and .Cropping and Letterboxing
In most cases, videos for a live performance are intended to add visual texture and excitement to the stage, not to âshow a videoâ per se. With this in mind, by default Visibox crops Clips to make them display edge-to-edge in the Output Window for consistency. The advantage is that you can use a variety of video sources without editing them beforehand to fit a particular display. Visibox just makes it work!

If you have a Clip that must be seen entirely without any croppingâfor example, videos or images with text that should not be cut offâyou can opt to âletterboxâ the Clip. Letterboxing adds black bars as needed to show the whole video regardless of the aspect ratio of the final display. You can letterbox a particular Clip by right-clicking on its thumbnail and selecting
.
Note that if you need to letterbox all of the Clips in your project, you can also set Letterbox at the Project level (
). The Project level setting becomes the default, which you can then override for each particular Clip.Playback speed
You can alter the speed of a video clip from within Visibox by right-clicking on the Clip thumbnail and selecting
from the contextual menu. There are several options ranging from 3x down to .1x normal speed. The same option is available in the menu at the top.Output View in the Preview Pane
With the Output View enabled in the Controller Window, you can see the content Output Window on your laptop screen while you perform. This is useful if you are using a projector or other display that is behind you.
By default, the Output will be cropped to conform to the aspect ratio of the Output View. If you want to ensure the Output does not get cropped, right-click on the Output View and select "Letterbox".
The Output View can be resized by dragging the slider at the top of the Preview Pane or the slider to the right of the Output View. Double clicking on the vertical slider will disable the Output View.
Clips in the Preview Pane
When a Song is active, its Clips appear in the Preview pane at the bottom of the Controller window. Note that each Clip is assigned a number (top-left corner). You can trigger Clips by their reference number using the computerâs keyboard or a MIDI controller mapped to that Clip position. In other words, they do not necessarily need to play in the sequence in which they appear in the Preview. This is not a timeline; you can trigger any of these Clips at any time. They are there as a reference.
Grab the bar at the top of the Preview to make it larger or smaller. This is helpful for seeing what Clips are queued and available from a distance while you are on stage. You can also click on this bar to hide the Preview area entirely.
Seeking/Scrubbing Through Clips
You can seek or scrub through Video Clips in the Preview area by clicking on their progress bars. This is useful for finding a particular spot in a video Clip without playing from the beginning.

Rounded Corners
Visibox allows you to put rounded corners on your Clips using the
menu. You can choose roundness from 10% to 50%.
Attaching a camera
A cool feature of Visibox is that you can use a camera source as a Clip. For example, you could display a live close-up of the drummerâs view during their big solo or the singerâs view of the audience back at them.
Setting up a camera to import into Visibox is covered in the âBasic Hardware Setupâ section later in this guide.
Using MIDI to trigger Clips
While it is possible to select Songs and trigger Clips using the mouse and computer keyboard, Visibox really comes alive when you connect one or more MIDI devices. Not only can you control all of the performance aspects of Visibox, many MIDI devices will also light up to show you what is happening without needing to look at the Controller display.
Setting Up for a Live Performance
When you arrive at the performance venue, you will need to set up your laptop and display device (likely a projector). In this section, weâll cover the basic hardware setup for a typical show, as well as tools in Visibox for making sure your image appears at the proper scale and orientation when projected on a screen or some other display device.
Basic hardware setup
While it is possible to run Visibox on a single screen by fullscreening the Output window, this will hide the Controller window â so youâll be flying blind, unable to see what song is currently selected and other information from the Controller window. A better option is to use two displays.
Two-display setup
The most common way of using Visibox will be on laptop computer connected to a video projector. Visibox has been optimized so that you should be able to run it on just about any compatible Mac or Windows laptop connected to just about any video projector. You will probably find that a faster computer with a solid-state drive will load and play high-resolution media content better. Likewise, you will probably want a bright (3000+ lumen) video projector with 720P resolution or better. There are myriad different connectors on different computers and video projectors, but chances are good that with the right set of dongles and adapters, you can get from one to another.
More than two displays
There are countless ways to set up Visibox. If you would like to more than one display (projector, TV, LCD, etc.) showing to your audience, youâll want to decide whether you want the audience-facing displays to show the same thing or different things.
If you want to show the same content on multiple screens, you can use a simple HDMI splitter (about USD $20) to split the signal. This can also be done by attaching each display directly to multiple video outputs on the computer and using the computerâs settings to mirror the displays. However, this will use up more of your computerâs graphics resources, and may be less performant the the video splitter option.
If you would like to show different content on each screen, then your best bet is to use a video wall controller. This device takes a single video input and spreads the image across multiple outputs. They are available in a variety of configurations, from 2x2 to 4x4 and beyond. They are also available at a variety of price points, depending on the resolution and features you need. Weâve had good luck with a USD $150 2x2 video wall controller from Amazon. Most inexpensive video wall controllers will only support a single input resolution, and they will stretch this across whatever number of outputs you have. So, for instance, if you have 2 horizontal 16:9 video projectors on either side of the stage, the image spread across them will be squashed down and stretched out to fit the 32:9 aspect ratio of the combined display. But Visibox offers functionality to fix this. See the âVideo Wall Stretchâ section below.
Using a video wall controller, you can accommodate a wide number of screens. So you could have 3 vertical output screens, spread across the stage; 4 screens aligned horizontally; or 2 screens stacked. Youâd configure the video controller for 3x1, 1x4, or 2x1 respectively. Then within Visibox, you would select the appropriate number of columns and rows in the
submenu. You may also need to rotate the output to the video wall controller, either through system settings, or through Visiboxâs submenu.Common laptop video output formats:
- USB-C (or Thunderbolt 3)
- HDMI
- VGA
- DVI
- Display Port or Mini Display Port
- Thunderbolt 1 or 2
Common video projector input formats:
- HDMI
- VGA
- DVI
You can pretty easily find adapters between HDMI and any of these connectors. So you can usually use HDMI as your common denominator. For example: letâs say you have a new MacBook Air with USB-C connectors and an older video projector that only has a VGA connector. You could pick up a USB-C to HDMI adapter, a long HDMI cable, and an HDMI-to-VGA adapter and youâre good to go! Not all adapters are created equally though, so try out a few options if your first try doesnât work.
Attaching and configuring MIDI devices
Most modern MIDI devices will have a USB connection. Just connect the deviceâs USB to your computer (directly or through a USB hub) and Visibox should recognize it. If your MIDI device does not have a USB connection, you can find an inexpensive MIDI-to-USB and use that.
In order to use a MIDI device with Visibox, it will need to send either MIDI note information or continuous control (CC) messages. While this covers the vast majority of piano-keyboard-style, drum-pad-style, and drum-machine-style MIDI controllers, some MIDI pedals only send program change messages. When choosing a MIDI device to use with Visibox, just make sure it can send MIDI note or CC messages.
The best Visibox controllers will also receive MIDI messages in order to display an indicator (probably an LED) associated with each note/pad/trigger. Visibox will light up these LEDs to show how many Clip slots are available in the current song. And while a clip is playing Visibox will flash the LED associated with the trigger pad for that clip.
To map specific pads/keys on your MIDI device to specific functions in Visibox, open the MIDI Map window (found under
).Select your device from the MIDI Input menu selector at the top of the window. Your device should also be selected as the MIDI Output. You can enter MIDI note numbers or CC ids manually. However, the easier thing to do is to hit âLearnâ next to the function you would like to control. Then hit the pad/key on your device that you would like to use to control it. Do this for all of the pads/keys you would like to use.
Visibox will send MIDI messages to your device using the same settings as the input trigger in the MIDI Map. So if note 44 is set to trigger your first clip, note 44 will be sent to the MIDI device to indicate that the first clip is enabled and/or playing.
New MIDI devices will automatically be enabled as MIDI inputs for Visibox. If you would like to disable, visit Visibox > Preferences > MIDI Inputs and deselect your device. To allow your device to receive MIDI from Visibox, visit
and enable your device.
Selecting Songs Via MIDI Program Change
If you have a MIDI device or software that sends MIDI Program Change messages, you can use these to select Songs in Visibox. To set this up, go to
and select the input for the MIDI device that will send Program Change messages. Scroll to the bottom and find the âSelect Song By Program Changeâ option. From the dropdown menu choose either âSong Orderâ or âProgram Identifierâ:- Song Order: The Program Change message will select using the order of Songs in your Project. Program Change 0 will activate the first Song, Program Change 1 will activate the second Song, and so on.
- Program Identifier: The Program Change message will select the Song with the corresponding Program ID. You can choose the Program ID for each Song, by right clicking on the Song in the Controller window and selecting a numeric ID from âProgram Identifierâ submenu. Song titles are listed next to assigned Program IDs in the list. Selecting an assigned Program ID will swap the current Song's Program ID with that of the assigned Song.

Note: While MIDI Program Change messages are always in the range of 0-127, many hardware controllers (and some software) will display these as 1-128. So, for example, selecting "1" on the controller will actually sending Program Change 0 to Visibox. Since we're selecting the first Song, this is actually more intuitive than it sounds. Program Identifiers are also numbered 1-128, so depending on what type of a device you're using to send the Program Change messages, you may need to shift your values by 1.
Connecting an Elgato Stream Deck
If you have an Elgato Stream Deck, you can use it to control Visibox. Visibox will take over all of the buttons on the Stream Deck and automatically map them to the Clips in your current Song. It also shows buttons for Stop, Previous Clip, Next Clip, Previous Song, and Next Song.
Since Visibox takes over complete control, you will need to Quit Elgatoâs Stream Deck application. Then just launch Visibox, connect your Stream Deck and everything will work.

Connecting a camera
USB cameras are often referred to as âwebcams.â However, with various hardware adapters or software solutions, you can connect a wide variety of digital cameras to your computer. But in short, if it works with Zoom, itâll probably work with Visibox. Additionally, most laptops have a built-in camera. Just set up the laptop next to your drummer, add a Camera Clip to your project, and bonzo! Instant drum cam!
Connected USB cameras will show up under
. This is where you can choose which camera will be used when a new Camera Clip is added to your project. Right-clicking on a Camera Clip in the Controller Window will allow you to choose a specific camera for each clip. So if youâve got three cameras connected, you could switch between them.Handling audio
Any connected audio interfaces will show up under
. The first item in this list will simply default to the audio output youâve chosen in your system settings. You may just use your computerâs built-in output with Visibox. But if you have a higher quality audio interface that you want to use, you could set your system settings to use the built-in audio output (probably the built-in speakers on your laptop), and then set Visibox to use your external audio interface. This will ensure that any alerts or messages that you receive on your computer will come out of your internal speakers and not accidentally go out to the audience.Preserving aspect ratio
The âaspect ratioâ is the ratio of the width to the height of an image or screen. Some common media aspect ratios are 16:9 (referred to as HD or widescreen) and 4:3 (referred to as SD). Your videos have an inherent aspect ratio. Display devices (projectors, televisions, and other screens) also have their own aspect ratios.
When you set the Output window to Full Screen as you would for a performance (
), it resizes to match the aspect ratio of the display device and resizes the video in it too. Because you may not know the aspect ratio of the video projector you will be using, you can select â â to ensure consistent output.Using the âCalibration and Focusâ screen
In a typical performance situation, you may have only minutes to set up, focus, and calibrate a video projector. The âK) function projects an image with fine lines for easy focusing, bright colors for color calibration, and grayscale values to calibrate contrast. Various aspect ratios are indicated to help you determine the aspect ratio of the projector or display device.
(
Dealing with projector variations
Part of setting up your Project is to make sure it is suited to the projector or other display screen that it will appear on. Visibox provides a number of controls for making sure your videos display as you intend, regardless of the projector. You will see the results of your settings in the Output Window.
Rotate
Some projectors are suspended upside-down from the ceiling, in which case, you can rotate the Project 180 degrees (
) so the image appears the right way up.You can also use the Rotate function to show your video content vertically (rotated 90°). Vertical banner-like screens have the advantage of a smaller footprint on the stage.
Flip
If the venue uses rear-screen projection, use the Flip function (
) to flip the image horizontally so the picture is not reversed. You can also flip the output vertically.Soundcheck checklist
- Ensure that the laptop is plugged into AC power. You donât want to run out of battery power halfway through a show.
- Ensure that the laptop is connected to the projector
- Run Calibration and Focus (âK) and make sure the projector is aligned and focused
- If you are triggering Visibox with a MIDI device, ensure that it is sending/receiving MIDI. Trigger a few Clips. If it has indicator lights, ensure that these are lighting properly.
- If your project uses sound, run an audible video Clip or song with attached audio. Make sure sound is getting to the soundboard and monitors.
Visibox Menu Tour
We recommend using Visiboxâs keyboard shortcuts and right-clicking for contextual menus to quickly navigate and manipulate Songs and Clips. However, every function that has an efficient shortcut can also be accessed using the menus at the top of the application for instances when the mouse is preferable.
This section covers the functionality of every menu option in Visibox in detail. (Note that the wording and arrangements of these options may change slightly when the product is updated.)
Visibox Application Menu

The Visibox menu contains functions related to the application itself, such as registration, inputs and outputs, updates, and a few handy items such as
.This handles matters related to registration and authorization. Itâs where to go to purchase a subscription, and activate (or deactivate) Visibox.
- Increases the volume of the audio output by 10%.
- Decreases the volume of the audio output by 10%.
- If you have multiple audio interfaces connected to your computer, you can choose your preferred audio output here. Choosing âdefaultâ will use the output selected by the system.
- Selecting this menu item, will convert Visiboxâs audio output from stereo (or other multichannel) to mono. If you have created beautiful backing tracks with the tambourine panned hard left and the cowbell panned hard right, but the sound person hands you a single cord for your output, you can select this option and keep that glorious cowbell in your mix.
- If you have multiple USB cameras connected to the computer, this will let you choose which one to use for new camera Clips.
- Enable the MIDI device(s) that will control Visibox.
- Enable the MIDI device(s) that will be controlled by Visibox.
- This brings up the window where you define which MIDI notes and continuous controllers are associated with the various triggers and functions in the app. Want to stop the currently playing clip every time you hit middle-C on your keyboard? This is the place to set that up.
- Select this option to launch Visibox automatically when you log in to your computer. If your computer logs in automatically when you start it up, Visibox will be ready to go as soon as the computer is booted.
- If you want Visibox to start up in full screen mode, select this option. This is useful if you are using Visibox in a performance situation and donât want to have to switch to full screen mode every time you start the app.
- Visibox takes over all of the buttons on the Elgato Stream Deck. If you want to use your Stream Deck for something else, you can disable it here.
- Turn on/off the Control Bar at the top of the Controller window.
- Visibox generates a random space name when you create a new Song. If you find that annoying, select this option and the songs you add will be named âNew Songâ instead.
- Choose the language Visibox will use for its menus and other user interface elements.
- Visibox is constantly being improved. If you want to try out the latest features before they are officially released, select this option.
Checks to see if a newer version of Visibox is available.
File Menu

You can create a
or through the File menu. You can also create a new copy of the current project with the menu item.In order to allow you to undo, Visibox keeps a copy of the previous media added to the project.
acts like an âEmpty Trashâ on your computer, saving space by deleting unused media files in your project.Use Visibox to print a nicely formatted set list for your project. No more Sharpie markers! Print a copy for everyone in your band. Donât forget the sound person!
Project Menu

Settings in the Project menu apply to your Project as a whole. Itâs where you add new Songs and customize your view of the Controller and Output windows. Itâs where you specify how the Output window displays, and thus how your Project will look to your audience, allowing you to adapt your visuals to the environment where you are performing.
âN
Youâll likely get used to adding new Songs with a keyboard shortcut (âN), but this menu item is here if that is not an option.
By default, a black screen is displayed when your content stops and nothing is playing. But you can use the Add Background Clip option to specify a background image or video to display instead. You can also set a background by dragging an image or video file from the desktop to the Output window.
Background Clips apply to the whole project; in other words, you can not specify different background images for each Song.
Lets you rotate the Output display in 90° increments.
This setting lets you accommodate different projection systems. Flip the content horizontally for use with a rear-project system. Or flip the content vertically for use with a ceiling-mounted projector.
By connecting a video wall controller to your computer, you can span the Output Window across multiple displays. However, most video wall controllers will stretch your output to fit the combined aspect ratio of all the displays. This setting will allow you to to compensate for this stretching and ensure that your content is displayed correctly.
Once your video wall controller is connected and configured, choose the item from this menu to match the arrangement of your displays in rows and columns. If you have 2 projectors (arranged either horizontally or vertically), set on each side of the stage, you would choose â1 row x 2 colsâ from this menu. If you have 4 televisions stacked on top of each other, you would choose â4 rows x 1 colâ. If you have 4 video projectors projecting on all of the walls in an art installation, you would choose â1 row x 4 colsâ.
Find out more about connecting multiple screens to Visibox in the âSetting Up For Live Performanceâ section.
The
, , and items are intended to configure your Output when presented in full screen on a ceiling mounted or rear projection projector, or stretched out with a video wall controller. Select this option, so these settings only appear in our Output window when it is presented in full screen. This makes it easier to set up your Project without the Output window appearing sideways, upside down, backwards, or stretched out.By default, Clips fill the Output Window entirely, getting cropped as necessary. When the Output Window is set to âFull Screenââas is typical for a performance environmentâthe Output Window resizes to match the aspect ratio of the display device (a projector, television, or some other display). Your Output gets resized along with it.
However, there may be cases where you will want your content to have a different aspect ratio than that of your presentation screen. The
menu allows you to choose from many standard spec ratios (such as 4:3, 16:9, etc.) in both horizontal and vertical orientations in order to preserve the aspect ratio of the Clip, independent of the display device. Black bars will be added as necessary to make up the difference.This option lets you apply rounded corners to all the clips in your Project. Select from square, 5%, 10%, 20%, 30%, 40% or circle. Combined the âcircleâ option with a square aspect ratio, to show your Visibox project in a circle, regardless of your output screenâs intrinsic output ratio.
âL
Visiboxâ default setting is to crop videos so that they show edge-to-edge on any screen. However, if you would like to ensure that all of the Clips in a project do not crop, you can choose Letterbox (âL) at the Project level. You can also letterbox individual Clips using the Clip menu.
The default setting is to show all song titles on the controller screen in UPPERCASE, but if you would rather show them as typed, weâve got a menu item for that!
â+
â-
â0
These settings let you enlarge or reduce the size of the Song list in the Controller Window without affecting the Clips Preview at the bottom. This is handy for making them easier to see on stage.
Song Menu

The Song menu holds functions related to adding Clips and background audio to individual Songs in the Project. There are also menu items for renaming, moving, and deleting individual Songs, although it will likely be easier to do these tasks in the interface itself (i.e., dragging a Song frame to move it or double-clicking a Song title to edit it) or by using keyboard shortcuts.
â§âC
This prompts you to select a Clip file to add it to the Song. Clips can also be added by dragging them from the desktop into the Song frame.
â§âW
You can add a webcam feed to a song as if it were a video clip, showing content from any internal or external USB camera connected to your computer.
For songs that have an attached audio track but no visual Clips (note that Clips are required to trigger audio), this option generates an empty Clip used simply to trigger the audio track. If you are using a background image on your Project, the background would display through the Placeholder Clip, otherwise, it displays a black screen.
These are the controls for adding and removing a background audio track to the Song. This âbacking trackâ audio plays while the sequence of Clips is playing. You can also specify what happens when the audio track ends (stop the current Clip from playing, let the current Clip keep playing, loop the audio, cue the next Song, or start the next Song). Audio files can be:
- Mpeg-3 (mp3)
- Advanced Audio Codec (aac)
- Mpeg-4 audio (m4a)
- WAV (wav)
- FLAC (flac)
- Ogg (oga)
- OPUS (opus)
Clip Menu

The Clip menu has options for the currently playing Clip, but you can also right-click on any Clip thumbnail to pop up a contextual menu and edit its settings.
â<
Deletes selected Clips. You may also use the Cmd-Delete keyboard shortcut.
Makes a copy of the selected Clips. Note that this references the same media file as the original, optimizing space on your hard drive.
If your video Clip has an audio track, you can mute it or set its relative volume. This is useful to balance the audio levels across multiple Clips with audio.
When you stop playing Clip, you can choose to have it resume from the beginning or from the point where you stopped it.
By default, retriggering a currently-playing Clip starts it playing from the beginning again (Restart). Clips can be set to any of the following behaviors:
- (Default) - Restart from beginning
- - Jump back a moment
- - Shuttle back and forth like a record scratch
- - Reverse current direction of the Clip
- - Toggle between pause and resume from current point
- - Pause, then start from beginning
- - Stop the Clip and the current Song
- - Ensure that the Clip will continue playing if retriggered accidentally.
These are discussed in more detail in the section âSetting Up Your Projectâ earlier in this guide.
By default, each clip will loop for continuous play. However, any clip can be set to one of the following options:
- (default)
- - Reverse direction
- - Play to end and stop
- - Play to end and freeze on last frame
- - Play through and automatically start the next clip in current or next song
- - Play through and cue the next song
See the âSetting Up Your Projectâ section for more information about clip end behaviors.
A small icon indicating what happens when the song ends is shown in the bottom-right corner of the Clip thumbnail.
These options fade the Clip in or out over a specified number of seconds. The Fade In value also determines the cross-fade between Clips. It takes precedence over any Fade Out value of the previously-playing Clip. For video Clips with an audio track, the audio will fade in/out with the Clip. If the Project has a Background Clip, fade in/out will cross-fade from/to the Background Clip.
NOTE: Clips with a Fade Out value will continue to play after stopping Visibox.
Rotates selected Clips 90 degrees clockwise, 90 degrees counter-clockwise, or 180 degrees (upside down).
Flips selected Clips horizontally or vertically.
Add video filters to selected Clips.
Here you can override the default Letterbox settings that were set at the Project level (Project > Letterbox) for an individual Clip. Default uses the Project setting (Project > Letterbox). Crop always crops the video so it fills the Output window edge to edge. Choose Letterbox (black bars) if you have a video clip that has important content that should not be cropped, such as text.
Allows you to adjust the playback speed of selected video Clips at increments ranging from 3x to .1x without needing to edit the videos themselves.
Set the Clip to play
(as normal) or . Clips are muted when playing backwards.
ââ
Itâs usually easiest to just drag clips into position. However, you can also move the current clip using the Move Clip Left (ââ) and Move Clip Right (ââ) menu items and command keys.
Play Menu

The Play menu provides menu-based alternatives to Clip and Song playing functions you will most likely handle with the keyboard or MIDI triggering device.
Clips can be triggered using the 1â5 keys on the keyboard, or by MIDI. The 1 key triggers the first clip, 2 triggers the second and so on. Note that the 6â9 keys trigger their respective Clips as well. These Play menu items provide an alternative option to keys if necessary.
[Space]
(â§Space)
If no clip is playing, the space bar starts the first Clip of the current Song. If a Clip is playing, the space bar stops it. This makes the space bar a quick way of saying âstopâ without jumping to another Song. â§Space pauses and restarts the current Clip.
â
â
â§â
â§â
This set of menu items navigates between Songs, but it may be easier to use the arrow buttons on your keyboard. Previous Song (â) and Next Song (â) cue the adjacent Song and stop any currently playing Clip. If you you want to cue the next Song without stopping the current clip, hold down the shift key.
You can also click on a Song to select it. Shift-clicking will select it without stopping any currently playing clip.
When this option is selected, navigating to the âNext Songâ from last Song will circle around to activate the first Song. Likewise, selecting âPrevious Songâ with the first Song active will activate the last Song.
â
â
â§â
â§â
This set of menu items are related to switching Clips. The number keys and MIDI give you random access to the Clips in the current song, but you can also go to the Previous Clip (â) or Next Clip (â) within the current Song using the arrow keys. Hold down the shift key for the same functionality without being constrained to the current Song.
When this option is selected, navigating to the âNext Clipâ from last Clip will circle around to activate the first Clip. Likewise, selecting âPrevious Clipâ with the first Clip active will activate the last Clip. This also works with When Clip Ends behaviors, so when âStart Next Clipâ is chosen as the end behavior for the last Clip in a Song, it will play the first Clip in the Song when finished.
Window Menu

With multiple displays connected to your computer, the Window menu gives you options for managing the Controller and Output windows, including which display shows the Output and which shows the Controller, and whether they are set to Full Screen.
â„âF
Esc
Select Full Screen (â„âF) to present your Output and Controller windows full screen on different displays. If you only have one display connected to your computer, only the Output window will become full screen.
Once in Full Screen mode, you can Escape Full Screen with this menu item or the esc (â) key.
â„âX
Choose Swap Presentation Displays (â„âX) to swap which display is showing the output and which is showing the controller. If you have more than two displays, you can use the Present Output On and Present Controller On submenus to choose which you want where. Confused about which display is which? Select Show Display IDs to flash the display numbers onto each of the attached screens.
âK) (
In a typical performance situation, you may have only minutes to set up, focus, and calibrate a video projector. The Calibrate and Focus (âK) menu item projects an image with fine lines for easy focusing, bright colors for color calibration, and grayscale values to calibrate contrast. Various aspect ratios are indicated to help you determine your current aspect ratio.
âW
Close the selected window with the âW shortcut or this menu item.
â1
â2
Lose track of a window? These menu options make sure you see them.
Help Menu

You are currently reading the manual! Good work.
There is an example project available to play around with if youâd like to kick the Visibox tires before assembling your own media.
The Visibox FAQ has answers to common questions.
A link to the Spaceage contact form if you need some assistance.
Join the Visibox Discord server to chat with other users and the Spaceage team.
We've got a bunch of free video loops and content packs to get you started.
These articles have tips and tricks for using Visibox.
Check out the Spaceage YouTube channel for tutorials, videos, and more.
Need some content for your project? Check out this list of content providers.
This copies a bunch of information about your Visibox setup to the clipboard. This is useful if you need to send your setup to Spaceage support.
Giving credit where credit is due! This is a list of the 3rd party Open Source libraries distributed in Visibox.