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

##### 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>

| 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)