SBL Cue Timer

← Guide

QLab and OSC (linking with lighting and sound)

Applies to: iPhone, iPad and Mac 1.3.7 (QLab link is β (Mac); on Mac it is available from 1.3.7)

When a cue starts (and at other moments), the app sends OSC messages to QLab, lighting consoles, or video software (Resolume, TouchDesigner, and so on) on the same network. This is a Pro feature.

1. Add a destination

In Settings, go to "OSC output" → Add destination.

FieldWhat to enter
Type"Other" (lighting consoles, video software, etc.) or "QLab"
NameA name you'll recognize
IP addressThe IP of the receiving device (e.g. 192.168.1.10)
Port8000 by default for Other. 53000 for QLab

After adding it, tap Test to check that it arrives. Each destination has a switch, so you can pause it for a while. Destination settings are per device (they don't sync).

Find QLab

When you set Type to "QLab", Find QLab (same network) appears (iPhone, iPad and Mac). Tap a Mac in the results to fill in the name, IP and port. If nothing shows up, enter the IP address by hand.

Passcode and workspace

If QLab's OSC Access has a passcode, enter it in Passcode (optional). The passcode is stored only on this device and is never included in sync or sharing.

Once you enter it, the app checks the connection automatically.

MessageWhat to do
Connected to QLabNo action needed
Wrong passcodeCheck the passcode in QLab's OSC Access
Allow control in QLab’s OSC AccessIn QLab, go to Workspace Settings → Network → OSC Access and allow control
Can’t reach QLabCheck the IP, the network, and that QLab is running
Open a workspace in QLabOpen a workspace in QLab

If two or more workspaces are open, buttons appear so you can choose which one to send to.

Image (coming soon)qlab-01 Adding a destination (Type QLab, list of Macs found)

2. Turn on sending for a show

In Show info (ⓘ), turn these on from top to bottom.

SwitchWhat it does
Send OSCSends OSC for this show
Send to QLabWhen a cue starts, GOes the QLab cue with the same number
Panic on STOPSends Panic to QLab when you press Stop

Change it per sheet

Turn off "Use show settings" in a sheet's settings to give just that sheet its own on/off settings.

When the mark shows on the run screen, the QLab link is active (when AUTO is off). With QLab 5.3 or later, the app also shows QLab's current playhead (on iPhone as "Q 3.1", on iPad and Mac under the top bar). This is read-only; it doesn't control QLab.

Image (coming soon)qlab-02 Q mark and QLab playhead on the run screen (iPad, landscape)

What gets sent (Other destinations)

Destinations with Type "Other" receive the following. The address prefix is /sbl by default (you can change it in "Address prefix").

AddressWhenContents
/sbl/cue/startWhen a cue startsNumber, title, duration (seconds)
/sbl/cue/endWhen a cue endsNumber, title
/sbl/show/endWhen the sheet ends—
/sbl/stateWhen the color changesnormal / warning / critical / overtime
/sbl/telopWhen you change the messageText, color
/sbl/remainEvery second (when "Send remaining time every second" is on)Seconds remaining, "MM:SS" (negative when over time)

OSC per cue

In the cue editor, under "OSC sent at start" → Add OSC, you can add messages that are sent when that cue starts. They go to every destination that is on.

Sending from a client

A client that has joined a share can also send to the destinations on its own device. This needs Pro and at least one destination on that device. The host's settings are not used.

  1. On the client's run screen, open "OSC settings" and turn on Send OSC, Send to QLab and Panic on STOP as needed (all off by default)
  2. Tap a cue → under "When NEXT is pressed", turn on Send to QLab / Send OSC (all off by default)
  3. Press NEXT at the bottom to send the next cue. Press STOP to send Panic (asks to confirm)

The client never sends on its own when the host's run changes. It only sends when you press NEXT on the client.

Pre-show checklist