OSC commands

Setup

OSC input is configured in Preferences > Control > OSC. Add a receive endpoint, choose the network interface to listen on, set the port, then send OSC messages to that IP address and port.

For more details on OSC integration in Node:Cue, see the user guide: English or Français.

Active view

These commands control only the active view, like its playback controls.

Cuelist

Pads

Playlist

Auxiliary In

These commands target AUX directly, regardless of the selected Playlist track. AUX Stop/Fade Out close only AUX; they do not stop a Playlist track.

GO uses the Playlist GO preference and the normal AUX/Playlist handoff transition. Repeated GO does not restart an already open AUX. Input enable/device settings must be configured first; GO never enables or reroutes an unavailable input.

Fade Out accepts 0 to 60000 ms. Omitting its duration uses the existing AUX command fade duration (1000 ms by default), capped at 60000 ms.

Level uses the knob's 0-100% scale, not decibels: 0.5 means 50%. Setting the level to zero keeps an open AUX open; raising it restores its sound. Use Stop to close AUX. Values outside the stated ranges are rejected. The external application's own playback remains unchanged.

Commands respect the same Backup read-only guard and Sync replication as local AUX controls. Playlist Stop and Playlist Fade Out also close AUX. Dedicated AUX commands target only AUX. Fade In, Mute and Unmute are not separate external commands; use GO and Stop.

Global

Global Stop All and Global Fade Out affect all playback in the project, including lists that are no longer opened. Player-specific commands affect only that player's opened list. Bus controls act on the shared output bus.

Bus

OSC bus IDs:

• 1: Cuelist bus
• 2: Pads bus
• 3: Playlist bus
• 4: Monitor bus

Bus level uses the fader's normalized 0-1 scale, not decibels. These are shared output buses; their level and mute affect every playback routed to them.

Timecode

Arm and Disarm control cue triggering from the received Timecode. Disarm does not stop playback that has already started.

List targeting

Each player can have only one list open at a time. Cuelist, Pads and Playlist commands target that player's opened list, regardless of which view is displayed. Cue, pad and track IDs are resolved within that list.

To open another list, use /nodecue/cuelist/open/{listid}, /nodecue/pads/open/{listid} or /nodecue/playlist/open/{listid}. {listid} is its Project Browser ID, for example CL2, PS3 or PL2.

Opening a list does not launch playback or stop the previously opened list. An unknown ID or an ID belonging to another player is rejected. Global Stop All and Fade Out also cover playback in previously opened lists.

Disarm Timecode before opening another Cuelist. Opening a Cuelist does not arm Timecode.

Levels in dB

leveldb accepts a finite numeric level up to 0 dB. For silence, send the OSC string -inf. Positive dB values, non-finite numbers and other strings are rejected. The optional press/release trigger follows the level argument. Setting a level does not change mute or transport state.

Bus, Monitor and AUX faders use the same curve: amplitude gain equals the square of the normalized fader value. Use level for a normalized fader position or leveldb for a level in decibels.

Examples

Go on the selected Cuelist cue:

/nodecue/cuelist/go

Play cuelist cue ID 12.5:

/nodecue/cuelist/go/12.5

Play pad 7:

/nodecue/pads/go/7

Stop all playback:

/nodecue/stopall

Fade out all playback over 3 seconds:

Address: /nodecue/fadeoutall
Argument: 3000

Open Cuelist CL2, then launch its selected cue:

/nodecue/cuelist/open/CL2
/nodecue/cuelist/go

Go with Alt Go behavior using an argument:

Address: /nodecue/cuelist/go/12.5
Argument: alt

Set Monitor to -12 dB:

Address: /nodecue/bus/leveldb/4
Argument: -12

Set AUX to silence without closing it:

Address: /nodecue/aux/leveldb
Argument: -inf