OSC API

PRO Connect exposes an OSC interface over UDP for monitoring and controlling PRO audio hardware. This page is a reference for developers and integrators building OSC clients (lighting consoles, automation systems, custom controllers, test harnesses).

TouchOSC starter template

A TouchOSC layout template is available as a starting point. It pre-wires common PRO Mixer controls (master volume, name, and channel volumes) to the addresses documented below. Open it in TouchOSC and customize from there.

note

You must change the Mixer's ID in the template before you can control your Mixer.

Download TouchOSC Template (.tosc)

How OSC works in PRO Connect

• Single outbound UDP port. PRO Connect sends every outbound OSC packet — Get responses and Notify pushes — to one configured destination. Configure the destination address and port in PRO Connect's Settings → OSC panel. Multiple clients are not directly supported on the response path.
• mDNS discovery. PRO Connect advertises its OSC server on the local network as _osc._udp.local..
• Dual-form responses for enum-like addresses. A few addresses (like /pro/mixer/<id>/mix/mode) emit a single combined message in their Get response and Notify push: type tag string int (string first, int second). Example: /pro/mixer/c16f/mix/mode string int banked 1. Set commands accept either form individually.
• Main vs Banked mode. OSC commands targeting a Mixer's mix only apply to the Mixer's current mode (main or banked). An OSC main-mode write has no effect when the Mixer is in banked mode (and vice versa).

Conventions

• <id> is the device identifier (typically the lower 16 bits of the device's hardware ID, lowercase hex).
• <ch> is the channel index (range varies by address — noted per section).
• Parameter type tags: string, int (int32), float (float32). A combined tag like string int indicates two consecutive values in a single message.
• Wire format: <address> <type-tag> <value(s)>. Example: /pro/mixer/c16f/mix/master/volume float 0.75.
• Verbs:
  • Get — client sends the address with no parameters; PRO Connect replies at the same address with the current value.
  • Set — client sends the address with parameters to update state; PRO Connect sends no direct response.
  • Notify — PRO Connect emits the message unsolicited when state changes, using the same format as Get.
• A — in the Get or Set column means the verb is not supported for that address.

API

PRO Mixer

Address	Get	Set	Description
/pro/mixer/<id>/name	string	string (max 13 chars)	Display name
/pro/mixer/<id>/version	string	—	Firmware version
/pro/mixer/<id>/mix/mode	string int	int 0–1 or string main|banked	Active mix mode
/pro/mixer/<id>/mix/master/volume	float 0.0–1.0	float 0.0–1.0	Master mix volume
/pro/mixer/<id>/mix/aux/volume	float 0.0–1.0	float 0.0–1.0	Aux input level
/pro/mixer/<id>/mix/intercom/volume	float 0.0–1.0	float 0.0–1.0	Intercom internal level

PRO Mixer — Main Mode Only

<ch> is the main-mode channel index, 1–16.

Address	Get	Set	Description
/pro/mixer/<id>/mix/main/<ch>/name	string (max 9 chars)	—	Channel display name
/pro/mixer/<id>/mix/main/<ch>/volume	float 0.0–1.0	float 0.0–1.0	Channel volume
/pro/mixer/<id>/mix/main/<ch>/pan	float 0.0–1.0	float 0.0–1.0	Pan: 0.0 full left, 0.5 center, 1.0 full right
/pro/mixer/<id>/mix/main/<ch>/width	float 0.0–1.0	float 0.0–1.0	Stereo width: 0.0 swap L/R, 0.5 mono, 1.0 full stereo

PRO Mixer — Banked Mode Only

<ch> is the banked-mode channel index, 1–128.

Address	Get	Set	Description
/pro/mixer/<id>/mix/banked/<ch>/name	string (max 9 chars)	—	Channel display name
/pro/mixer/<id>/mix/banked/<ch>/volume	float 0.0–1.0	float 0.0–1.0	Channel volume
/pro/mixer/<id>/mix/banked/<ch>/pan	float 0.0–1.0	float 0.0–1.0	Pan: 0.0 full left, 0.5 center, 1.0 full right
/pro/mixer/<id>/mix/banked/<ch>/width	float 0.0–1.0	float 0.0–1.0	Stereo width: 0.0 swap L/R, 0.5 mono, 1.0 full stereo

Global Channels

These addresses target channels at the PRO system level rather than any specific mixer. <ch> is the global channel index, 1–128.

Address	Get	Set	Description
/pro/global/<ch>/name	string (max 9 chars)	string (max 9 chars)	Channel display name
/pro/global/<ch>/link	string int	int 0–1 or string mono|stereo	Stereo link state (links to adjacent ch.)