How To

OSC Commands: Input

CueStudio 2 listens for OSC on UDP port 8000 by default. Change the port in Show Settings.

All addresses below are the full OSC path. Arguments are shown in parentheses where required.

#Transport

  • /cuestudio/go: fire GO (same as pressing the space bar)
  • /cuestudio/stop: stop the active cue
  • /cuestudio/pause: pause playback
  • /cuestudio/resume: resume after pause
  • /cuestudio/panic: full PANIC (stop all, blank video, DMX blackout)

#Selection & navigation

  • /cuestudio/select/next: move the armed cue down one row
  • /cuestudio/select/previous: move the armed cue up one row

#Discovery (Zeroconf / Bonjour)

While OSC input is enabled, CueStudio advertises itself on the network as an _osc._udp service named "CueStudio (<this Mac's name>)", so controllers that browse for OSC devices (TouchOSC, OSC/PILOT and similar) can find it without you typing an IP address. You can always connect manually instead: the Show Settings header shows this Mac's IP, and the OSC tab shows the input port.

If the service doesn't appear in a controller's browse list, check System Settings ▸ Privacy & Security ▸ Local Network and make sure CueStudio 2 is enabled. Discovery is a convenience only: OSC keeps working over the IP address either way.

If advertising fails, the OSC tab shows an amber note underneath the Listen Port explaining why, not a red error, because OSC itself is unaffected and the status light stays on "Listening". The usual cause is Local Network access being off for CueStudio 2; a brief failure right after a network change or a wake is retried automatically and clears itself.

The web remote advertises separately as _cuestudio._tcp, and session sync as _cuestudio-session._tcp.

#Cue control

  • /cuestudio/cue/<number>: go to and fire that cue, e.g. /cuestudio/cue/5
  • /cuestudio/load/<number>: arm (load) that cue without firing it
  • /cuestudio/hotkey/<key>: fire the cue whose hotkey matches, e.g. /cuestudio/hotkey/A

#Playback position

  • /cuestudio/goto/time (float: seconds): jump to a time position within the active cue

#Show state

  • /cuestudio/showmode (int: 0 or 1, optional): set Show Mode on or off; omit the argument to toggle
  • /cuestudio/master/volume (float: 0.0 – 1.0): set the grand master output volume as a linear gain
  • /cuestudio/master/db (float: dB): set the grand master in dB, the value the fader shows. Send -30 for -30 dB. Anything at or below -60 is silence. Use this rather than the linear address when you are driving CueStudio from a console and thinking in dB.

#Queries (replies sent to the OSC output address)

  • /cuestudio/query/armed: replies with the armed cue number and name
  • /cuestudio/query/playing: replies with the playing cue number, name, and progress (0.0–1.0)
  • /cuestudio/query/cuecount: replies with the total number of cues in the active list