Skip to content
  1. Audio
  2. Other

OSC In

OSC In listens on a UDP port and maps the OSC addresses you name to outputs. A fader message becomes a control lane. A cue button becomes a GO or a seek that an arrangement or transport can act on. Anything that speaks OSC can drive Voro this way: a grandMA, a stage-manager tablet, a TouchDesigner patch, a phone app.

Set Port to the port your sender targets, then describe the routing in Doc, one rule per line. Wire out to whatever should follow the incoming values: slot 0 is its channel 0, slot 1 its channel 1, and so on. Wire obs into Arrangement Source’s trigger input to release a held section, or into Transport In’s obs input to follow the messages as a clock.

Doc rules:

# fader 1 straight through, fader 2 rescaled to 0..1
control 0 /fader/1
control 1 /fader/2 0.5 0.5
# an XY pad sends x and y in one message
control 2 /pad/xy 1 0 arg 0
control 3 /pad/xy 1 0 arg 1
# GO button, and a seek to the beat in the first argument
go /cue/go
seek /cue/seek
# same as go, but tagged with source id 30
trigger /cue/next 30
  • Inputs: none. OSC In is a source.
  • Output out: one control lane per slot, slot i on channel i. It is as wide as the highest slot the Doc maps, plus one, up to 64.
  • Outputs out0 to out7: slots 0 to 7, one lane each, kept for graphs made before out.
  • Output obs: GO and seek events from the go, seek, and trigger rules.
  • Enable: master on/off. While off, control lanes keep their last value and events are discarded.
  • Port: UDP port to listen on, default 47312. Any number of OSC In nodes can listen on the same port, and each hears every message.
  • Doc: the routing rules, one per line. # starts a comment. Changes apply live.
  • control <slot> <address> [scale] [offset] [arg <n>] sends an argument of matching messages to slot slot (0 to 63) as value * scale + offset. Scale defaults to 1, offset to 0, and arg to 0, the first argument. Integer, float, and true/false arguments all work.
  • Several addresses can feed one slot, and one address can feed several slots, as the XY pad above does.
  • go <address> [source] and trigger <address> [source] emit a GO. If the message carries an argument and it is zero, it is ignored, so a button that sends 1 on press and 0 on release fires once.
  • seek <address> [source] emits a seek to the beat in the message’s first argument.
  • The optional source is a number that tags the event. It defaults to 21.
  • Addresses match exactly. There is no wildcard matching.
  • Up to 256 control rules and 64 event rules, addresses under 256 characters. Bundles are read one level deep. A rule the node cannot take, such as a slot past 63, is counted as refused in its status rather than dropped silently.
  • A lane shows the last value until a new one arrives. It does not reset to zero.

Inputs

None

Outputs

  • out0..7 row
    control_f32_v1 8 slots
  • obs row
    transport_obs_v1
  • out row
    control_f32_v1
Enable (Enable) Toggle op('osc_in').par.Enable
Default:
On
Options:
Off, On
Port (Port) Int op('osc_in').par.Port
Default:
47312
Range:
1 to 65535
Doc (Doc) Str op('osc_in').par.Doc
Default:
"" (Empty String)