onairscreen:stationplaylist-en [astrastudio wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Show the current StationPlaylist title on OnAirScreen ======

[[https://stationplaylist.com/studio.html|StationPlaylist Studio]] can control OnAirScreen natively via **Now Playing → HTTP request** or **TCP/UDP**. The **NOW** footer line accepts ''NOW:TEXT''.

API reference: [[oas:api|OnAirScreen API / UDP / HTTP / MQTT]]

===== What OnAirScreen expects =====

^ Channel ^ Target (default) ^ Example ^
| UDP | Port **3310** | ''NOW:Artist - Title'' |
| HTTP | Port **8010** | ''http://<oas-ip>:8010/?cmd=NOW:Artist%20-%20Title'' |

Optionally the same for the second footer line: ''NEXT:…''. Maximum **500 characters**. OnAirScreen does **not** parse StationPlaylist XML or website HTML/FTP files.

On **Windows** test with ''oas_send.exe'' from the OnAirScreen license:

<code>
oas_send.exe --ip 192.168.23.5 "NOW:Artist - Title"
</code>

If OnAirScreen runs on **the same PC**, use ''127.0.0.1''.

===== Recommended path: Now Playing HTTP request =====

**View → Options → Now Playing** → **Output via HTTP Request** (Stream metadata tab in some versions).

URL:

''http://<onairscreen-ip>:8010/?cmd=NOW:%a - %t''

Template parameters (DEVA / Studio docs):

^ Token ^ Meaning ^
| ''%a'' | Artist |
| ''%t'' | Title |
| ''%n'' | Artist - Title (hyphen omitted if either side is blank) |
| ''%z'' | Track type (''0'' = song) |

Use **GET**. Studio must URL-encode the query. Firewall: TCP **8010**.

===== Option B — UDP =====

Same Now Playing page: **Output via TCP/UDP**.

  * Protocol: **UDP** (not TCP)
  * IP: OnAirScreen host (or ''127.0.0.1'')
  * Port: **3310**
  * Template: ''NOW:%a - %t''  (or ''NOW:%n'')

Do **not** paste an XML MetaRadio template here — OnAirScreen expects the ''NOW:'' line, not XML. Firewall: UDP **3310**.

===== Songs only =====

If the output cannot filter on ''%z'', commercials and jingles land in the footer. Restrict the HTTP/UDP output to songs in the Now Playing options when the version allows it.

===== Notes =====

  * **Replace IPs after 10s** and **WARN** behave as on the other playout howtos (WARN hides NOW/NEXT).
  * Website HTML/XML/FTP Now Playing files cannot feed OnAirScreen directly.
  * Questions: [[https://www.astrastudio.de/kontakt/|Contact]]

===== Other playout systems =====

[[onairscreen:mairlist-en|mAirList]] · [[onairscreen:radioboss-en|RadioBOSS]] · [[onairscreen:radiodj-en|RadioDJ]] · [[onairscreen:playoutone-en|PlayoutONE]] · [[onairscreen:stationplaylist-en|StationPlaylist]] · [[onairscreen:proppfrexx-en|ProppFrexx]] · [[onairscreen:myriad-en|Myriad Playout]] · [[onairscreen:zetta-en|RCS Zetta]]