TraxDeck

OSC Reference

OSC (Open Sound Control) support is available on Professional and Enterprise plans. It enables deep integration with show control systems like QLab, Resolume, ETC Eos, grandMA, and any other OSC-capable software or hardware.

Configuration

Open Preferences → OSC to configure:

| Setting | Default | Notes | |---|---|---| | Receive port | 8000 | UDP port Stem Director listens on | | Send host | 127.0.0.1 | IP address of the destination device | | Send port | 9000 | UDP port messages are sent to | | Protocol | UDP unicast | UDP broadcast also available |

Stem Director can send and receive on the same network interface simultaneously. For multi-device setups, use a gigabit switch and configure unicast addresses for each device.

Receiving OSC (control Stem Director)

Send these messages to Stem Director to control it remotely.

Transport

| Address | Type | Value | Description | |---|---|---|---| | /sd/transport/play | — | — | Start playback | | /sd/transport/stop | — | — | Stop and return to start | | /sd/transport/pause | — | — | Pause at current position | | /sd/transport/next | — | — | Advance to next track | | /sd/transport/prev | — | — | Go to previous track | | /sd/transport/load | i | Track index (1-based) | Load track by index | | /sd/transport/jump | s | Cue name | Jump to named cue point |

Stem control

| Address | Type | Value | Description | |---|---|---|---| | /sd/stem/{n}/mute | i | 0 = unmute, 1 = mute | Mute/unmute stem by index | | /sd/stem/{n}/solo | i | 0 = off, 1 = on | Solo stem by index | | /sd/stem/{n}/volume | f | 0.0 – 1.0 | Set stem volume (normalised float) | | /sd/stem/mute/all | i | 1 | Mute all stems | | /sd/stem/unmute/all | i | 1 | Unmute all stems | | /sd/master/volume | f | 0.0 – 1.0 | Set master volume |

Set list

| Address | Type | Value | Description | |---|---|---|---| | /sd/setlist/load | s | Set list name | Switch to a named set list | | /sd/setlist/next | — | — | Switch to next set list |

Sending OSC (feedback from Stem Director)

Stem Director sends these messages from itself to your configured send host/port.

| Address | Type | Value | Description | |---|---|---|---| | /sd/status/playing | i | 0 or 1 | Sent whenever playback state changes | | /sd/status/track | si | Name, index | Current track name and index | | /sd/status/position | ff | Bar, beat | Current playback position (updated ~10 Hz) | | /sd/status/remaining | f | Seconds | Time remaining in current track | | /sd/stem/{n}/mute | i | 0 or 1 | Sent when a stem is muted/unmuted | | /sd/stem/{n}/volume | f | 0.0 – 1.0 | Sent when a stem volume changes |

Feedback messages allow other systems to mirror Stem Director's state — useful for building custom confidence monitors or synchronising visuals.

QLab integration example

This example shows how to trigger Stem Director playback from a QLab cue and receive position feedback.

In QLab:

  1. Add a Network Cue
  2. Set Destination: the IP of the Stem Director machine, port 8000
  3. Set Type: OSC
  4. Set Message: /sd/transport/play
  5. Click Go to trigger

To advance to the next song from QLab:

Network Cue → /sd/transport/next

To load a specific track by name, use a script cue with a variable:

-- QLab Script Cue
tell application "QLab"
  set trackName to "03 - Big Finale"
  -- Send via OSC
end tell

In Stem Director, go to Preferences → OSC and enable Send feedback to QLab to push position data back for timecode display in QLab.

Resolume integration

Stem Director can trigger video playback in Resolume via OSC:

  1. In Resolume, note the OSC input port (default 7000)
  2. In Stem Director, add an OSC Send action on track load:
    • Address: /composition/video/opacity
    • Value: 1.0
  3. On track stop, send opacity 0.0

For clip-accurate triggering, use DMX/Art-Net from Stem Director to Resolume's OSC layer instead — it provides lower latency than OSC over UDP.

ETC Eos / grandMA integration

Lighting consoles that support OSC input can receive cue triggers from Stem Director. Configure a Cue Trigger action in Stem Director's cue list (see Lighting Control) with OSC output enabled for per-song lighting control without DMX hardware.