← onairpanel.com

OnAirPanel User Manual

v1.0 app.onairpanel.com

Version: 1.0 · Platform: app.onairpanel.com

1. What is OnAirPanel?

OnAirPanel is a web-based remote monitoring and control panel for mAirList radio automation software. It connects to mAirList via its built-in REST API and lets you:

  • Monitor your on-air broadcast in real time from any browser, tablet, or smartphone
  • Control the playlist: reorder items, delete tracks, insert titles from the DB Server
  • Display stream health, weather, track history, and a live countdown to the next item
  • Manage multiple stations and multiple users with role-based permissions
  • Share a read-only view with guests or your audience (Audience Mode)

OnAirPanel runs entirely in the cloud — there is nothing to install on your broadcast PC beyond the mAirList REST API, which mAirList enables with a few clicks.

2. Requirements

mAirList Side

Requirement Notes
mAirList Advanced Server or Professional Studio OnAirPanel exclusively supports these two editions. The REST API is not available in Home or Standard editions.
mAirList version 7 or later Playlist display and control require at least version 7.
mAirList 8.0.8 Build 6041 or later (May 2026) Required for enabling/disabling individual Stream Monitor inputs via the panel. Earlier versions support all other features.
REST API enabled Configuration → Remote Control → Network → REST
REST API port open Default port 9300; must be reachable from the internet or via tunnel
DB Server (optional) Required for title search; mAirList Advanced Server or Professional Studio only
DB Server port open Default port 8840 (HTTPS: 9840)

To enable the REST API in mAirList:
Open Configuration → Remote Control → Network → REST, enable the server, set the port to 9300, and optionally restrict access by IP address.

Note on versions: Playlist display and control work with mAirList 7 and later. Enabling and disabling individual Stream Monitor inputs via OnAirPanel requires at least version 8.0.8 Build 6041 (released May 2026).

OnAirPanel Side

  • A modern web browser (Chrome, Firefox, Safari, Edge)
  • An OnAirPanel account at app.onairpanel.com
  • Your mAirList station's IP address (or a Cloudflare Tunnel URL for remote access)

Network

If mAirList runs on a local network without a public IP address, you need a tunnel to make it reachable. OnAirPanel natively supports Cloudflare Tunnel — see Section 9.

3. Quick Start

  1. Create an account at app.onairpanel.com and log in.
  2. Open Setup by clicking the ⚙ gear icon in the top-right corner of the monitor.
  3. Enter your server details under the Server tab:
  4. IP address of the PC running mAirList
  5. REST API port (default: 9300)
  6. REST API username and password (as configured in mAirList)
  7. Save the settings. The monitor will reload and begin pulling live data.
  8. Arrange sections under the Sections tab to show or hide widgets as needed.
  9. Optional: Configure weather, stream monitoring, or DB Server access.

4. The Monitor

4.1 Overview & Layout

The monitor is the main screen of OnAirPanel. It displays a configurable set of sections (widgets) arranged vertically. Each section can be enabled, disabled, and reordered in Setup → Sections.

The default section order is:

  1. Stream Monitor
  2. Countdown
  3. Player (Now Playing)
  4. Weather
  5. Track History
  6. Time Strip
  7. Now Playing Banner
  8. Playlist

4.2 Stream Monitor

Shows the live status of your configured Icecast/Shoutcast stream. The card displays:

  • Stream name and current metadata (artist – title) pulled from the stream
  • On-air indicator: green when the stream is active, grey when offline
  • Listener count (if supported by your streaming server)

The stream metadata is fetched independently from the mAirList REST API, so it reflects what listeners actually hear — useful for spotting encoding or metadata issues.

4.3 Countdown Card

Displays the time remaining until the currently playing item ends, shown as a large countdown timer.

  • In Countdown Mode, the timer counts down from the item's total duration.
  • The mode can be toggled between countdown and elapsed time directly on the card.
  • A colour indicator changes as the item nears its end.

4.4 Player (Now Playing)

Shows the currently playing item with:

  • Artist and title
  • Album / year (where available)
  • Duration and elapsed time bar
  • Ramp time (intro duration before the vocal starts)
  • Playback status (playing, paused, stopped)
  • Automation mode badge: AUTO (fully automated) or ASSIST (assisted/manual)

4.5 Weather Tile

Displays current weather for a configured location, sourced from OpenWeatherMap. Shows:

  • Temperature (°C or °F)
  • Weather condition with icon
  • Location name

Configure the location and API key under Setup → Display.

