ADM-OSC
ADM-OSC is an open, vendor-neutral protocol for exchanging spatial audio object metadata over OSC. It is supported by a wide ecosystem of spatial audio tools and allows HOLOPHONIX to receive positioning and audio data from any compatible application.
Configuration
ADM-OSC messages are received on the same OSC input port as HOLOPHONIX's native OSC API. As long as OSC reception is enabled, ADM-OSC messages are automatically recognized alongside native OSC messages.
See the OSC settings for port configuration and the Input Mode setting, which lets you restrict HOLOPHONIX to ADM-OSC messages only, ignoring all native OSC input.
Enable Show ADM Helper in the Venue settings to display each source's ADM channel number directly in the Venue view. This makes it easier to match ADM object indices to HOLOPHONIX sources when setting up automation.
Address Format
ADM-OSC addresses follow this structure:
/adm/obj/{n}/{parameter}
where {n} is the 1-based object index corresponding to the HOLOPHONIX source index.
Supported Messages
Object Positioning
| Address | Direction | Arguments | Description |
|---|---|---|---|
/adm/obj/{n}/azim | TX / RX | azim (float, degrees) | Azimuth angle |
/adm/obj/{n}/elev | TX / RX | elev (float, degrees) | Elevation angle |
/adm/obj/{n}/dist | TX / RX | dist (float, 0-1) | Distance, normalized |
/adm/obj/{n}/aed | TX / RX | azim elev dist (3 floats) | Azimuth, elevation, and distance in a single message |
/adm/obj/{n}/x | TX / RX | x (float, -1 to +1) | Cartesian X position, normalized |
/adm/obj/{n}/y | TX / RX | y (float, -1 to +1) | Cartesian Y position, normalized |
/adm/obj/{n}/z | TX / RX | z (float, -1 to +1) | Cartesian Z position, normalized |
/adm/obj/{n}/xy | RX | x y (2 floats, -1 to +1) | Cartesian X and Y in a single message |
/adm/obj/{n}/xyz | TX / RX | x y z (3 floats, -1 to +1) | Cartesian X, Y, and Z in a single message |
Object Properties
| Address | Direction | Arguments | Description |
|---|---|---|---|
/adm/obj/{n}/gain | TX / RX | gain (float, 0-1) | Object gain, linear |
/adm/obj/{n}/mute | TX / RX | mute (int, 0 or 1) | Mute state |
/adm/obj/{n}/w | RX | w (float, 0-1) | Object width / spread |
/adm/obj/{n}/name | TX / RX | name (string) | Object name |
Listener
| Address | Direction | Arguments | Description |
|---|---|---|---|
/adm/lis/ypr | RX | yaw pitch roll (3 floats, degrees) | Listener orientation |