Intégration domotique RadioPlayer, gratuite et open source

Écoutez les radios web de votre pays sur vos enceintes Google Cast, Sonos et DLNA.

• Publiée par gboulvin
• Appareils
• Version 1.2.1
• Nécessite Gladys >=5.3.0
• ★ 0

Voir sur GitHubToutes les intégrations

Écoutez les radios web de votre pays sur les enceintes de la maison — Google Cast, Sonos et UPnP/DLNA — depuis Gladys : le tableau de bord, le panneau musique, les widgets et les scènes.

Les stations viennent de Radio Browser, un annuaire communautaire libre et gratuit de plus de 50 000 radios web. Le catalogue est celui du pays que vous choisissez : ses radios les plus écoutées, ses genres et sa recherche.

Prérequis

• Gladys Assistant 5.3.0 ou plus récent.
• Un accès Internet pour Gladys (le catalogue) et pour les enceintes (elles téléchargent le flux elles-mêmes).
• Des enceintes sur le même réseau local que Gladys.

Pas de compte, pas de clé d'API. Aucun son ne passe par Gladys : l'intégration indique à l'enceinte quel flux jouer, l'enceinte le joue.

Où l'utiliser

Le catalogue de 20 pays, regroupés en 6 zones. L'intégration s'installe partout, mais le catalogue de Gladys la propose dans ces pays.

Zone	Pays (stations au catalogue, novembre 2026)
Europe de l'Ouest	France (3 500+), Belgique (590+), Luxembourg (35), Pays-Bas (1 450+), Royaume-Uni (2 300+), Irlande (230+)
Europe centrale	Allemagne (6 300+), Suisse (650+), Autriche (360+)
Europe du Sud	Espagne (1 450+), Portugal (380+), Italie (1 800+)
Amérique du Nord	Canada (1 550+), États-Unis (7 800+)
Amérique latine	Mexique (2 800+), Argentine (1 150+), Chili (590+), Colombie (740+), Pérou (310+)
Océanie	Australie (1 800+)

L'écran de configuration, la documentation et les messages existent en français, anglais, allemand et espagnol.

Démarrer en 3 étapes

1. Onglet Configuration : choisissez le pays du catalogue et enregistrez.
2. Onglet Découverte de l'intégration : vos enceintes y sont listées, ajoutez celles que vous voulez. La liste est vide ? Revenez dans l'onglet Configuration et utilisez Rechercher les enceintes : il relance la recherche et indique ce que chaque canal (Google Cast, Sonos/DLNA) a répondu.
3. Écoutez : utilisez Lancer une radio maintenant dans l'onglet Configuration (choisissez une enceinte, tapez un nom de station), ou la boîte Musique du tableau de bord, les widgets RadioPlayer ou les scènes.

Enceintes compatibles

Famille	Exemples	Trouvées par
Google Cast	Chromecast, Chromecast Audio, Google Home / Nest, Android TV, enceintes avec Chromecast intégré (JBL, Sony, Bose, Marshall…)	mDNS
Sonos	Toutes les enceintes Sonos (S1 et S2)	SSDP
UPnP / DLNA	Amplis réseau (Denon, Marantz, Yamaha, Onkyo, Pioneer), téléviseurs, Freebox Player, Kodi, BubbleUPnP…	SSDP

Une Android TV, ou une enceinte avec Chromecast intégré, répond souvent aussi comme lecteur DLNA, bien moins compatible avec les flux : un tel appareil n'est gardé qu'une fois, en Google Cast. Un doublon créé avec une version précédente peut être supprimé de la liste des appareils.

Une enceinte que la recherche ne voit pas (autre sous-réseau, box qui filtre le multicast) peut être ajoutée à la main, voir plus bas.

Configuration

1. Ouvrez l'onglet Configuration de l'intégration.
2. Choisissez le pays du catalogue.
3. Si besoin :
   • Volume au démarrage — le volume réglé au lancement d'une station (0 garde le volume de l'enceinte) ;
   • Préférer les flux MP3 (activé par défaut) — lit la version MP3 d'une station quand elle existe : Android TV refuse les flux AAC bruts (« Format de fichier incompatible »), les anciens lecteurs DLNA refusent l'AAC ou l'Ogg. Le flux d'origine reste le secours ; si une enceinte abandonne un flux, le suivant est essayé automatiquement ;
   • Masquer les flux HLS — beaucoup d'enceintes DLNA ne lisent pas les flux HLS (.m3u8) : laissez activé, sauf si toutes vos enceintes sont Google Cast ;
   • Enceintes Google Cast / Enceintes Sonos et UPnP/DLNA — désactivez une famille que vous n'utilisez pas ;
   • Enceintes ajoutées à la main — l'adresse IP d'une Sonos ou d'un appareil Google Cast (ex. 192.168.1.20 : une Sonos est reconnue toute seule, toute autre IP est traitée comme Google Cast), ou l'URL de la description UPnP d'un autre lecteur DLNA, séparées par des virgules.
