OnAirScreen API / UDP / HTTP / MQTT / OSC

OnAirScreen accepts the same command strings over UDP (default port 3310), HTTP (default port 8010), MQTT, OSC, SNMP, and the Web UI. Raspberry Pi GPIO and Axia Livewire GPIO map mixer contacts to the same LED/AIR commands locally; they are not a network API.

Complete manuals: User Manual §7 · Bedienungsanleitung §7 · SNMP MIB · Hotkeys

Set LED1 text and switch it on:

echo "CONF:LED1:text=FOO" > /dev/udp/127.0.0.1/3310
echo "CONF:CONF:APPLY=TRUE" > /dev/udp/127.0.0.1/3310
echo "LED1:ON" > /dev/udp/127.0.0.1/3310

On Windows, shop builds include oas_send.exe (UDP client):

oas_send.exe --ip 192.168.23.5 "LED1:ON"

oas_send-noconsole.exe does the same without opening a console window (use it from playout scripts):

oas_send-noconsole.exe --ip 192.168.23.5 "LED1:ON"

Strings must be URL-encoded:

curl "http://127.0.0.1:8010/?cmd=LED1:ON"
curl "http://127.0.0.1:8010/?cmd=NOW:You%20are%20listening%20to%20Queen%20-%20Show%20must%20go%20on"

Status (JSON: LEDs, AIR timers, NOW/NEXT/WARN, silence, loudness I+LRA, instance, version):

curl http://127.0.0.1:8010/api/status

For AIR3, topOfHour is the Top-of-Hour countdown and countDown is true while the radio timer is counting down. silence is independent of the on-screen WARN. lufsI and lra are null until enough audio has been measured.

Command:

curl "http://127.0.0.1:8010/api/command?cmd=LED1:ON"

Web settings (optional PIN via X-Settings-Token after POST /api/settings/auth): see the manuals. HTTP CMD:REBOOT / CMD:SHUTDOWN require that PIN when one is set. UDP, MQTT, OSC, GPIO, and SNMP stay unauthenticated.

Open http://127.0.0.1:8010/ (or the instance IP) in a browser.

• Live status for LEDs, AIR timers, NOW/NEXT/WARN, silence, and loudness I+LRA
• WebSocket updates (HTTP polling fallback; WebSocket port is HTTP + 1, default 8011)
• Dark mode, warning priorities, LED/AIR/I+LRA controls, Top-of-Hour, AIR3 time input
• Keys 1–4 toggle LEDs (ignored while typing)
• Settings overlay (optional PIN), Livewire/AES67 pickers, presets
• Connection badge (Live / Polling / Offline)

Configure MQTT under Settings → Network (server, port, username, password, device name).

The base topic is onairscreen plus the last 6 hex characters of the MAC address, e.g. onairscreen_a1b2c3. Autodiscovery creates LED and AIR switches, AIR time sensors, AIR3/AIR4 reset, AIR3 Top-of-Hour, NOW/NEXT/WARN text, Warning/Silence binary sensors, instance sensor, and loudness I+LRA switch/reset/sensors. The Home Assistant device name becomes OnAirScreen (Studio-1) unless the instance name is already in the MQTT device name.

Command topics (payload as shown):

Status topics (published automatically):

mosquitto_pub -h mqtt-broker -t onairscreen_a1b2c3/led1/set -m "ON"
mosquitto_pub -h mqtt-broker -t onairscreen_a1b2c3/air3/toh -m "TOGGLE"
mosquitto_pub -h mqtt-broker -t onairscreen_a1b2c3/lufs/integrated/set -m "ON"
mosquitto_pub -h mqtt-broker -t onairscreen_a1b2c3/text/now/set -m "Current Song"

The astrastudio OnAirScreen module drives Stream Decks over HTTP (GET /api/command) and live status over WebSocket (HTTP port + 1) with poll fallback to /api/status. OSC is not required. See the manuals §7.6. Generic OSC remains a fallback.

Enable OSC under Settings → Network. Prefix is /oas. Integers 1/0 mean ON/OFF; no argument means TOGGLE. Text uses a string argument. Full address list: manuals §7.7.

python3 utils/oas_osc_send.py /oas/led1
python3 utils/oas_osc_send.py /oas/led1 1

Enable SNMP under Settings → Network. SNMPv2c and SNMPv3 (SHA-256, AES-128). Default listen port 1161. MIB, OIDs, and SET/trap notes: onairscreen:mib-en.

These strings work on UDP, HTTP ?cmd=, REST /api/command, MQTT (via the mapped topics or raw command), OSC /oas/command, and SNMP oasCommand.

Format: CONF:GROUP:PARAMETER=VALUE. Changes are applied and saved only after CONF:CONF:APPLY=TRUE.

CONF:Audio:unit=lufs is still accepted as an alias that sets layout to lufs (L/R unit stays dbtp).

Colors: web hex (#00FF00), 0x00FF00, or SVG named colors.

HTTP GET or UDP NOW: / NEXT: — see the howtos on the wiki start page (mAirList, Myriad, PlayoutONE, ProppFrexx, RadioBOSS, RadioDJ, StationPlaylist, RCS Zetta).