Radio Browser Smart-Home-Integration, kostenlos und Open Source
Webradios aus aller Welt aus dem freien Radio-Browser-Verzeichnis: Favoriten, Logos, Streams.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Webradios aus aller Welt in Gladys, aus Radio Browser, einem freien Verzeichnis von rund 50.000 Sendern, das von Freiwilligen betrieben wird. Diese Integration ist nicht mit radio-browser.info verbunden.
Was die Integration macht
- Suchen im Verzeichnis nach Name, Land, Sprache oder Genre, im Tab „Konfiguration“ der Integration.
- Deine Lieblingssender behalten: jeder Favorit wird ein Gerät in Gladys, mit dem Status seines Streams, seiner Bitrate, seinem Codec und der Stream-Adresse.
- Auf dem Dashboard zeigen, mit Logo, im Widget Lieblingsradios.
- In Szenen nutzen: die Szenenaktionen Stream eines Radios holen und Zufälliges Radio wählen geben die Stream-Adresse an den Player deiner Wahl weiter (zum Beispiel die DLNA-Integration).
Gladys erlaubt einer Integration noch nicht, den Player einer anderen Integration zu starten: ein Radio abzuspielen braucht daher zwei Aktionen in einer Szene (siehe Beispielszenen).
Bevor du anfängst
- Gladys 5.1.0 oder neuer.
- Internetzugang auf dem Rechner, auf dem Gladys läuft. Kein Konto, kein Schlüssel.
- Um ein Radio zu hören: eine Integration, deren Player in einer Szene eine URL abspielen kann, wie die DLNA-Integration (Aktion „URL auf einem DLNA-Gerät abspielen“).
Konfiguration
Öffne den Tab Konfiguration der Integration.
- Sprache der Namen und Meldungen: die Sprache der Funktionsnamen der ab jetzt hinzugefügten Sender (Gladys behält sie, sobald ein Gerät hinzugefügt ist) und der Fehlermeldungen der Szenenaktionen. Standardmäßig Französisch.
- Aktualisierungsintervall (Minuten): wie oft die Favoriten erneut aus Radio Browser gelesen werden, standardmäßig alle 60 Minuten (15 bis 360).
Sender finden und hinzufügen
Die Favoriten verwaltest du mit den Aktionen unten im Tab „Konfiguration“ (klicke unter jeder auf Ausführen):
- Sender suchen: fülle ein oder mehrere Felder aus, zum Beispiel den
Namen
FIP, oder das Genrejazzund das LandDE. Das Land ist ein englischer Name (Germany,Austria) oder ein Code aus zwei Buchstaben; die Sprache wird auf Englisch geschrieben (german,french). Die 10 meistgehörten funktionierenden Sender werden aufgelistet, jeder mit einer Nummer. Sender, die schon in deinen Favoriten sind, tragen ein ★. - Zu Favoriten hinzufügen: gib die Nummer eines Ergebnisses der letzten Suche ein (oder die Kennung, UUID, eines Senders, oder seine Adresse auf radio-browser.info). Du kannst ihm einen anderen Namen geben. Bis zu 50 Favoriten.
- Öffne den Tab Entdecken: der Sender ist da. Klicke auf Zu Gladys hinzufügen.
- Favoriten anzeigen listet sie nummeriert auf und zeigt, ob sie zu Gladys hinzugefügt wurden.
- Favorit entfernen nimmt seine Nummer aus dieser Liste, seinen Namen oder seine UUID. Sein Gerät bleibt in Gladys: lösche es im Tab Geräte, wenn du es nicht mehr willst.
Die Favoriten werden im Datenordner der Integration gespeichert, mit ihren letzten bekannten Angaben: Dashboard und Szenen funktionieren weiter, wenn das Verzeichnis nicht erreichbar ist.
Die Sender-Geräte
Jeder zu Gladys hinzugefügte Favorit ist ein Gerät mit dem Namen des Senders und vier schreibgeschützten Funktionen:
| Funktion | Was sie anzeigt |
|---|---|
| Stream online | An, wenn die letzte Prüfung des Streams durch Radio Browser erfolgreich war, Aus, wenn sie fehlschlug oder der Sender das Verzeichnis verlassen hat |
| Bitrate | In kbit/s, wie vom Sender angegeben (nicht gesendet, wenn unbekannt) |
| Codec | MP3, AAC, OGG... |
| Stream-Adresse | Die Adresse, die du einem Player gibst |
Land, Sprache, Genres, Webseite und Logo-Adresse werden als Geräteparameter gespeichert. Das Gerät wird von der Integration selbst aktualisiert, im Intervall der Konfiguration.
Das Widget „Lieblingsradios“
Füge das Widget Lieblingsradios zu einem Dashboard hinzu. Es zeigt deine Favoriten mit Logo, Land, Codec und Bitrate und einem grünen Abzeichen Online oder einem roten Offline. Tippe auf einen Sender, um seine Sprache, seine Genres und Links zu seiner Webseite zu sehen und, wenn der Stream sicher ist (https), zum Stream selbst: dein Browser spielt ihn in einem neuen Tab ab.
Einstellungen:
- Angezeigte Sender: wähle einige der zu Gladys hinzugefügten Sender in der gewünschten Reihenfolge; leer zeigt alle Favoriten (höchstens 12).
- Darstellung: ein Logo-Raster oder eine Liste (höchstens 8).
Das Widget hat keine „Abspielen“-Taste: Gladys erlaubt einer Integration noch nicht, den Player einer anderen Integration zu starten.
Szenenauslöser und Szenenaktionen
Die Integration meldet keinen Szenenauslöser an: ein Sender, der offline geht, ist der Status seiner Funktion Stream online, die der Auslöser „Gerätestatus geändert“ von Gladys schon abdeckt.
Stream eines Radios holen
Wähle einen Lieblingssender. Die Aktion gibt den folgenden Aktionen der Szene:
- Stream-Adresse: für die Aktion „URL abspielen“ eines Players;
- Sendername, Codec, Bitrate (kbit/s);
- Stream online: die letzte Prüfung des Streams durch Radio Browser war erfolgreich;
- HLS-Stream (.m3u8): viele Netzwerkplayer können solche nicht abspielen.
Die Aktion zählt außerdem ein Anhören in Radio Browser, wie es das Verzeichnis verlangt. Wenn das Verzeichnis nicht antwortet, wird trotzdem die letzte bekannte Stream-Adresse weitergegeben.
Zufälliges Radio wählen
Ein zufälliger funktionierender Sender eines Genres, eines Landes und/oder einer Sprache (gleiche Regeln wie bei der Suche). Er gibt die gleichen Werte wie oben.
Im Szeneneditor erscheinen die Werte einer Aktion in der Variablenauswahl der
folgenden Aktionen, als {{0.0.stream_url}} für die erste Aktion des ersten
Blocks.
Beispielszenen
Mit FIP aufwachen (mit der DLNA-Integration):
- Auslöser: Uhrzeit, 7:00, Montag bis Freitag.
- Aktion: Stream eines Radios holen, Sender FIP.
- Nächster Block, Aktion: URL auf einem DLNA-Gerät abspielen, Gerät im
Schlafzimmer, URL
{{0.0.stream_url}}, Titel{{0.0.name}}, Lautstärke 20.
Ein zufälliges Jazzradio am Sonntagmorgen:
- Auslöser: Uhrzeit, 10:00, Sonntag.
- Aktion: Zufälliges Radio wählen, Genre
jazz. - Nächster Block, Aktion: URL auf einem DLNA-Gerät abspielen, URL
{{0.0.stream_url}}, Titel{{0.0.name}}.
Benachrichtigt werden, wenn dein Lieblingssender ausfällt:
- Auslöser: Gerätestatus geändert, Funktion Stream online des Senders, gleich 0.
- Aktion: Nachricht senden: „FIP ist in Radio Browser offline“.
Fehlerbehebung
- „Radio Browser ist nicht erreichbar“ im Tab „Konfiguration“: prüfe, ob der Gladys-Rechner Internetzugang hat. Das Verzeichnis läuft auf Servern, die Freiwillige betreiben: die Integration versucht den nächsten Server und bei der nächsten Aktualisierung erneut. Die Favoriten behalten so lange ihre letzten bekannten Angaben.
- Ein Sender ist offline, spielt aber: der Status ist die letzte Prüfung des Streams durch das Verzeichnis, etwa einmal am Tag. Er folgt bei der Aktualisierung nach einer neuen Prüfung.
- Kein Logo: in einem Gladys-Widget können nur PNG-, JPEG- und WebP-Logos bis 300 KB angezeigt werden; viele Sender veröffentlichen ein Icon (.ico) oder eine SVG-Datei.
- Der Player spielt den Stream nicht ab: probiere eine andere Version des Senders (eine in MP3 statt AAC, oder http statt https) und meide HLS-Streams (.m3u8).
- Der Sender ist nicht im Tab „Entdecken“: starte Favoriten anzeigen und öffne dann den Tab „Entdecken“ erneut.
- Ausführliche Logs: setze die Variable
LOG_LEVELaufdebug. Die Logs enthalten nie die Stream-Adressen.
Wie die Integration Radio Browser nutzt
Radio Browser ist kostenlos und wird von Freiwilligen betrieben. Die Integration hält sich an seine Regeln:
- eine einzige Anfrage für alle deine Favoriten bei jeder Aktualisierung (standardmäßig alle 60 Minuten, höchstens alle 15 Minuten); eine Suche nur, wenn du sie startest;
- ein zufällig gewählter Server unter denen, die das Verzeichnis ankündigt (DNS), dann der nächste, wenn er ausfällt;
- ein eindeutiger
User-Agent:gladys-radio-browser/<version>; - die vom Verzeichnis aufgelöste Stream-Adresse (
url_resolved); - ein gezähltes Anhören, jedes Mal wenn eine Szenenaktion einen Sender startet, damit die Beliebtheit der Sender aussagekräftig bleibt (das Verzeichnis zählt eines pro Tag und Adresse).
Radio Browser veröffentlicht kein Kontingent. Die Logos werden direkt von den Webseiten der Sender geladen, die dann die Internetadresse deines Zuhauses sehen.
Grenzen
- Kein direktes Abspielen: Gladys 5.2 erlaubt weder einer Integration, ein Gerät einer anderen Integration zu steuern, noch per Szenenaktion eine Adresse auf den Lautsprechern des Kerns abzuspielen (Sonos, AirPlay, Google Cast: ihr „Benachrichtigung abspielen“ spielt nur einen gesprochenen Text und hört nach einigen Sekunden oder Minuten auf). Die Stream-Adresse geht deshalb über eine Szene an den Player einer Integration, die eine annimmt, wie DLNA.
- Höchstens 50 Favoriten; das Widget zeigt 12 davon (8 als Liste).
- Der Stream-Status ist der vom Verzeichnis geprüfte, keine Live-Prüfung.
- Funktionsnamen bleiben in der Sprache, in der sie hinzugefügt wurden.
- Einen Favoriten zu entfernen löscht sein Gerät nicht.
- Entwickelt ohne direkte Verbindung zum Verzeichnis, mit aufgezeichneten Antworten seiner API: Rückmeldungen sind willkommen im GitHub-Repository.
Konfigurationseinstellungen
Diese Einstellungen fragt Radio Browser in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Radio Browser ist ein freies Verzeichnis von rund 50.000 Webradios, betrieben von Freiwilligen: kein Konto, kein Schlüssel. Finde einen Sender mit der Aktion „Sender suchen“ unten und füge ihn dann mit „Zu Favoriten hinzufügen“ und seiner Nummer hinzu. Jeder Favorit erscheint dann im Tab „Entdecken“: klicke auf „Zu Gladys hinzufügen“. Diese Integration ist nicht mit radio-browser.info verbunden. |
| Ein Radio abspielen | section | Nein | Gladys erlaubt einer Integration noch nicht, den Player einer anderen Integration zu starten. Füge in einer Szene die Aktion „Stream eines Radios holen“ hinzu und danach die Aktion „URL abspielen“ deines Players (zum Beispiel der DLNA-Integration) mit der Stream-Adresse als URL. Die Dokumentation zeigt ein vollständiges Beispiel. |
| Sprache der Namen und Meldungen | select | Nein | Namen der Funktionen der ab jetzt hinzugefügten Sender (Gladys behält sie, sobald ein Gerät hinzugefügt ist) und Fehlermeldungen der Szenenaktionen. |
| Aktualisierungsintervall (Minuten) | number | Nein | Wie oft die Favoriten erneut aus Radio Browser gelesen werden (Stream-Prüfung, Bitrate, Logo), mit einer einzigen Anfrage für alle. 15 bis 360 Minuten: das Verzeichnis prüft jeden Stream etwa einmal am Tag. |
So installierst du Radio Browser in Gladys
- Öffne in Gladys Integrationen: Radio Browser erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-radio-browser:1.0.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/guim31/gladys-radio-browser.
Radio Browser benötigt Gladys >=5.1.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
Radio Browser 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 guim31 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