4.6 Track History

Shows the last played tracks in reverse chronological order (most recent first), with artist, title, and time of play.

4.7 Time Strip

A compact bar showing the current time, which is useful for at-a-glance on-air time awareness.

4.8 Now Playing Banner

A secondary now-playing display optimised for smaller screens or banner-style placement. Shows artist and title in a single-line format.

4.9 Playlist

The playlist section shows the upcoming items in the mAirList playlist. Each item displays:

  • Position number
  • Artist and title
  • Duration
  • Ramp time (intro)
  • Item type (music, jingle, script, news, etc.)
  • Hour borders (schedule separators inserted by mAirList)

Configurable playlist length: You can set how many upcoming items to display (5–50) under Setup → Display → Playlist Limit. The default is 15.

4.10 Playlist Controls

Users with the Technik (operator) role or higher can interact with playlist items directly:

Drag & Drop Reordering

Grab any playlist item by its drag handle (☰ icon on the left) and drag it to a new position. The item moves in mAirList immediately. Hour borders are shown for orientation but cannot be dragged.

Delete

Click the 🗑 delete button on any item to remove it from the mAirList playlist. A confirmation step prevents accidental deletion. The item disappears immediately from the panel and mAirList updates in sync.

Clone

Click the ⧉ clone button to duplicate an item at its current position. The copy is inserted directly below the original.

Insert from DB Server

Click the + button on any playlist item to open the DB Server title search and insert a track at that position. Requires the DB Server to be configured and the user to have the Title Search permission.

Requires: mAirList Advanced or Professional edition with DB Server enabled and configured in OnAirPanel Setup.

The title search modal lets you search the mAirList database for tracks and insert them directly into the playlist.

How to use:

  1. Click the + button on the playlist item above the position where you want to insert.
  2. Type a search term (artist, title, or keyword) into the search field.
  3. Results appear in a table showing: Artist, Title, Year, Duration, BPM, Comment.
  4. Click a column header to sort the results.
  5. Click Insert next to any track.
  6. The track is inserted into the mAirList playlist at the chosen position and the modal closes automatically. The inserted item flashes green in the playlist to confirm success.

Lock timer: After inserting a track, the insert buttons are briefly locked until the playlist refreshes with confirmed data from mAirList, preventing double insertions.

5. Setup

Open Setup with the ⚙ icon in the top-right corner. Setup has four tabs.

5.1 Server Tab

Credentials (top section)

Field Description
REST Server User Username configured in mAirList REST API settings
REST Server Password Password for the REST API
DB Server User Username for the mAirList DB Server (separate from REST credentials)
DB Server Password Password for the DB Server

All password fields can be revealed with the 👁 toggle.

Direct Connection (bottom section)

Field Description
IP Address Local or public IP of the mAirList PC
REST Port Default: 9300
DB Server Port Default: 8840 (HTTPS: 9840)
REST Tunnel URL Cloudflare Tunnel URL for the REST API (optional)
DB Server Tunnel URL Cloudflare Tunnel URL for the DB Server (optional)

If a tunnel URL is entered, OnAirPanel uses it automatically for all connections — no need to change the IP address. Connection tests also use the tunnel URL when available.

Connection Test
Click Test Connection to verify the REST API or DB Server is reachable. The result shows response time and confirms successful authentication.

5.2 Display Tab

Setting Description
Station Name Display name shown in the browser title and header
Language Interface language for this station
Weather Location City name or coordinates for the weather tile
OpenWeatherMap API Key Required for the weather tile
Playlist Limit Number of playlist items to display (5–50, default: 15)
Audience Mode Enable/disable Audience Mode for this station

5.3 Sections Tab

Shows all available monitor sections with toggle switches and a drag handle for reordering. Disabled sections are hidden from the monitor entirely.

Changes take effect immediately — no save button required.

5.4 Status Tab

Shows a live diagnostic overview with four parallel checks:

  • REST API — connection and authentication status
  • DB Server — connection and authentication status (if configured)
  • Stream — stream URL reachability
  • Weather — OpenWeatherMap API key validity

Each check shows a loading shimmer while running, then a green ✓ or red ✗ with a short status message.

6. User Management

6.1 Roles

OnAirPanel has three user roles:

Role Access
Moderator Read-only monitor access. Can view all sections but cannot control the playlist.
Technik Full monitor access plus playlist control: drag & drop, delete, clone, and (if permitted) DB Server title search.
Admin All Technik permissions plus access to Setup and user management for their station.

