OSC Input
Receive Open Sound Control (OSC) messages over the network.
What it does
OSC Input listens for Open Sound Control messages arriving over the network at a specific address and outputs the latest value received. OSC is the protocol lighting consoles, DAWs, TouchOSC-style control surfaces and many other creative tools use to send live numeric data.
The incoming value is exposed as a Number, Vec2, Vec3 and Color at the same time, plus a Received output reporting whether a message has arrived yet.
When to use it
A parameter driven live from a lighting desk, DAW, or a phone or tablet control surface such as TouchOSC
A fallback value held before any message arrives, so the graph does not sit at zero on startup
The incoming value remapped into a specific working range
Signal loss detected, by checking Received before trusting the value
| Parameter | Type | Default |
|---|---|---|
address | String | "/input/1" |
default_value | Number | 0 |
range_min | Number | 0 |
range_max | Number | 1 |
Gotchas
The address must match the sender's OSC address pattern exactly, leading slash included, for example
/my/param. A mismatch means the node keeps outputting its default forever, with no error.Until the first message arrives, every output holds Default Value. Set it to something sensible rather than leaving it at 0 if a stalled feed should not read as off.
Min and Max define the range the incoming value is mapped into. They do not clip or validate the sender's data. If the OSC source sends outside the expected range, adjust Min and Max here rather than assuming the node guards against it.
Worked example
Add an OSC Input node.
Set Address to match the path your OSC sender is broadcasting on, e.g.
/fader/1.Set Default Value to what you want before the first message arrives.
Adjust Min and Max to the range you want the value mapped into.
Wire the Value (or Vec2/Vec3/Color) output into whatever parameter you want to drive live, and check Received if you need to detect signal loss.
See also
MIDI Input · MQTT Subscribe · OSC Output · Numbers, signals & audio