RadioPlayer Smart-Home-Integration, kostenlos und Open Source

Webradios Ihres Landes auf Google-Cast-, Sonos- und DLNA-Lautsprechern hören.
Hören Sie die Webradios Ihres Landes auf den Lautsprechern im Haus — Google Cast, Sonos und UPnP/DLNA — direkt aus Gladys: Dashboard, Musik-Panel, Widgets und Szenen.
Die Sender stammen aus Radio Browser, einem freien, offenen Community-Verzeichnis mit über 50.000 Webradios. Der Katalog ist der des gewählten Landes: seine meistgehörten Sender, seine Genres und seine Suche.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Internetzugang für Gladys (Katalog) und für die Lautsprecher (sie laden den Stream selbst).
- Lautsprecher im selben lokalen Netzwerk wie Gladys.
Kein Konto, kein API-Schlüssel. Kein Ton läuft über Gladys: Die Integration sagt dem Lautsprecher, welchen Stream er spielen soll.
Wo es funktioniert
Der Katalog von 20 Ländern in 6 Zonen. Die Integration lässt sich überall installieren, der Gladys-Katalog zeigt sie in diesen Ländern an.
| Zone | Länder (Sender im Katalog, November 2026) |
|---|---|
| Westeuropa | Frankreich (3.500+), Belgien (590+), Luxemburg (35), Niederlande (1.450+), Vereinigtes Königreich (2.300+), Irland (230+) |
| Mitteleuropa | Deutschland (6.300+), Schweiz (650+), Österreich (360+) |
| Südeuropa | Spanien (1.450+), Portugal (380+), Italien (1.800+) |
| Nordamerika | Kanada (1.550+), Vereinigte Staaten (7.800+) |
| Lateinamerika | Mexiko (2.800+), Argentinien (1.150+), Chile (590+), Kolumbien (740+), Peru (310+) |
| Ozeanien | Australien (1.800+) |
Konfiguration, Dokumentation und Meldungen gibt es auf Deutsch, Englisch, Französisch und Spanisch.
In 3 Schritten starten
- Tab Konfiguration: Katalogland wählen und speichern.
- Tab Erkennung der Integration: Ihre Lautsprecher stehen dort — fügen Sie die gewünschten hinzu. Die Liste ist leer? Zurück zur Konfiguration und Lautsprecher suchen drücken: Die Suche läuft erneut und zeigt, was jeder Kanal (Google Cast, Sonos/DLNA) geantwortet hat.
- Hören: Jetzt einen Sender abspielen in der Konfiguration (Lautsprecher wählen, Sendernamen eingeben), oder die Musik-Box des Dashboards, die RadioPlayer-Widgets oder Szenen.
Unterstützte Lautsprecher
| Familie | Beispiele | Gefunden über |
|---|---|---|
| Google Cast | Chromecast, Chromecast Audio, Google Home / Nest, Android TV, Lautsprecher mit Chromecast built-in (JBL, Sony, Bose, Marshall…) | mDNS |
| Sonos | Alle Sonos-Lautsprecher (S1 und S2) | SSDP |
| UPnP / DLNA | Netzwerk-Receiver (Denon, Marantz, Yamaha, Onkyo, Pioneer), Smart-TVs, Kodi, BubbleUPnP… | SSDP |
Ein Android TV oder ein Lautsprecher mit Chromecast built-in antwortet oft auch als DLNA-Renderer, mit viel schlechterer Stream-Unterstützung: Ein solches Gerät wird nur einmal behalten, als Google Cast. Ein mit einer früheren Version erstelltes Duplikat kann aus der Geräteliste gelöscht werden.
Ein Lautsprecher, den die Suche nicht sieht (anderes Subnetz, Router filtert Multicast), kann manuell hinzugefügt werden, siehe unten.
Konfiguration
- Öffnen Sie den Tab Konfiguration der Integration.
- Wählen Sie das Katalogland.
- Optional:
- Startlautstärke — beim Start eines Senders gesetzte Lautstärke (0 behält die des Lautsprechers);
- MP3-Streams bevorzugen (standardmäßig an) — spielt die MP3-Version eines Senders, wenn es sie gibt: Android TV lehnt reine AAC-Streams ab („Inkompatibles Dateiformat“), ältere DLNA-Renderer AAC oder Ogg. Der Original-Stream bleibt der Ersatz; bricht ein Lautsprecher einen Stream ab, wird automatisch der nächste versucht;
- HLS-Streams ausblenden — viele DLNA-Lautsprecher spielen keine
HLS-Streams (
.m3u8): aktiviert lassen, außer alle Lautsprecher sind Google Cast; - Google-Cast-Lautsprecher / Sonos- und UPnP/DLNA-Lautsprecher — eine nicht genutzte Familie abschalten;
- Manuell hinzugefügte Lautsprecher — die IP-Adresse eines Sonos- oder
Google-Cast-Geräts (z. B.
192.168.1.20: ein Sonos wird selbst erkannt, jede andere IP gilt als Google Cast) oder die URL der UPnP-Beschreibung eines anderen DLNA-Renderers, mit Kommas getrennt.
- Speichern, Tab Erkennung öffnen und die Lautsprecher hinzufügen.
Buttons der Konfiguration
- Lautsprecher suchen — durchsucht jetzt das Netzwerk und zeigt das Ergebnis.
- Jetzt einen Sender abspielen — spielt einen Sender auf einem Ihrer Lautsprecher.
- Radiokatalog testen — Anzahl der Sender und die fünf meistgehörten Ihres Landes.
- Lautsprecher testen — prüft, ob ein Lautsprecher antwortet, und seine Lautstärke.
- Favorit hinzufügen / entfernen / anzeigen.
Die eingebauten Lautsprecher-Integrationen von Gladys
Gladys bringt auch eigene Sonos-, Google-Cast- und AirPlay-Integrationen mit. Sie spielen nur Sprachansagen (Text-to-Speech), und Gladys erlaubt einer anderen Integration nicht, ihre Geräte zu steuern. RadioPlayer findet und steuert die Lautsprecher daher selbst; ein Lautsprecher kann zugleich ein eingebautes und ein RadioPlayer-Gerät sein. RadioPlayer-Geräte sind Gladys-Musik-Player: Sie nutzen die eingebaute Musik-Box des Dashboards (läuft gerade, Durchsuchen, Suche) und die eingebaute Szenenaktion „Medien abspielen“.
Hören
Jeder Lautsprecher ist ein Musik-Player in Gladys:
- das Musik-Panel des Dashboards durchsucht den Katalog: Favoriten, Top-Sender Ihres Landes, Genres (Nachrichten, Talk, Pop, Rock, Oldies, Jazz, Klassik, Elektronisch, Hip-Hop, Sport, Kinder) und Zuletzt gehört, dazu die Suche nach Sendernamen;
- die Gerätekarte bietet Wiedergabe / Pause / Stopp, Lautstärke, Stummschaltung und nächster / vorheriger Sender: Sie wechseln zwischen Ihren Favoriten (ab zwei Favoriten), sonst zwischen den Top-Sendern;
- die Auswahl Radiosender des Geräts listet zuerst Ihre Favoriten (★), dann die Top-Sender Ihres Landes, zum Starten per Fingertipp.
Favoriten
Bis zu 30 Favoriten, gemeinsam für alle Lautsprecher:
- der Button Auswählen des Widgets Radio – läuft gerade öffnet die Senderliste (Favoriten zuerst, dann die Top-Sender): Sender wählen und Zu Favoriten hinzufügen ankreuzen, um ihn zugleich zu merken (den laufenden Sender wählen, um ihn ohne Neustart zu merken);
- die Buttons Favorit hinzufügen, Favorit entfernen und Favoriten anzeigen der Konfiguration nehmen einen Sendernamen.
Dashboard-Widgets
- Radio – läuft gerade — der Sender eines Lautsprechers, sein Logo,
Genres und Streamqualität, mit Zurück, Stopp / Abspielen, Weiter
und Auswählen. Die Stream-Zeile zeigt
(Ersatz)in Orange, wenn der Lautsprecher den bevorzugten MP3-Stream abgebrochen hat und den Original- Stream spielt. - Radio-Presets — Ihre ersten drei Favoriten als Buttons für einen Lautsprecher (oder bis zu drei in den Widget-Einstellungen eingetragene Sender), plus Stopp.
- Top-Radiosender — die meistgehörten Sender des Landes (oder eines Genres) als Raster mit Link zur Website.
Szenen
Auslöser (Kategorie Integrationen des Szeneneditors). Optional den Lautsprecher wählen; leer passt jeder Lautsprecher.
| Auslöser | Wann | Variablen |
|---|---|---|
| Radio gestartet | ein Lautsprecher beginnt zu spielen (Gladys, App, Tasten) | player, station, station_uuid |
| Radio gestoppt | ein Lautsprecher stoppt oder der Stream bricht ab | player, station, station_uuid |
| Lautsprecher nicht erreichbar | ein Lautsprecher antwortet nicht mehr im Netzwerk | player |
In den folgenden Aktionen mit {{triggerEvent.data.station}} lesbar. Ein
Start oder Stopp durch eine RadioPlayer-Szenenaktion löst nichts aus: Eine
Szene kann sich nie selbst in einer Schleife aufrufen.
Aktionen
| Aktion | Parameter | Ausgaben |
|---|---|---|
| Radiosender abspielen | Lautsprecher, Sendername, Lautstärke | started, station_name, station_uuid |
| Favorit abspielen | Lautsprecher, Position (1 = erster), Lautstärke | started, station_name, station_uuid |
| Nächster Sender | Lautsprecher | started, station_name, station_uuid |
| Radio stoppen | Lautsprecher | stopped |
Ein nicht gefundener Sender ist kein Fehler: started ist false, nutzen
Sie es in einer Bedingung. Das Senderfeld akzeptiert Szenenvariablen.
Beispiel — ein Radiowecker: Jeden Werktag um 7:00 → Radiosender abspielen „Deutschlandfunk“ im Schlafzimmer mit 20 % → 1 Stunde warten → Radio stoppen.
Grenzen
- Sonos: auf dem Koordinator einer Gruppe abspielen.
- Formate: Ein Sender, der nur in AAC oder Ogg ohne MP3-Version sendet, spielt eventuell nicht auf Android TV oder älteren DLNA-Renderern: Die Logs nennen den abgelehnten Stream. Wählen Sie einen anderen Sender oder einen anderen Eintrag desselben Radios im Katalog.
- Ältere DLNA-Renderer lehnen eventuell
https-Streams oder AAC ab: einen anderen Sender oder Stream wählen. - HLS-Streams (
.m3u8) spielen nur auf Google Cast; sie sind ausgeblendet, solange HLS-Streams ausblenden aktiv ist. - Der Titel des laufenden Songs wird nicht angezeigt, wohl aber Sendername, Genres und Streamqualität.
Fehlerbehebung
- Kein Lautsprecher in Erkennung: Lautsprecher suchen in der
Konfiguration drücken und den Bericht lesen.
0 Antwort(en)auf einem Kanal heißt, dass die Lautsprecher nicht auf die Netzwerksuche geantwortet haben: Sind sie eingeschaltet und im selben Netzwerk wie Gladys (kein Gast-WLAN, kein separates VLAN)? Sonst per IP unter Manuell hinzugefügte Lautsprecher eintragen. EinFehlernennt die Ursache. - „Der Radiokatalog ist nicht erreichbar“: Gladys hat kein Internet, oder Radio Browser ist gestört (die Integration probiert alle Server).
- Ein Sender startet nicht: Lautsprecher testen nutzen und einen anderen Sender probieren; der Stream ist vielleicht offline.
- Die Integration protokolliert alles: Logs in Gladys öffnen
(
LOG_LEVEL=debugfür alle Details).
Datenschutz
Die Integration sendet Radio Browser die Suchen und gespielten Sender (anonym, ohne Konto). Favoriten und zuletzt gehörte Sender bleiben im Datenvolume der Integration auf Ihrem Gladys. Sonst verlässt nichts Ihr Netzwerk.
RadioPlayer ist ein unabhängiges Projekt, ohne Verbindung zu Radio Browser, Google, Sonos oder Radioplayer Worldwide.
Konfigurationseinstellungen
Diese Einstellungen fragt RadioPlayer in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So starten Sie | section | Nein | 1. Wählen Sie unten das Katalogland und speichern Sie. 2. Öffnen Sie den Tab „Erkennung“ dieser Integration und fügen Sie Ihre Lautsprecher hinzu (Google Cast, Sonos, DLNA); nichts zu sehen? Nutzen Sie „Lautsprecher suchen“ unten auf dieser Seite. 3. Hören: „Jetzt einen Sender abspielen“ unten, die Musik-Box oder die RadioPlayer-Widgets im Dashboard, oder Szenen. Für Katalog und Streams ist Internetzugang nötig. |
| Katalogland | select | Ja | Angeboten werden die Sender dieses Landes. |
| Startlautstärke (%) | number | Nein | Lautstärke beim Start eines Senders. 0 behält die Lautstärke des Lautsprechers. |
| HLS-Streams ausblenden | boolean | Nein | Viele DLNA-Lautsprecher spielen keine HLS-Streams (.m3u8): aktiviert lassen, außer alle Lautsprecher sind Google Cast. |
| MP3-Streams bevorzugen | boolean | Nein | Spielt die MP3-Version eines Senders, wenn es sie gibt: Manche Lautsprecher (Android TV, ältere DLNA-Renderer) spielen keine AAC- oder Ogg-Streams. Der Original-Stream bleibt der Ersatz. |
| Lautsprecher | section | Nein | Gladys sucht die Lautsprecher in Ihrem lokalen Netzwerk. Der Lautsprecher lädt den Stream selbst: Kein Ton läuft über Gladys. |
| Google-Cast-Lautsprecher | boolean | Nein | Chromecast, Google Nest, Android TV und Lautsprecher mit integriertem Chromecast. |
| Sonos- und UPnP/DLNA-Lautsprecher | boolean | Nein | Sonos, Netzwerk-Receiver, Smart-TVs, Kodi und andere DLNA-Renderer. |
| Manuell hinzugefügte Lautsprecher | string | Nein | Für einen Lautsprecher, den die Suche nicht findet: die IP-Adresse eines Sonos- oder Google-Cast-Geräts oder die URL einer UPnP-Beschreibung. Mehrere Einträge mit Kommas trennen. |
So installierst du RadioPlayer in Gladys
- Öffne in Gladys Integrationen: RadioPlayer erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-radioplayer:1.2.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-RadioPlayer.
RadioPlayer benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
RadioPlayer ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation