Binaural /bus/{i}
The root OSC message for controlling a Binaural bus is /bus/{index}, where {index} is an integer starting from 1. To control any of the parameters listed below, you need to append the parameter name to the bus target address.
For example:
/bus/1/gain 0.5- Sets the gain of the bus 1 to 0.5
Binaural processing creates 3D audio for headphone playback using Head-Related Transfer Functions (HRTFs).
General Parameters
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /name | string | -- | -- | -- | ✅ |
| /color | [decimal, decimal, decimal, decimal] | 0, 1 | m | -- | ✅ |
| /lock | boolean | -- | -- | -- | ✅ |
| /trim | integer | -80, 30 | m | -- | ✅ |
| /gain | integer | -60, 12 | m | -- | ✅ |
| /gain/ramptime | decimal | -- | -- | -- | ✅ |
| /mute | string | 0, 2 | m | -- | ✅ |
| /solo | boolean | -- | -- | -- | ✅ |
| /format | string | "HOA", "HOA2D", "Binaural", "Transaural", "KNN", "Angular 2D", "LBAP", "Stereo AB", "Stereo XY", "Stereo Pan", "Thru", "VBAP", "VBAP2D", "VBIP", "VBIP2D", "WFS" | -- | -- | ❌ |
| /delay/bypass | boolean | -- | -- | -- | ✅ |
| /delay | integer | 0, 5000 | m | -- | ✅ |
| /monitor | boolean | -- | -- | -- | ✅ |
| /ramp/time | decimal | -- | -- | -- | ✅ |
| /headphoneeq/type | string | "AKG K1000 Closed", "AKG K1000 Open", "AKG K141MK2", "AKG K240DF", "AKG K240MK2", "AKG K271MK2", "AKG K271STUDIO", "AKG K601", "AKG K701", "AKG K702", "AudioTechnica ATH M50", "Beyerdynamic DT250", "Beyerdynamic DT770PRO 250Ohms", "Beyerdynamic DT880", "Beyerdynamic DT990PRO", "Presonus HD7", "Sennheiser HD430", "Sennheiser HD480", "Sennheiser HD560ovationII", "Sennheiser HD565ovation", "Sennheiser HD600", "Sennheiser HD650", "SHURE SRH940", "none" | -- | -- | ✅ |
| /itd/scaling | integer | 0, 200 | m | -- | ✅ |
| /hrtf | string | -- | -- | -- | ✅ |
| /listener/orientation | [decimal, decimal, decimal, decimal] | -1, 1 | m | -- | ✅ |
| /interpolation/time | decimal | -- | -- | -- | ✅ |
| /preOrPost | string | "post", "pre" | -- | -- | ✅ |
| /linkedToSpeaker | boolean | -- | -- | -- | ✅ |
Other Parameters
Equalizer
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /equalizer/bypass | boolean | -- | -- | -- | ✅ |
| /equalizer/gain | integer | -20, 20 | m | -- | ✅ |
| /equalizer/filter/{i}/active | boolean | -- | -- | -- | ✅ |
| /equalizer/filter/{i}/freq | integer | 30, 22000 | m | -- | ✅ |
| /equalizer/filter/{i}/order | integer | 2, 20 | m | -- | ✅ |
Dynamics
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /dynamics/attack | decimal | 0.01, 3000 | m | -- | ✅ |
| /dynamics/release | integer | 0, 7000 | m | -- | ✅ |
| /dynamics/lookahead | integer | 0, 50 | m | -- | ✅ |
| /dynamics/compressor/threshold | integer | -60, 20 | m | -- | ✅ |
| /dynamics/compressor/ratio | integer | 1, 100 | m | -- | ✅ |
| /dynamics/expander/threshold | integer | -60, 20 | m | -- | ✅ |
| /dynamics/expander/ratio | decimal | 0.01, 1 | m | -- | ✅ |
| /dynamics/makeup | integer | -40, 40 | m | -- | ✅ |
| /dynamics/link | string | "multi mono", "link all", "link to 1st" | -- | -- | ✅ |
| /dynamics/bypass | boolean | -- | -- | -- | ✅ |
| /dynamics/reduction | decimal | -- | -- | -- | ✅ |
| /dynamics/grid/visible | boolean | -- | -- | -- | ✅ |
| /dynamics/grid/color | [decimal, decimal, decimal, decimal] | 0, 1 | m | -- | ✅ |
| /dynamics/curve/fill | boolean | -- | -- | -- | ✅ |
| /dynamics/curve/color | [decimal, decimal, decimal, decimal] | 0, 1 | m | -- | ✅ |
| /dynamics/curve/thickness | decimal | -- | -- | -- | ✅ |
| /dynamics/background/color | [decimal, decimal, decimal, decimal] | 0, 1 | m | -- | ✅ |
| /dynamics/foreground/color | [decimal, decimal, decimal, decimal] | 0, 1 | m | -- | ✅ |
| /dynamics/title | string | -- | -- | -- | ✅ |
Levels
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /levels/preOrPost | string | "post", "pre" | -- | -- | ✅ |
| /levels/input | array | -120, 12 | -- | -- | ❌ |
| /levels/input/mode | string | "rms", "peak" | -- | -- | ✅ |
| /levels/output | array | -120, 12 | -- | -- | ❌ |
| /levels/output/mode | string | "rms", "peak" | -- | -- | ✅ |
Speaker
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /speaker/number | decimal | -- | -- | -- | ✅ |
Speakers
| Parameter | Arguments | Scale | Unit | Comments | Settable |
|---|---|---|---|---|---|
| /speakers/correction/delay | string | "off", "auto", "manual" | -- | -- | ✅ |
| /speakers/correction/gain | string | "off", "auto", "manual" | -- | -- | ✅ |