4. Enregistrez, ouvrez l'onglet Découverte et ajoutez vos enceintes.

Boutons de l'écran de configuration

• Rechercher les enceintes — scanne le réseau maintenant et indique ce qu'il a trouvé.
• Lancer une radio maintenant — lance une station sur l'une de vos enceintes.
• Tester le catalogue des radios — le nombre de stations et les cinq plus écoutées de votre pays.
• Tester une enceinte — vérifie qu'une enceinte répond, et son volume.
• Ajouter / Retirer / Lister les favoris.

Les intégrations d'enceintes natives de Gladys

Gladys fournit aussi des intégrations natives Sonos, Google Cast et AirPlay. Elles ne jouent que les notifications vocales (synthèse vocale), et Gladys ne permet pas à une autre intégration de piloter leurs appareils. RadioPlayer trouve et pilote donc les enceintes lui-même ; une enceinte peut être à la fois un appareil natif et un appareil RadioPlayer. Les appareils RadioPlayer sont des lecteurs de musique Gladys : ils utilisent la boîte Musique intégrée au tableau de bord (lecture en cours, navigation, recherche) et l'action de scène native « lire un média ».

Écouter

Chaque enceinte est un lecteur de musique Gladys :

• le panneau musique du tableau de bord parcourt le catalogue : Favoris, Top des radios de votre pays, Genres (info, talk, pop, rock, années 60-80, jazz, classique, électro, hip-hop, sport, enfants) et Écoutées récemment, et cherche une station par son nom ;
• la carte de l'appareil propose lecture / pause / arrêt, le volume, la sourdine et station suivante / précédente : elles passent d'un favori à l'autre (dès deux favoris), sinon d'une radio du top à l'autre ;
• la liste Station de radio de l'appareil propose vos favoris (★) en premier, puis le top des radios de votre pays, pour en lancer une en un geste.

Favoris

Jusqu'à 30 favoris, communs à toutes les enceintes :

• le bouton Choisir du widget Radio en cours ouvre la liste des stations (favoris en tête, puis le top) : choisissez une station, et cochez Ajouter aux favoris pour la mettre en favori en même temps (choisissez la station en cours pour la mettre en favori sans la relancer) ;
• les boutons Ajouter un favori, Retirer un favori et Lister les favoris de l'écran de configuration prennent un nom de station.

Widgets du tableau de bord

