onairscreen:proppfrexx-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 ProppFrexx title on OnAirScreen ======

[[https://www.radio42.com/|ProppFrexx ONAIR]] can control OnAirScreen natively via an **OnTrackPlay** command (HTTP GET). The **NOW** footer line accepts ''NOW:TEXT''.

ON AIR LED from the mixer: [[onairscreen:proppfrexx-led-en|Drive LED1 from a ProppFrexx fader / channel ON]].

API reference: [[oas:api|OnAirScreen API / UDP / HTTP / MQTT]]\\
Forum example: [[https://www.radio42.com/proppfrexx/forum/viewtopic.php?t=759|EXEC_SEND_HTTP_GET]]

===== 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**.

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: OnTrackPlay → HTTP GET =====

**General settings → Events/Commands**. Assign to the global **Playlist.OnTrackPlay** event:

<code>
EXEC_SEND_HTTP_GET http://<onairscreen-ip>:8010/?cmd=NOW:${artist} - ${title}
</code>

Placeholders (User Manual appendix / overlay docs): ''${artist}'', ''${title}'', or ''${trackname}'' for a combined “artist – title” string.

ProppFrexx must **URL-encode** the query (spaces, ''&'', non-ASCII). If titles arrive truncated or cut at ''&'', use the encoded variants from the appendix (often a ''_enc'' / URL-encoded form of the same names).

Firewall: TCP **8010**.

A second command can send ''NEXT:…'' if your version exposes next-item tokens (overlay docs list next-track fields such as type/duration; confirm the artist/title next names in your build).

===== Other commands =====

  * ''EXEC_SEND_HTTP_POST'' — OnAirScreen commands are **GET** only; do not POST XML/JSON to port 8010.
  * ''EXEC_SEND_TCP'' — OnAirScreen has **no** TCP command port. Prefer HTTP GET, or UDP if a send-UDP command exists in your appendix.

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

Gate the command on track type (music vs. jingle/spot) in the event/script so beds do not overwrite the footer.

===== Notes =====

  * **Replace IPs after 10s** and **WARN** behave as on the other playout howtos (WARN hides NOW/NEXT).
  * ''EXEC_UPLOAD_FILE'' cannot feed OnAirScreen.
  * 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]]