Qlab
QLab is a Voice Action that sends OSC commands directly to your QLab setup for live control from your voice automations. Configure a host, optional passcode, and optional workspace scope, choose a command, and the action builds and sends the exact QLab OSC path with the right arguments on iOS, macOS, or Mac Catalyst.
Required Parameters
host(required): OSC destination host (IP or hostname).port(required): OSC destination port, constrained to0โ65535.command(required): one command from the implemented QLab command catalog.passcode(optional): when set, sends a/connectOSC message before the selected command.workspaceID(optional): prefixes paths with/workspace/{workspaceID}; if omitted, the command targets all open workspaces listening on the OSC port.cueTarget(required for cue-based commands): defaults toselected; can also be set toselected,playhead,active, or a cue number.cueNumber(optional): used byworkspace.go.panicTime(required forworkspace.panicInTimeandcue.panicInTime): float seconds.armed(required forcue.setArmed): boolean input rendered as OSC integer (true/on/yesโ1,false/off/noโ0).
Commands
GO (workspace.go)
- Optional argument:
cueNumber(string). - Scope: workspace-level command (
/go), sent at root or under/workspace/{workspaceID}. - Optional usage note: if
cueNumberis blank, sends no argument.
Pause (workspace.pause)
- No additional arguments.
- Scope: workspace-level command (
/pause).
Resume (workspace.resume)
- No additional arguments.
- Scope: workspace-level command (
/resume).
Stop (workspace.stop)
- No additional arguments.
- Scope: workspace-level command (
/stop).
Panic (workspace.panic)
- No additional arguments.
- Scope: workspace-level command (
/panic).
Panic In Time (workspace.panicInTime)
- Required argument:
panicTime(float, seconds). - Scope: workspace-level command (
/panicInTime). - Optional note: default value is
3when no value is provided.
Reset (workspace.reset)
- No additional arguments.
- Scope: workspace-level command (
/reset).
Select Next (workspace.selectNext)
- No additional arguments.
- Scope: workspace-level selection command (
/select/next).
Select Previous (workspace.selectPrevious)
- No additional arguments.
- Scope: workspace-level selection command (
/select/previous).
Select Cue Number (workspace.selectCue)
- Required argument:
cueNumber(string path parameter). - Scope: workspace-level selection command (
/select/{cueNumber}).
Select Cue ID (workspace.selectCueID)
- Required argument:
cueID(string path parameter). - Scope: workspace-level selection command (
/select_id/{cueID}).
Cue GO (cue.go)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/go.
Cue Start (cue.start)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/start.
Cue Start And Autoload Next (cue.startAndAutoloadNext)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/startAndAutoloadNext.
Cue Stop (cue.stop)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/stop.
Cue Hard Stop (cue.hardStop)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/hardStop.
Cue Pause (cue.pause)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/pause.
Cue Toggle Pause (cue.togglePause)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/togglePause.
Cue Resume (cue.resume)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/resume.
Cue Panic (cue.panic)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/panic.
Cue Panic In Time (cue.panicInTime)
- Required arguments:
cueTarget(defaultselected) andpanicTime(float, seconds, required, default3). - Scope: cue-level command under
/cue/{cueTarget}/panicInTime.
Cue Reset (cue.reset)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/reset.
Cue Load (cue.load)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/load.
Cue Preview (cue.preview)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/preview.
Cue Audition Preview (cue.auditionPreview)
- Required argument:
cueTarget(string path parameter, defaultselected). - Scope: cue-level command under
/cue/{cueTarget}/auditionPreview.
Cue Set Armed (cue.setArmed)
- Required arguments:
cueTarget(string path parameter, defaultselected) andarmed(boolean, converted to integer in OSC payload:1or0). - Scope: cue-level command under
/cue/{cueTarget}/armed.