Setup and conventions
Configure OSC input in Configuration > OSC. Add a receive endpoint, select the network interface, set its port, then send commands to that IP address and port.
- Addresses are lowercase and start with
/nodecue.
- Values are sent as OSC arguments.
- A first trigger argument of
false, 0, 0.0, or nil is ignored.
- Fade commands accept an optional duration in milliseconds as their first argument.
- Pad and bus targets can be included in the address or sent as the first argument.
Cuelist
| Action | Recommended address | Accepted aliases | Arguments |
|---|
| Play armed cue | /nodecue/cuelist/go | /nodecue/cue/go, /nodecue/cues/go, play variants | Optional trigger |
| Stop cuelist playback | /nodecue/cuelist/stop | /nodecue/cue/stop, /nodecue/cues/stop_all | Optional trigger |
| Pause / resume | /nodecue/cuelist/pause | /nodecue/cue/pause, resume and pause_resume variants | Optional trigger |
| Previous cue | /nodecue/cuelist/back | /nodecue/cuelist/previous, cue and cues variants | Optional trigger |
| Next cue | /nodecue/cuelist/next | /nodecue/cue/next, /nodecue/cues/next | Optional trigger |
| Fade out cuelist | /nodecue/cuelist/fade_out | /nodecue/cue/fade_out, /nodecue/cuelist/fade/out | Optional duration, trigger |
Pads
| Action | Recommended address | Accepted aliases | Arguments |
|---|
| Play pad by address | /nodecue/pads/play/{pad_id} | /nodecue/pad/play/{pad_id} | Optional trigger |
| Play pad by argument | /nodecue/pads/play | /nodecue/pad/play | pad_id, optional trigger |
| Stop pads playback | /nodecue/pads/stop | /nodecue/pad/stop, stop_all variants | Optional trigger |
| Pause / resume | /nodecue/pads/pause | /nodecue/pad/pause, resume and pause_resume variants | Optional trigger |
| Fade out pads | /nodecue/pads/fade_out | /nodecue/pad/fade_out, /nodecue/pads/fade/out | Optional duration, trigger |
Playlist
| Action | Recommended address | Accepted aliases | Arguments |
|---|
| Play selected track | /nodecue/playlist/go | /nodecue/playlist/play | Optional trigger |
| Pause / resume | /nodecue/playlist/pause | resume and pause_resume variants | Optional trigger |
| Stop playback | /nodecue/playlist/stop | - | Optional trigger |
| Previous track | /nodecue/playlist/back | /nodecue/playlist/previous | Optional trigger |
| Next track | /nodecue/playlist/next | - | Optional trigger |
| Fade out playlist | /nodecue/playlist/fade_out | /nodecue/playlist/fade/out | Optional duration, trigger |
Global transport
| Action | Recommended address | Accepted aliases | Arguments |
|---|
| Stop all playback / panic | /nodecue/panic | /nodecue/stop_all | Optional trigger |
| Fade out all playback | /nodecue/global/fade_out | /nodecue/fade_out | Optional duration, trigger |
Bus control
Bus IDs are zero-based: 0 Cuelist, 1 Pads, and 2 Playlist.
| Action | Recommended address | Accepted aliases | Arguments |
|---|
| Toggle mute by address | /nodecue/bus/mute/{bus_id} | /nodecue/bus/{bus_id}/mute and toggle variants | Optional trigger |
| Toggle mute by argument | /nodecue/bus/mute | /nodecue/bus/mute/toggle | bus_id, optional trigger |
Examples
Play the armed Cuelist cue
/nodecue/cuelist/go
Play Pad 7
/nodecue/pads/play/7
Fade out all playback over 3 seconds
Address: /nodecue/global/fade_out
Argument: 3000
Toggle mute on the Pads bus
/nodecue/bus/mute/1
