<markdown>
# OnAirScreen API / UDP / HTTP Commands
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.
</markdown>

<WRAP center round info 60%>
Replace the IP address with the IP address of your OnAirScreen. This will be shown in the first footer line of OnAirScreen after start.
</WRAP>

<markdown>

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"
```


##### HTTP API
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
```

##### API Commands
</markdown>
{{tablelayout?rowsHeaderSource=Auto&float=left&tableSort=1&tableSearch=1}}
^ 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                  |

<markdown>
##### Remote Configuration Commands
`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`  
</markdown>

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)