• Radio en cours — la station d'une enceinte, son logo, ses genres et la qualité du flux, et les boutons Précédente, Arrêter / Lancer, Suivante et Choisir. La ligne Flux indique (secours) en orange quand l'enceinte a abandonné le flux MP3 préféré et joue le flux d'origine.
• Radios préférées — vos trois premiers favoris en boutons à un geste pour une enceinte (ou jusqu'à trois stations saisies dans les réglages du widget), et un bouton Arrêter.
• Top des radios — les stations les plus écoutées du pays (ou d'un genre), en grille d'affiches avec un lien vers leur site.

Scènes

Déclencheurs (catégorie Intégrations de l'éditeur de scènes). Choisissez éventuellement l'enceinte ; laissé vide, toute enceinte convient.

Déclencheur	Quand	Variables
Radio lancée	une enceinte se met à jouer (depuis Gladys, son appli, ses boutons)	player, station, station_uuid
Radio arrêtée	une enceinte s'arrête, ou le flux s'est interrompu	player, station, station_uuid
Enceinte injoignable	une enceinte ne répond plus sur le réseau	player

Utilisez-les dans les actions suivantes avec {{triggerEvent.data.station}}. Un lancement ou un arrêt provoqué par une action de scène RadioPlayer ne déclenche rien : une scène ne peut jamais boucler sur elle-même.

Actions

Action	Paramètres	Sorties
Lancer une radio	enceinte, nom de la station, volume	started, station_name, station_uuid
Lancer un favori	enceinte, position (1 = le premier), volume	started, station_name, station_uuid
Station suivante	enceinte	started, station_name, station_uuid
Arrêter la radio	enceinte	stopped

Une station introuvable n'est pas une erreur : started vaut false, utilisez-le dans une condition. Le champ station accepte les variables de scène.

Exemple — un radio-réveil : Chaque jour de semaine à 7 h → Lancer une radio « France Inter » sur l'enceinte de la chambre à 20 % → Attendre 1 heure → Arrêter la radio.

Limites

• Sonos : lancez la radio sur le coordinateur d'un groupe (l'enceinte qui le pilote).
• Formats : une station publiée uniquement en AAC ou Ogg, sans version MP3, peut ne pas jouer sur une Android TV ou un ancien lecteur DLNA : les logs indiquent quel flux a été refusé. Choisissez une autre station, ou une autre fiche de la même radio dans le catalogue.
• Les vieux lecteurs DLNA peuvent refuser les flux https ou l'AAC : choisissez une autre station, ou un autre flux de la même radio.
• Les flux HLS (.m3u8) ne sont lus que par Google Cast ; ils sont masqués tant que Masquer les flux HLS est activé.
• Le titre du morceau diffusé n'est pas affiché : le nom de la station, ses genres et la qualité du flux le sont.

Dépannage

• Aucune enceinte dans Découverte : utilisez Rechercher les enceintes dans l'onglet Configuration et lisez le rapport. 0 réponse(s) sur un canal signifie que les enceintes n'ont pas répondu à la recherche réseau : vérifiez qu'elles sont allumées et sur le même réseau que Gladys (pas de Wi-Fi invité, pas de VLAN séparé), ou ajoutez-les par leur IP dans Enceintes ajoutées à la main. Une erreur en donne la cause.
• « Le catalogue des radios est injoignable » : Gladys n'a pas accès à Internet, ou Radio Browser est en panne (l'intégration essaie tous les serveurs Radio Browser).
• Une station ne démarre pas : utilisez Tester une enceinte, puis essayez une autre station ; le flux est peut-être hors ligne.
• L'intégration journalise tout ce qu'elle fait : ouvrez ses logs dans Gladys (LOG_LEVEL=debug pour le détail complet).

Vie privée

L'intégration envoie à Radio Browser les recherches et les stations écoutées (anonymement, sans compte). Les favoris et les dernières stations écoutées restent dans le volume de données de l'intégration, sur votre Gladys. Rien d'autre ne quitte votre réseau.

RadioPlayer est un projet indépendant, sans lien avec Radio Browser, Google, Sonos ou Radioplayer Worldwide.

Paramètres de configuration

Voici les paramètres demandés par RadioPlayer dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Comment démarrer	section	Non	1. Choisissez le pays du catalogue ci-dessous et enregistrez. 2. Ouvrez l'onglet Découverte de cette intégration et ajoutez vos enceintes (Google Cast, Sonos, DLNA) ; rien n'apparaît ? Utilisez « Rechercher les enceintes » en bas de cette page. 3. Écoutez : « Lancer une radio maintenant » ci-dessous, la boîte Musique ou les widgets RadioPlayer du tableau de bord, ou les scènes. Un accès Internet est nécessaire pour le catalogue et les flux.
Pays du catalogue	select	Oui	Les stations proposées sont celles de ce pays.
Volume au démarrage (%)	number	Non	Volume réglé au lancement d'une station. 0 garde le volume de l'enceinte.
Masquer les flux HLS	boolean	Non	Beaucoup d’enceintes DLNA ne lisent pas les flux HLS (.m3u8) : laissez activé sauf si toutes vos enceintes sont Google Cast.
Préférer les flux MP3	boolean	Non	Lit la version MP3 d'une station quand elle existe : certaines enceintes (Android TV, anciens lecteurs DLNA) ne lisent pas les flux AAC ou Ogg. Le flux d'origine reste le secours.
Enceintes	section	Non	Gladys cherche les enceintes sur votre réseau local. L’enceinte télécharge le flux elle-même : aucun son ne passe par Gladys.
Enceintes Google Cast	boolean	Non	Chromecast, Google Nest, Android TV et enceintes avec Chromecast intégré.
Enceintes Sonos et UPnP/DLNA	boolean	Non	Sonos, amplis réseau, téléviseurs, Freebox Player, Kodi et autres lecteurs DLNA.
Enceintes ajoutées à la main	string	Non	Pour une enceinte que la recherche ne trouve pas : l'adresse IP d'une Sonos ou d'un appareil Google Cast, ou l'URL d'une description UPnP. Séparez plusieurs entrées par des virgules.

Comment installer RadioPlayer dans Gladys

1. Dans Gladys, ouvrez Intégrations : RadioPlayer apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/gboulvin/gladys-radioplayer:1.2.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/gboulvin/Gladys-RadioPlayer.

RadioPlayer nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

RadioPlayer est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par gboulvin, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