Zum Hauptinhalt springen

RadioPlayer Smart-Home-Integration, kostenlos und Open Source

RadioPlayer-Integration für Gladys Assistant

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.

ZoneLänder (Sender im Katalog, November 2026)
WesteuropaFrankreich (3.500+), Belgien (590+), Luxemburg (35), Niederlande (1.450+), Vereinigtes Königreich (2.300+), Irland (230+)
MitteleuropaDeutschland (6.300+), Schweiz (650+), Österreich (360+)
SüdeuropaSpanien (1.450+), Portugal (380+), Italien (1.800+)
NordamerikaKanada (1.550+), Vereinigte Staaten (7.800+)
LateinamerikaMexiko (2.800+), Argentinien (1.150+), Chile (590+), Kolumbien (740+), Peru (310+)
OzeanienAustralien (1.800+)

Konfiguration, Dokumentation und Meldungen gibt es auf Deutsch, Englisch, Französisch und Spanisch.

In 3 Schritten starten​

  1. Tab Konfiguration: Katalogland wählen und speichern.
  2. 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.
  3. 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​

FamilieBeispieleGefunden über
Google CastChromecast, Chromecast Audio, Google Home / Nest, Android TV, Lautsprecher mit Chromecast built-in (JBL, Sony, Bose, Marshall…)mDNS
SonosAlle Sonos-Lautsprecher (S1 und S2)SSDP
UPnP / DLNANetzwerk-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​

  1. Öffnen Sie den Tab Konfiguration der Integration.
  2. Wählen Sie das Katalogland.
  3. 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.
  4. 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öserWannVariablen
Radio gestartetein Lautsprecher beginnt zu spielen (Gladys, App, Tasten)player, station, station_uuid
Radio gestopptein Lautsprecher stoppt oder der Stream bricht abplayer, station, station_uuid
Lautsprecher nicht erreichbarein Lautsprecher antwortet nicht mehr im Netzwerkplayer

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

AktionParameterAusgaben
Radiosender abspielenLautsprecher, Sendername, Lautstärkestarted, station_name, station_uuid
Favorit abspielenLautsprecher, Position (1 = erster), Lautstärkestarted, station_name, station_uuid
Nächster SenderLautsprecherstarted, station_name, station_uuid
Radio stoppenLautsprecherstopped

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. Ein Fehler nennt 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=debug fü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.

EinstellungTypPflichtfeldBeschreibung
So starten SiesectionNein1. 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.
KataloglandselectJaAngeboten werden die Sender dieses Landes.
Startlautstärke (%)numberNeinLautstärke beim Start eines Senders. 0 behält die Lautstärke des Lautsprechers.
HLS-Streams ausblendenbooleanNeinViele DLNA-Lautsprecher spielen keine HLS-Streams (.m3u8): aktiviert lassen, außer alle Lautsprecher sind Google Cast.
MP3-Streams bevorzugenbooleanNeinSpielt 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.
LautsprechersectionNeinGladys sucht die Lautsprecher in Ihrem lokalen Netzwerk. Der Lautsprecher lädt den Stream selbst: Kein Ton läuft über Gladys.
Google-Cast-LautsprecherbooleanNeinChromecast, Google Nest, Android TV und Lautsprecher mit integriertem Chromecast.
Sonos- und UPnP/DLNA-LautsprecherbooleanNeinSonos, Netzwerk-Receiver, Smart-TVs, Kodi und andere DLNA-Renderer.
Manuell hinzugefügte LautsprecherstringNeinFü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​

  1. Öffne in Gladys Integrationen: RadioPlayer erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. 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).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