You can set application-wide preferences for QLab by choosing QLab Preferences… from the QLab menu. This menu is really called the Application menu and its name changes based on which program you’re using. Some items in this menu are the same for all programs, such as Show, Hide, and Quit, but some are specific to each program.
QLab Preferences apply to all workspaces on your Mac, and they do not transfer with workspaces which are copied or moved to other Macs.
QLab preferences are divided into the General tab and the Hardware tab.
This is the name by which this Mac will be identified when it connects as a Remote to a Collaboration Primary. By default, this is the user name of the active account on your Mac, but you can change it to any text you like.
You can choose one of five behaviors for QLab to perform when it’s launched:
When this box is checked, QLab will attempt to connect to the internet and check for available updates. If an update is available, QLab will ask you if you’d like to download and install it. Updates are never automatically downloaded. If no internet connection is available, QLab simply tries again on the next launch. No error message appears, and no further attempt to check will be made until QLab is relaunched. We recommend leaving this box checked except on a show Mac during the time between dress rehearsal and closing, during which time we recommend leaving it unchecked.
At present, this checkbox does absolutely nothing. Over time, we plan to add various measures of QLab’s behavior which will help us track and solve problems. As we add these measures, we will list exactly what data is sent right here. We will never include personally identifiable data, media files, or other information proprietary to your designs.
When this box is checked, entering Show Mode disables the following OS-level features which could potentially cause trouble during a performance:
Autosave is enabled on a per-workspace basis, but the interval between autosaves is globally set here. You can set the interval from 5 seconds to 600 seconds (ten minutes.)
When this box is checked, QLab will create a CSV-formatted log of all audio and video file playback in a workspace, using information from the cue in QLab as well as metadata in the target media files. This is primarily intended to make it easy to create reports for rights-holding organizations, like ASCAP or BMI, but could be useful for any sort of logging.
QLab records messages to the Mac’s system log at four possible levels:
All audio devices available to QLab are listed here, showing their sample rate and channel counts for both input and output.
Each device has a pop-up menu which allows you to set the buffer size to each audio device. QLab defaults to a buffer size of 512 samples. You can manually adjust buffer sizes here. Smaller buffers reduce latency but may cause choppy playback, particularly with audio effects such as reverb and echo. Larger buffers increase latency but can smooth out choppiness, particularly on less powerful computers.
You can choose a specific network interface through which QLab will send Art-Net messages, or you can leave the default Automatic setting to have QLab negotiate the correct interface on its own.
Automatic is the best choice most of the time. The main reason you might need to change this is if you are using QLab in a complex networking situation, in which two or more network interfaces are connected to different networks, but the networks use the same IP addressing scheme. If none of this makes sense to you, leave it on Automatic and everything will be fine.
If you are not using Art-Net for lighting, leave this set to Automatic and forget about it.
Check this box to use Art-Net’s broadcast mode which allows QLab to communicate with Art-Net nodes that do not support polling.
Also check this box to allow QLab to properly communicate with other software which also uses Art-Net running on the same computer.
Un-checking this box will reduce the amount of network traffic generated by QLab while using Light cues. We recommend leaving this box unchecked if possible.
Still have a question?
Our support team is always happy to help.