Sonoros accepts OSC commands over UDP, which lets you trigger chat actions from a show control system, a tablet, or any OSC-capable device on the same network.

Enabling OSC

Go to Setup > Show Settings. Use the toggle next to OSC Port to enable OSC, and set the port number you want Sonoros to listen on. The default is 5429. If you change it and want to go back, click Restore Default Port.

Clients can enable OSC independently with their own port.

[Screenshot: OSC Port toggle and field in Setup > Show Settings]

Once enabled, Sonoros starts listening for UDP packets on that port. To see the command reference inside the app, click OSC Command Info.

Command reference

All commands are sent as OSC messages over UDP to the port you configured. Every command starts with /sonoros/.

Send a custom chat message

/sonoros/chat/custom s "Message" s "Sender Name"

Sends a message to the chat window. The sender name is optional — if omitted, the message will appear as coming from "OSC".

Send a chat macro

/sonoros/chat/macro i [bank] i [macro] s "Sender Name"

Sends one of your configured chat macros. Replace [bank] with the bank number (1–4) and [macro] with the macro number (1–6). The sender name is optional.

Send a chat flash

/sonoros/chat/flash

Triggers a chat flash on all connected clients, the same as pressing the Flash button manually.