QLab Remote is an iOS app, available on the App Store, that can connect to QLab to remotely view, edit, and run cues. QLab Remote requires iOS 15 or later and is compatible with QLab 3.0 or later1. QLab Remote can run on any iPhone, iPad, or iPod touch that can run iOS 15.
QLab Remote adapts to different screen sizes and orientations as best as it can, and it supports Split View and multiple windows on iPad. Some features will only be available when screen space permits, which means some features are only available on iPad.
QLab Remote is a free app with two optional available in-app purchases.
Tapping the Purchases… button in the upper right corner of QLab Remote’s initial screen lets you view and make in-app purchases.
If you purchased an older version of QLab Remote, your Apple ID should automatically enable the Show Control & Editing purchase. If it does not, you can tap Restore Previous Purchases to correct the situation.
When QLab Remote is in Read-Only mode, you cannot use it to start or stop cues, move the playhead, or change any attributes of any cues except flags and notes.
Read-Only mode is intended to be used, for example, by a designer during a run-through or preview performance. In this situation, it can be desirable to edit notes and flag or unflag cues, but disallow any other editing.
Read-Only mode is also great for a remote cue list monitor for a stage manager or any other member of the team who needs to see what QLab is up to, but does not need to control QLab.
This in-app purchase unlocks QLab Remote’s abilities to send commands to QLab. You can run cues, move the playhead, edit parameters of cues (with some limitations), and adjust video stage geometry.
This in-app purchase unlocks QLab Remote’s Light Keypad remote, which gives remote access to the Light Dashboard and lets you quickly and easily enter light commands, change levels, and record and update cues.
It also unlocks the Light Instrument Check tool which lets you quickly run a channel check on your lighting system.
You do not need to purchase Show Control & Editing to use Light Tools.
We make every effort to keep QLab Remote compatible with all releases of QLab 3, QLab 4, and QLab 5. Some features of QLab Remote can only work when connecting to newer versions of QLab, however. For example, QLab Remote’s Light Keypad requires QLab 4.2 or newer. Anything relating to lighting requires at least QLab 4, since QLab 3 does not control lighting at all. Encrypted network communications require QLab 5. This manual is written with the assumption that you are using QLab 5.
Using the most recent version of QLab and the most recent version of QLab Remote guarantees access to the most complete set of features.
You can see a complete chart showing which features require which version of QLab at the bottom of this page.
To begin, the iOS device running QLab Remote and the Mac running QLab must be on the same local network, and must be able to “see” each other. If you have a firewall on the network, it must be configured to permit traffic on ports 53000 and 53001. If you are connecting to a workspace that uses a customized port for OSC traffic, that port also needs to be accessible.
Alternately, you can connect your iOS device to the Mac running QLab using a Lightning-to-USB cable.
Whether you’re connecting via a network or via USB tethering, your QLab workspace must also be set to use OSC controls, which can be set in Workspace Settings → Network → OSC Access. OSC controls are turned on by default in all QLab workspaces.
With your devices connected physically, and your workspace open on your Mac, launching QLab Remote will give you this screen:
QLab Remote will automatically “see” any workspaces open on your Mac via Bonjour, and you can simply tap to connect. If you have an unusual network setup, such as a network which blocks the Bonjour protocol, you can tap “Other” to directly enter the IP address of the Mac running QLab.
QLab 3 and QLab 4 workspaces which use a passcode will display with a padlock icon on the right, to indicate that you’ll be prompted for a passcode before connecting. All QLab 5 workspaces are displayed with a padlock because the QLab 5 access system allows for multiple passcodes, so QLab Remote can’t know what the passcode situation is for a given workspace until after it connects. Therefore, whenever you connect to a QLab 5 workspace, you’ll be presented with the passcode keypad.
If the workspace allows no-passcode connections, you can simply tap No passcode to connect.
The bottom of the main display shows the familiar button, standby indicator, notes field, and transport buttons (reset all, pause all, resume all, and panic all) from QLab.
Above this is the cue list, which works exactly like the cue list display in QLab. To move the playhead, swipe right on a cue:
To edit a cue, swipe left to reveal four edit buttons:
You can also double-tap on a cue to edit that cue.
To move a cue within the list, long-press on that cue and then drag it up or down the list.
QLab Remote is a great way to view and operate Cue Carts.
While in the cart view:
Above the cue list is a toolbar showing the name of the workspace, the name of the currently displayed cue list, and the name of the Mac that QLab Remote is connected to. Surrounding this label are five tools.
Tapping on the Workspace Actions menu ( ) reveals ten actions:
About QLab Remote. Tap this item to reveal a submenu with three items: Preferences, View Help, and Contact Support.
Tapping on the Light Tools menu () reveals two actions:
The Load To Time () tool works just like the Load To Time tool in QLab.
The Resize Controls () button allows you to resize the footer, the GO button, and the transport controls.
Tap the button to reveal the resize controls, then tap and drag them to arrange them as you prefer. You can enlarge, shrink, or entirely hide the button and transport controls, hide the entire footer, and so forth. Tap the button again to finish.
The Cue Lists () menu allows you to switch between the lists and carts in your workspace.
The last item in the Cue Lists menu is Active Cues, which is similar to the Active Cues display in QLab’s sidebar.
QLab Remote can edit some attributes of all cues:
You can also make some adjustments to Audio cues, Video cues, and Light cues:
If you have a video license installed in QLab, you can use QLab Remote to edit the geometry of stages in your workspace.
You will need to set up the stage on the Mac, but once it’s basically set up you can use QLab Remote to make precise adjustments.
The Light Keypad is a tool for interacting with the Light Dashboard in QLab. It’s designed to let you adjust lights quickly and easily, and then save those adjustments by creating new cues, or recording or updating existing cues.
You can tap on the command line and enter text using the regular iOS keyboard (or a physical keyboard connected to your iOS device.) This command line behaves exactly like the the command line in the Light Dashboard. Any text you enter here will be sent to the Dashboard when you press enter.
Typically, any commands you type into the command line will execute immediately when you hit enter. If you type a time into this field, however, the command will fade over that amount of time. This concept, called sneak on some other lighting consoles, allows you to make changes to the live state of your lights in a gentle, subtle way.
This tabbed area allows you to swiftly select an instrument or light group, then select the parameter you wish to edit. When the Light Keypad first opens, you’ll be presented with the Instruments tab:
You can tap on an instrument or light group to select it, and place its name in the command line.
If your instruments or light groups are numbered, you can also use the number keys from the beginning to enter the number of your instrument or light group. Once you enter a valid instrument or light group number, QLab Remote will display the Parameters tab. If you then enter a dash or comma, QLab Remote realizes that you’re trying to enter a range and returns to the Instruments tab.
Once you enter a name, QLab Remote will display the Parameters tab:
You can then tap on the parameter that you want to adjust, and then use the number keys to make the adjustment.
Once an equals sign is entered, the ”=”, ”-”, and ”,” buttons on the keypad become “cue”, “pass”, and “home” buttons which you can tap to add those keywords to the command line.
When your command is complete, the Enter button will become enabled, and you can tap on it to transmit the command to QLab. You will see the adjustment reflected in the Dashboard right away. If your QLab system is connected to your lights, you will of course also see your adjustment reflected in real life.
You can also always tap in the command line to use the onscreen keyboard or an attached physical keyboard to type commands from scratch or edit commands before committing them.
The Instruments tab always shows light groups on the left, with the group “all” listed first. Individual instruments are shown on the right, alphabetically sorted.
The Parameters tab dynamically adjusts to show the most relevant set of information. If the command line is empty, QLab Remote shows all parameters of all instruments, listed in four columns: intensity, color, beam, and custom. Each column is scrollable as needed, and on narrow layouts you can swipe left and right to move between them.
If the command line contains the name of an instrument or light group, only the parameters belonging to that instrument or light group are enabled.
The layout of all parameters, however, remains constant no matter what instruments are selected, active, or patched. The purpose of this is to help you develop a sense of “muscle memory” to aid you in locating the buttons for each parameter. Some buttons may be visible or not, some may be enabled or not, but each button will always be in the same spot (taking into account scrolling, device rotation, and device screen size, of course.)
QLab Remote provides the same buttons for recording and updating cues as the Light Dashboard does in QLab.
Each button is only enabled when the corresponding action is available.
These buttons also perform the same function as their QLab counterparts.
The Light Instrument Check tool lets you flip through each lighting instrument and light group in your show in order to ensure that everything is working properly.
When you begin an instrument check, all lights are reset to their home positions. When each instrument is checked, its default parameter is brought to either 100%, 50%, or 10%. You can choose this level using the Setting adjustment on the right side of the screen.
QLab Remote supports keyboard shortcuts when a hardware keyboard is connected. Pressing and holding the command key displays a list of all supported shortcuts.
The following features in QLab Remote are available when connected to a specific minimum version of QLab.
While QLab 3 is still compatible with QLab Remote, it is unsupported as of the release of QLab 5 and may not work perfectly, or not in all configurations.↩
Still have a question?
Our support team is always happy to help.