OnAirScreen can receive API commands via UDP default port 3310 or HTTP default port 8010\ Here is an easy UDP example on how to control a local OnAirScreen instance on a linux system.
Replace the IP address with the IP address of your OnAirScreen. This will be shown in the first footer line of OnAirScreen after start.
Set LED1 Text to "FOO" and switch LED1 on:
echo "CONF:LED1:text=FOO" > /dev/udp/127.0.0.1/3310 echo "LED1:ON" > /dev/udp/127.0.0.1/3310
To remotely control an OnAirScreen from Windows, use the oas_send.exe which is part of the OAS Windows License:
oas_send.exe --ip 192.168.23.5 "LED1:ON"
There is also a special version of oas_send that doesn't need a console to run, so it produces no output and doesn't open a cmd window. Please use it like this:
oas_send-noconsole.exe --ip 192.168.23.5 "LED1:ON"
You can also pass commands to OAS via HTTP. Strings need to be urlencoded.
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
| UDP Command | Function |
|---|---|
LED1:[ON/OFF] | switch LED1 on/off |
LED2:[ON/OFF] | switch LED2 on/off |
LED3:[ON/OFF] | switch LED3 on/off |
LED4:[ON/OFF] | switch LED4 on/off |
NOW:TEXT | set TEXT in first footer line |
NEXT:TEXT | set TEXT in second footer line |
WARN:TEXT | set TEXT and switch on red warning mode |
AIR1:[ON/OFF] | start/stop Mic Timer |
AIR2:[ON/OFF] | start/stop Phone Timer |
AIR3:[ON/OFF/RESET/TOGGLE] | start/stop/reset/toggle Radio Timer |
AIR3TIME:seconds | set Radio Timer to given value in seconds |
AIR4:[ON/OFF/RESET] | start/stop/reset Stream Timer |
CMD:REBOOT | OS restart |
CMD:SHUTDOWN | OS shutdown |
CMD:QUIT | quit OnAirScreen instance |
CONF:General:stationname=TEXT
CONF:General:slogan=TEXT
CONF:General:stationcolor=COLOR
CONF:General:slogancolor=COLOR
CONF:General:replacenow=[False|True]
CONF:General:replacenowtext=TEXT
CONF:LED[1-4]:used=[False|True]
CONF:LED[1-4]:text=TEXT
CONF:LED[1-4]:activebgcolor=COLOR
CONF:LED[1-4]:activetextcolor=COLOR
CONF:LED[1-4]:autoflash=[False|True]
CONF:LED[1-4]:timedflash=[False|True]
CONF:Timers:TimerAIR[1-4]Enabled=[False|True]
CONF:Timers:TimerAIR[1-4]Text=TEXT
CONF:Timers:AIR[1-4]activebgcolor=COLOR
CONF:Timers:AIR[1-4]activetextcolor=COLOR
CONF:Timers:AIR[1-4]iconpath=PathToIcon
CONF:Timers:TimerAIRMinWidth=PIXELS
CONF:Clock:digital=[True|False]
CONF:Clock:showseconds=[True|False]
CONF:Clock:secondsinoneline=[True|False]
CONF:Clock:digitalhourcolor=COLOR
CONF:Clock:digitalsecondcolor=COLOR
CONF:Clock:digitaldigitcolor=COLOR
CONF:Clock:logopath=PathToLogo
CONF:Clock:logoUpper=[True|False]
CONF:Network:udpport=PORT
CONF:Network:tcpport=PORT
CONF:CONF:APPLY=TRUE
COLOR: can be in the form of Webcolors (#00FF00) or in hex notation (0x00FF00) or one of the SVG named colors (https://www.w3.org/TR/SVG11/types.html#ColorKeywords)