6.2 Permissions

In addition to roles, individual permissions can be granted or revoked per user:

Permission Description
Title Search in Monitor Allows the user to use the DB Server title search (+ button on playlist items)

Permissions are managed by Admins in the user management panel.

6.3 Two-Factor Authentication

OnAirPanel supports TOTP-based two-factor authentication (compatible with Google Authenticator, Aegis, and any RFC 6238 app).

To enable 2FA: 1. Open your account settings. 2. Click Enable Two-Factor Authentication. 3. Scan the QR code with your authenticator app. 4. Enter the six-digit code to confirm setup.

Once enabled, a code is required at every login. If you lose access to your authenticator, contact your station Admin.

7. Audience Mode

Audience Mode is a special display mode designed to be shown on a public screen (e.g., a studio window display, a social media stream overlay, or a lobby monitor).

In Audience Mode:

  • Only music items are shown in the playlist — jingles, scripts, news items, and other non-music elements are hidden
  • Non-music items that are currently playing show their item type label instead of technical details
  • Hour borders are hidden
  • Drag & drop and all playlist controls are disabled
  • The interface is clean and suitable for a non-technical audience

To enable Audience Mode: go to Setup → Display and toggle Audience Mode on. The mode applies to all users viewing that station.

8. Multi-Station Setup

OnAirPanel supports multiple stations under a single account. Each station has its own:

  • Server connection settings (IP, ports, credentials, tunnel URLs)
  • Display settings (name, language, weather, playlist limit)
  • Section configuration
  • User assignments and permissions
  • Stream monitor configuration

To add a station: Contact your OnAirPanel administrator or use the admin panel to create a new station and assign users to it.

Station switching: If your account has access to multiple stations, a station switcher appears in the navigation. Click it to switch between stations without logging out.

Duplicating a station: Admins can duplicate an existing station to copy all settings (server credentials, display config, sections, DB Server settings) as a starting point for a new station.

9. Cloudflare Tunnel (Remote Access)

If your mAirList PC is on a local network without a public IP address, you can use a Cloudflare Tunnel to make it reachable securely — no port forwarding required.

How it works

Cloudflare Tunnel (cloudflared) runs as a Windows service on your mAirList PC. It creates an encrypted outbound connection to Cloudflare's network and assigns a stable public HTTPS URL to your local service.

Setup (token-based install)

  1. Log in to dash.cloudflare.com and go to Zero Trust → Access → Tunnels.
  2. Create a new tunnel and give it a name (e.g., mairlist-studio1).
  3. Choose Windows and copy the install command with your tunnel token.
  4. Run the command on your mAirList PC — this installs cloudflared as a Windows service and starts it automatically.
  5. Add a Route in the Cloudflare dashboard:
  6. Subdomain: e.g., studio1
  7. Domain: your Cloudflare domain
  8. Service URL: http://localhost:9300 (the local mAirList REST API)
  9. Cloudflare creates the DNS CNAME record automatically.
  10. In OnAirPanel Setup → Server, enter the tunnel URL (e.g., https://studio1.yourdomain.com) in the REST Tunnel URL field.

One cloudflared service per PC. A single service can handle multiple routes (e.g., REST API on port 9300 and DB Server on port 8840) — just add a second route in the Cloudflare dashboard pointing to http://localhost:8840.

Do not use credentials-file in config.yml with token-based installs. The token handles authentication automatically.

10. FAQ & Troubleshooting

The monitor shows "Connection failed". What should I check?
First, use Setup → Status to run the connection tests. Common causes: mAirList is not running, the REST API is disabled in mAirList settings, the port is blocked by a firewall, or the IP address / tunnel URL is wrong.

The playlist does not update.
The monitor polls the mAirList REST API every few seconds. If the playlist stops updating, check the Status tab. If the REST API responds but the playlist is empty, verify that a playlist is loaded in mAirList.

Drag & drop does not work.
Only users with the Technik role or higher can reorder the playlist. Also confirm that Audience Mode is not enabled — it disables all playlist controls.

The DB Server title search shows no results.
Check that the DB Server is running in mAirList (it is a separate process from the REST API, requiring Advanced or Professional edition). Verify the DB Server credentials and port in Setup → Server. Run the connection test for the DB Server.

I cannot see the + (insert) button.
The title search button is only shown if: (a) the DB Server is configured, and (b) your user account has the Title Search in Monitor permission. Contact your Admin to enable it.

Weather is not showing.
Verify your OpenWeatherMap API key under Setup → Display, and confirm the location name is valid. New API keys may take a few minutes to activate after registration.

I lost my 2FA device.
Contact your station Admin. Admins can reset 2FA for users in the user management panel.

The stream monitor shows the wrong metadata.
Stream metadata is fetched directly from the Icecast/Shoutcast server, not from mAirList. If the encoder is not sending correct metadata, or if there is a delay in the stream, the monitor may lag behind or show stale data.

Can I use OnAirPanel on a smartphone?
Yes. OnAirPanel is responsive and works in mobile browsers. Portrait orientation on some iOS devices may limit the display of certain timing details in the playlist — landscape orientation is recommended for full playlist detail on mobile.

OnAirPanel is developed by OnAirWerk. For support, contact us via app.onairpanel.com.

OnAirPanel Benutzerhandbuch

v1.0 app.onairpanel.com

Version: 1.0 · Plattform: app.onairpanel.com

1. Was ist OnAirPanel?

OnAirPanel ist ein webbasiertes Fernüberwachungs- und Steuerungspanel für die Radioautomationssoftware mAirList. Es verbindet sich über die integrierte REST API von mAirList und ermöglicht:

  • Überwachung der laufenden Sendung in Echtzeit – im Browser, auf dem Tablet oder Smartphone
  • Steuerung der Playlist: Reihenfolge ändern, Titel löschen, Tracks aus dem DB-Server einfügen
  • Anzeige von Streamstatus, Wetter, Titelverlauf und einem Live-Countdown bis zum nächsten Titel
  • Verwaltung mehrerer Sender und Benutzer mit rollenbasierten Rechten
  • Publikumsansicht für Bildschirme im Senderbereich oder öffentliche Displays (Publikumsmodus)

OnAirPanel läuft vollständig in der Cloud – auf dem Sendungs-PC ist keine zusätzliche Software nötig, abgesehen von der REST API, die mAirList bereits eingebaut hat.

2. Voraussetzungen

mAirList-Seite

Anforderung Hinweis
mAirList Advanced Server oder Professional Studio OnAirPanel ist ausschließlich mit diesen beiden Editionen zu betreiben. Die REST API ist in der Home- und Standard-Edition nicht verfügbar.
mAirList Version 7 oder neuer Anzeige und Steuerung der Playlist erfordern mindestens Version 7.
mAirList 8.0.8 Build 6041 oder neuer (Mai 2026) Erforderlich für das Aktivieren/Deaktivieren einzelner Stream-Monitor-Eingänge per Mausklick. Alle anderen Funktionen sind mit früheren Versionen nutzbar.
REST API aktiviert Konfiguration → Fernsteuerung → Netzwerk → REST
REST API Port erreichbar Standard: 9300; muss aus dem Internet oder per Tunnel erreichbar sein
DB Server (optional) Für Titelsuche; nur mAirList Advanced Server oder Professional Studio
DB Server Port erreichbar Standard: 8840 (HTTPS: 9840)

REST API in mAirList aktivieren:
Öffne Konfiguration → Fernsteuerung → Netzwerk → REST, aktiviere den Server, setze den Port auf 9300 und schränke den Zugriff optional auf bestimmte IP-Adressen ein.

Hinweis zu Versionen: Anzeige und Steuerung der Playlist funktionieren ab mAirList Version 7. Das Aktivieren und Deaktivieren einzelner Stream-Monitor-Eingänge über OnAirPanel erfordert mindestens Version 8.0.8 Build 6041 (erschienen Mai 2026).

OnAirPanel-Seite

  • Ein moderner Webbrowser (Chrome, Firefox, Safari, Edge)
  • Ein OnAirPanel-Konto unter app.onairpanel.com
  • IP-Adresse der mAirList-Station (oder eine Cloudflare-Tunnel-URL für Fernzugriff)

Netzwerk

Wenn mAirList im lokalen Netzwerk ohne öffentliche IP läuft, ist ein Tunnel erforderlich. OnAirPanel unterstützt Cloudflare Tunnel direkt – siehe Abschnitt 9.

3. Schnellstart

  1. Konto anlegen unter app.onairpanel.com und einloggen.
  2. Setup öffnen – das ⚙-Symbol oben rechts im Monitor anklicken.
  3. Serververbindung eintragen im Tab Server:
  4. IP-Adresse des PCs, auf dem mAirList läuft
  5. REST API Port (Standard: 9300)
  6. REST API Benutzername und Passwort (wie in mAirList konfiguriert)
  7. Speichern. Der Monitor lädt neu und beginnt, Live-Daten abzurufen.
  8. Abschnitte anordnen im Tab Abschnitte – nach Bedarf ein- oder ausblenden.
  9. Optional: Wetter, Stream-Monitoring oder DB-Server-Zugang einrichten.

4. Der Monitor

4.1 Übersicht & Aufbau

Der Monitor ist die Hauptansicht von OnAirPanel. Er zeigt eine konfigurierbare Auswahl von Abschnitten (Widgets), die vertikal untereinander angeordnet sind. Jeder Abschnitt kann unter Einrichtung → Abschnitte aktiviert, deaktiviert und umsortiert werden.

Standardreihenfolge:

  1. Stream-Monitor
  2. Countdown
  3. Player (Jetzt läuft)
  4. Wetter
  5. Verlauf
  6. Zeitstreifen
  7. Jetzt läuft (Banner)
  8. Playlist

4.2 Stream-Monitor

Zeigt den Live-Status des konfigurierten Icecast/Shoutcast-Streams. Die Karte zeigt:

  • Streamname und aktuelle Metadaten (Interpret – Titel) direkt aus dem Stream
  • On-Air-Indikator: grün wenn der Stream aktiv ist, grau wenn offline
  • Hörerzahl (sofern vom Streamingserver unterstützt)

Die Metadaten werden unabhängig von der mAirList REST API abgerufen – sie spiegeln das wider, was Hörer tatsächlich empfangen. Ideal zum Aufdecken von Encoding- oder Metadaten-Problemen.

4.3 Countdown-Karte

Zeigt die verbleibende Zeit des aktuell spielenden Titels als großen Countdown-Timer.

  • Im Countdown-Modus zählt der Timer von der Gesamtlaufzeit abwärts.
  • Der Modus kann direkt auf der Karte umgeschaltet werden (Countdown / Laufzeit).
  • Ein Farbindikator ändert sich, wenn der Titel sich dem Ende nähert.

4.4 Player (Jetzt läuft)

Zeigt den aktuell spielenden Titel mit:

  • Interpret und Titel
  • Album / Jahr (wenn verfügbar)
  • Laufzeit und Fortschrittsbalken
  • Ramp-Zeit (Intro-Dauer bis zum Einsatz des Gesangs)
  • Wiedergabestatus (läuft, pausiert, gestoppt)
  • Automationsmodus-Badge: AUTO (vollautomatisch) oder ASSIST (assistiert/manuell)

4.5 Wetter-Kachel

Zeigt das aktuelle Wetter für einen konfigurierten Ort, Daten von OpenWeatherMap. Angezeigt wird:

  • Temperatur (°C oder °F)
  • Wetterzustand mit Icon
  • Ortsname

Ort und API-Schlüssel werden unter Einrichtung → Anzeige konfiguriert.

4.6 Verlauf

Zeigt die zuletzt gespielten Titel in umgekehrter chronologischer Reihenfolge (neueste zuerst), mit Interpret, Titel und Uhrzeit der Wiedergabe.

4.7 Zeitstreifen

Ein kompakter Balken mit der aktuellen Uhrzeit – praktisch für den schnellen Blick auf die Sendezeit.

4.8 Jetzt läuft (Banner)

Eine alternative Jetzt-läuft-Anzeige, optimiert für kleinere Bildschirme oder Banner-Darstellungen. Zeigt Interpret und Titel in einzeiliger Form.

4.9 Playlist

Die Playlist-Kachel zeigt die nächsten Titel aus der mAirList-Playlist. Jeder Eintrag zeigt:

  • Positionsnummer
  • Interpret und Titel
  • Laufzeit
  • Ramp-Zeit (Intro)
  • Titeltyp (Musik, Jingle, Skript, Nachrichten usw.)
  • Stundentrenner (von mAirList eingefügte Stundenmarkierungen)

Konfigurierbare Playlist-Länge: Unter Einrichtung → Anzeige → Playlist-Limit kannst du einstellen, wie viele Titel angezeigt werden (5–50, Standard: 15).

4.10 Playlist-Steuerung

Benutzer mit der Rolle Technik oder höher können Playlist-Einträge direkt bearbeiten:

Drag & Drop (Reihenfolge ändern)

Den Drag-Griff (☰-Symbol links) am gewünschten Titel greifen und an die neue Position ziehen. mAirList übernimmt die Änderung sofort. Stundentrenner werden zur Orientierung angezeigt, können aber nicht verschoben werden.

Löschen

Das 🗑-Symbol am Titel klicken, um ihn aus der mAirList-Playlist zu entfernen. Ein Bestätigungsschritt verhindert versehentliches Löschen. Der Titel verschwindet sofort aus dem Panel und mAirList aktualisiert sich synchron.

Klonen

Das ⧉-Symbol klicken, um einen Titel an seiner aktuellen Position zu duplizieren. Die Kopie wird direkt unter dem Original eingefügt.

Aus DB-Server einfügen

Das +-Symbol an einem Playlist-Eintrag klicken, um die DB-Server-Titelsuche zu öffnen und einen Track an dieser Position einzufügen. Erfordert einen konfigurierten DB-Server und die Berechtigung Titelsuche im Monitor.

4.11 DB-Server Titelsuche

Voraussetzung: mAirList Advanced oder Professional mit aktiviertem DB-Server und konfigurierter Verbindung in OnAirPanel.

Die Titelsuche ermöglicht das Suchen in der mAirList-Datenbank und das direkte Einfügen von Titeln in die Playlist.

Bedienung:

  1. Das +-Symbol am Playlist-Eintrag klicken, über der gewünschten Einfügeposition.
  2. Einen Suchbegriff eingeben (Interpret, Titel oder Stichwort).
  3. Ergebnisse erscheinen als Tabelle mit: Interpret, Titel, Jahr, Dauer, BPM, Kommentar.
  4. Spaltenköpfe anklicken zum Sortieren.
  5. Einfügen neben dem gewünschten Titel anklicken.
  6. Der Titel wird in der mAirList-Playlist an der gewählten Position eingefügt, das Fenster schließt sich automatisch. Der neue Eintrag blinkt grün zur Bestätigung.

Sperrtimer: Nach dem Einfügen sind die Schaltflächen kurz gesperrt, bis die Playlist mit den bestätigten Daten aus mAirList aktualisiert wurde – verhindert Doppeleinfügungen.

5. Einrichtung (Setup)

Setup öffnen über das ⚙-Symbol oben rechts. Setup hat vier Tabs.

5.1 Tab „Server"

Zugangsdaten (oberer Bereich)

Feld Beschreibung
REST Server Benutzer Benutzername aus den mAirList REST-API-Einstellungen
REST Server Passwort Passwort für die REST API
DB Server Benutzer Benutzername für den mAirList DB Server (getrennt von REST)
DB Server Passwort Passwort für den DB Server

Alle Passwortfelder können mit dem 👁-Symbol aufgedeckt werden.

Direkte Verbindung (unterer Bereich)

Feld Beschreibung
IP-Adresse Lokale oder öffentliche IP des mAirList-PCs
REST Port Standard: 9300
DB Server Port Standard: 8840 (HTTPS: 9840)
REST Tunnel-URL Cloudflare-Tunnel-URL für die REST API (optional)
DB Server Tunnel-URL Cloudflare-Tunnel-URL für den DB Server (optional)

Wenn eine Tunnel-URL eingetragen ist, verwendet OnAirPanel diese automatisch für alle Verbindungen – die IP-Adresse muss nicht geändert werden. Verbindungstests nutzen die Tunnel-URL ebenfalls automatisch.

Verbindungstest
Verbindung testen anklicken, um zu prüfen ob REST API oder DB Server erreichbar sind. Das Ergebnis zeigt die Antwortzeit und bestätigt erfolgreiche Authentifizierung.

5.2 Tab „Anzeige"

Einstellung Beschreibung
Sendername Anzeigename im Browsertitel und Header
Sprache Oberflächensprache für diese Station
Wetterort Stadtname oder Koordinaten für die Wetter-Kachel
OpenWeatherMap API-Schlüssel Erforderlich für die Wetter-Kachel
Playlist-Limit Anzahl der angezeigten Playlist-Einträge (5–50, Standard: 15)
Publikumsmodus Publikumsmodus für diese Station aktivieren/deaktivieren

5.3 Tab „Abschnitte"

Zeigt alle verfügbaren Monitor-Abschnitte mit Umschaltern und Drag-Griffen zum Umsortieren. Deaktivierte Abschnitte werden im Monitor vollständig ausgeblendet.

Änderungen wirken sofort – kein Speichern nötig.

5.4 Tab „Status"

Zeigt eine Live-Diagnose mit vier parallelen Prüfungen:

  • REST API – Verbindungs- und Authentifizierungsstatus
  • DB Server – Verbindungs- und Authentifizierungsstatus (wenn konfiguriert)
  • Stream – Erreichbarkeit der Stream-URL
  • Wetter – Gültigkeit des OpenWeatherMap API-Schlüssels

Jede Prüfung zeigt einen Ladeindikator (Shimmer-Animation), danach ein grünes ✓ oder rotes ✗ mit Statusmeldung.

6. Benutzerverwaltung

6.1 Rollen

OnAirPanel hat drei Benutzerrollen:

Rolle Zugriff
Moderator Reiner Lesezugriff auf den Monitor. Alle Abschnitte sichtbar, keine Playlist-Steuerung.
Technik Voller Monitor-Zugriff plus Playlist-Steuerung: Drag & Drop, Löschen, Klonen und (wenn berechtigt) DB-Server-Titelsuche.
Admin Alle Technik-Rechte plus Zugriff auf Einrichtung und Benutzerverwaltung der eigenen Station.

6.2 Berechtigungen

Zusätzlich zu den Rollen können einzelne Berechtigungen pro Benutzer vergeben oder entzogen werden:

Berechtigung Beschreibung
Titelsuche im Monitor Erlaubt die Nutzung der DB-Server-Titelsuche (+-Symbol an Playlist-Einträgen)

Berechtigungen werden von Admins in der Benutzerverwaltung verwaltet.

6.3 Zwei-Faktor-Authentifizierung

OnAirPanel unterstützt TOTP-basierte Zwei-Faktor-Authentifizierung (kompatibel mit Google Authenticator, Aegis und allen RFC 6238-Apps).

2FA aktivieren: 1. Kontoeinstellungen öffnen. 2. Zwei-Faktor-Authentifizierung aktivieren anklicken. 3. Den QR-Code mit der Authenticator-App scannen. 4. Den sechsstelligen Code zur Bestätigung eingeben.

Einmal aktiviert, wird bei jeder Anmeldung ein Code abgefragt. Bei Verlust des Authenticators den Stationsadmin kontaktieren.

7. Publikumsmodus

Der Publikumsmodus ist eine Spezialansicht für öffentliche Bildschirme – z.B. im Studio-Schaufenster, als Overlay für Social-Media-Streams oder auf einem Display im Empfangsbereich.

Im Publikumsmodus:

  • Nur Musiktitel werden in der Playlist angezeigt – Jingles, Skripte, Nachrichten und andere Nicht-Musik-Elemente werden ausgeblendet
  • Nicht-Musik-Elemente, die gerade spielen, zeigen ihr Typ-Label statt technischer Details
  • Stundentrenner werden ausgeblendet
  • Drag & Drop und alle Playlist-Steuerfunktionen sind deaktiviert
  • Die Ansicht ist übersichtlich und für ein nicht-technisches Publikum geeignet

Aktivieren: Einrichtung → Anzeige → Publikumsmodus einschalten. Der Modus gilt für alle Benutzer, die diese Station aufrufen.

8. Mehrere Sender

OnAirPanel unterstützt mehrere Sender unter einem Konto. Jeder Sender hat eigene:

  • Serververbindungseinstellungen (IP, Ports, Zugangsdaten, Tunnel-URLs)
  • Anzeigeeinstellungen (Name, Sprache, Wetter, Playlist-Limit)
  • Abschnittskonfiguration
  • Benutzerzuweisungen und Berechtigungen
  • Stream-Monitor-Konfiguration

Sender hinzufügen: OnAirPanel-Administrator kontaktieren oder das Admin-Panel nutzen, um einen neuen Sender anzulegen und Benutzer zuzuweisen.

Senderwechsel: Hat ein Konto Zugriff auf mehrere Sender, erscheint eine Senderauswahl in der Navigation. Einfach anklicken – kein erneutes Einloggen nötig.

Sender duplizieren: Admins können einen bestehenden Sender kopieren, um alle Einstellungen (Serververbindung, Anzeige, Abschnitte, DB-Server-Daten) als Ausgangspunkt für einen neuen Sender zu übernehmen.

9. Cloudflare Tunnel (Fernzugriff)

Wenn mAirList im lokalen Netzwerk ohne öffentliche IP-Adresse läuft, ermöglicht ein Cloudflare Tunnel sicheren Fernzugriff – ohne Portweiterleitung am Router.

Funktionsweise

cloudflared läuft als Windows-Dienst auf dem mAirList-PC. Es baut eine verschlüsselte ausgehende Verbindung zum Cloudflare-Netzwerk auf und stellt eine stabile öffentliche HTTPS-URL für den lokalen Dienst bereit.

Einrichtung (Token-basierte Installation)

  1. Bei dash.cloudflare.com einloggen und zu Zero Trust → Access → Tunnels navigieren.
  2. Einen neuen Tunnel anlegen und einen Namen vergeben (z.B. mairlist-studio1).
  3. Windows auswählen und den Installationsbefehl mit dem Tunnel-Token kopieren.
  4. Den Befehl auf dem mAirList-PC ausführen – cloudflared wird als Windows-Dienst installiert und startet automatisch.
  5. Eine Route im Cloudflare-Dashboard hinzufügen:
  6. Subdomain: z.B. studio1
  7. Domain: eigene Cloudflare-Domain
  8. Service-URL: http://localhost:9300 (lokale mAirList REST API)
  9. Cloudflare legt den DNS-CNAME-Eintrag automatisch an.
  10. In OnAirPanel Einrichtung → Server die Tunnel-URL (z.B. https://studio1.einedomain.de) im Feld REST Tunnel-URL eintragen.

Ein cloudflared-Dienst pro PC. Ein Dienst kann mehrere Routes verwalten (z.B. REST API auf Port 9300 und DB Server auf Port 8840) – einfach eine zweite Route im Cloudflare-Dashboard auf http://localhost:8840 anlegen.

Keine credentials-file in config.yml bei Token-basierter Installation – der Token übernimmt die Authentifizierung automatisch.

10. FAQ & Fehlerbehebung

Der Monitor zeigt „Verbindung fehlgeschlagen". Was prüfen?
Als erstes den Status-Tab in der Einrichtung öffnen. Häufige Ursachen: mAirList läuft nicht, die REST API ist in mAirList deaktiviert, der Port ist durch eine Firewall gesperrt, oder IP-Adresse / Tunnel-URL ist falsch eingetragen.

Die Playlist aktualisiert sich nicht.
Der Monitor fragt die mAirList REST API alle paar Sekunden ab. Wenn die Playlist aufhört zu aktualisieren, den Status-Tab prüfen. Antwortet die REST API, aber die Playlist ist leer, sicherstellen, dass in mAirList eine Playlist geladen ist.

Drag & Drop funktioniert nicht.
Nur Benutzer mit der Rolle Technik oder höher können die Playlist umsortieren. Außerdem prüfen, ob der Publikumsmodus aktiv ist – dieser deaktiviert alle Steuerelemente.

Die DB-Server-Titelsuche liefert keine Ergebnisse.
Prüfen ob der DB Server in mAirList läuft (er ist ein separater Prozess von der REST API, nur in Advanced oder Professional verfügbar). DB-Server-Zugangsdaten und Port in Einrichtung → Server kontrollieren. Den Verbindungstest für den DB Server ausführen.

Ich sehe kein +-Symbol (Einfügen).
Die Titelsuche-Schaltfläche erscheint nur wenn: (a) der DB Server konfiguriert ist, und (b) das Benutzerkonto die Berechtigung Titelsuche im Monitor hat. Den Admin kontaktieren, um sie zu aktivieren.

Das Wetter wird nicht angezeigt.
Den OpenWeatherMap API-Schlüssel unter Einrichtung → Anzeige prüfen und sicherstellen, dass der Ortsname gültig ist. Neue API-Schlüssel können nach der Registrierung einige Minuten brauchen bis sie aktiv sind.

Ich habe meinen 2FA-Authenticator verloren.
Den Stationsadmin kontaktieren. Admins können 2FA für Benutzer in der Benutzerverwaltung zurücksetzen.

Der Stream-Monitor zeigt falsche Metadaten.
Stream-Metadaten werden direkt vom Icecast/Shoutcast-Server abgerufen, nicht von mAirList. Wenn der Encoder keine korrekten Metadaten sendet oder der Stream verzögert ist, kann der Monitor nachhinken oder veraltete Daten zeigen.

Kann ich OnAirPanel auf dem Smartphone nutzen?
Ja. OnAirPanel ist responsiv und funktioniert in mobilen Browsern. Im Hochformat können auf manchen iOS-Geräten einige Zeitangaben in der Playlist eingeschränkt dargestellt sein – für volle Playlist-Details auf Mobilgeräten wird Querformat empfohlen.

OnAirPanel wird von OnAirWerk entwickelt. Support unter app.onairpanel.com.