Saltar al contenido principal

Integración domótica RadioPlayer, gratuita y de código abierto

Integración RadioPlayer para Gladys Assistant

Escuche las radios web de su país en sus altavoces Google Cast, Sonos y DLNA.

Escuche las radios web de su país en los altavoces de su casa — Google Cast, Sonos y UPnP/DLNA — desde Gladys: el panel, el panel de música, los widgets y las escenas.

Las emisoras vienen de Radio Browser, un directorio comunitario libre y gratuito de más de 50 000 radios web. El catálogo es el del país que elija: sus emisoras más escuchadas, sus géneros y su búsqueda.

Requisitos​

  • Gladys Assistant 5.3.0 o posterior.
  • Acceso a Internet para Gladys (el catálogo) y para los altavoces (descargan el flujo por sí mismos).
  • Altavoces en la misma red local que Gladys.

Sin cuenta ni clave de API. Ningún sonido pasa por Gladys: la integración indica al altavoz qué flujo reproducir.

Dónde funciona​

El catálogo de 20 países, agrupados en 6 zonas. La integración se instala en cualquier lugar, pero el catálogo de Gladys la muestra en estos países.

ZonaPaíses (emisoras en el catálogo, noviembre de 2026)
Europa occidentalFrancia (3500+), Bélgica (590+), Luxemburgo (35), Países Bajos (1450+), Reino Unido (2300+), Irlanda (230+)
Europa centralAlemania (6300+), Suiza (650+), Austria (360+)
Europa del surEspaña (1450+), Portugal (380+), Italia (1800+)
América del NorteCanadá (1550+), Estados Unidos (7800+)
América LatinaMéxico (2800+), Argentina (1150+), Chile (590+), Colombia (740+), Perú (310+)
OceaníaAustralia (1800+)

La configuración, la documentación y los mensajes están en español, inglés, francés y alemán.

Empezar en 3 pasos​

  1. Pestaña Configuración: elija el país del catálogo y guarde.
  2. Pestaña Descubrimiento de la integración: ahí aparecen sus altavoces, añada los que quiera. ¿La lista está vacía? Vuelva a Configuración y pulse Buscar altavoces: repite la búsqueda e indica lo que respondió cada canal (Google Cast, Sonos/DLNA).
  3. Escuche: pulse Reproducir una emisora ahora en Configuración (elija un altavoz, escriba una emisora), o use la caja Música del panel, los widgets RadioPlayer o las escenas.

Altavoces compatibles​

FamiliaEjemplosEncontrados por
Google CastChromecast, Chromecast Audio, Google Home / Nest, Android TV, altavoces con Chromecast integrado (JBL, Sony, Bose, Marshall…)mDNS
SonosTodos los altavoces Sonos (S1 y S2)SSDP
UPnP / DLNAReceptores de red (Denon, Marantz, Yamaha, Onkyo, Pioneer), televisores, Kodi, BubbleUPnP…SSDP

Una Android TV, o un altavoz con Chromecast integrado, suele responder también como reproductor DLNA, mucho menos compatible con los flujos: ese dispositivo se conserva una sola vez, como Google Cast. Un duplicado creado con una versión anterior puede borrarse de la lista de dispositivos.

Un altavoz que la búsqueda no ve (otra subred, un router que filtra el multicast) puede añadirse a mano, ver más abajo.

Configuración​

  1. Abra la pestaña Configuración de la integración.
  2. Elija el país del catálogo.
  3. Opcionalmente:
    • Volumen inicial — el volumen al iniciar una emisora (0 mantiene el del altavoz);
    • Preferir flujos MP3 (activado por defecto) — reproduce la versión MP3 de una emisora si existe: Android TV rechaza los flujos AAC en bruto («Formato de archivo incompatible») y los reproductores DLNA antiguos el AAC u Ogg. El flujo original queda como reserva; si un altavoz abandona un flujo, se prueba el siguiente automáticamente;
    • Ocultar flujos HLS — muchos altavoces DLNA no reproducen flujos HLS (.m3u8): déjelo activado salvo que todos sus altavoces sean Google Cast;
    • Altavoces Google Cast / Altavoces Sonos y UPnP/DLNA — desactive una familia que no use;
    • Altavoces añadidos a mano — la dirección IP de un Sonos o de un dispositivo Google Cast (p. ej. 192.168.1.20: un Sonos se reconoce solo, cualquier otra IP se trata como Google Cast) o la URL de la descripción UPnP de otro reproductor DLNA, separadas por comas.
  4. Guarde, abra la pestaña Descubrimiento y añada sus altavoces.

Botones de la configuración​

  • Buscar altavoces — busca ahora en la red e indica lo encontrado.
  • Reproducir una emisora ahora — reproduce una emisora en uno de sus altavoces.
  • Probar el catálogo de radios — el número de emisoras y las cinco más escuchadas de su país.
  • Probar un altavoz — comprueba que un altavoz responde, y su volumen.
  • Añadir / Quitar / Ver los favoritos.

Las integraciones de altavoces nativas de Gladys​

Gladys incluye también integraciones nativas Sonos, Google Cast y AirPlay. Solo reproducen avisos de voz (síntesis de voz), y Gladys no permite que otra integración controle sus dispositivos. Por eso RadioPlayer encuentra y controla los altavoces por sí mismo; un altavoz puede ser a la vez un dispositivo nativo y un dispositivo RadioPlayer. Los dispositivos RadioPlayer son reproductores de música de Gladys: usan la caja Música integrada en el panel (sonando ahora, explorar, buscar) y la acción de escena nativa «reproducir un medio».

Escuchar​

Cada altavoz es un reproductor de música de Gladys:

  • el panel de música recorre el catálogo: Favoritos, Emisoras top de su país, Géneros (noticias, tertulias, pop, rock, clásicos, jazz, clásica, electrónica, hip-hop, deportes, infantil) y Escuchadas recientemente, y busca una emisora por su nombre;
  • la tarjeta del dispositivo ofrece reproducir / pausa / detener, el volumen, silencio y emisora siguiente / anterior: pasan de un favorito a otro (a partir de dos favoritos) o de una emisora del top a otra;
  • la lista Emisora de radio del dispositivo muestra primero sus favoritos (★) y luego el top de su país, para lanzar una con un toque.

Favoritos​

Hasta 30 favoritos, comunes a todos los altavoces:

  • el botón Elegir del widget Radio – sonando abre la lista de emisoras (favoritos primero, luego el top): elija una emisora y marque Añadir a favoritos para marcarla a la vez (elija la emisora que suena para marcarla sin reiniciarla);
  • los botones Añadir un favorito, Quitar un favorito y Ver los favoritos de la configuración toman un nombre de emisora.

Widgets del panel​

  • Radio – sonando — la emisora de un altavoz, su logo, sus géneros y la calidad del flujo, con Anterior, Detener / Reproducir, Siguiente y Elegir. La fila Flujo indica (reserva) en naranja cuando el altavoz abandonó el flujo MP3 preferido y reproduce el original.
  • Radios favoritas — sus tres primeros favoritos como botones de un toque para un altavoz (o hasta tres emisoras escritas en los ajustes del widget), y un botón Detener.
  • Top de radios — las emisoras más escuchadas del país (o de un género), en cuadrícula con un enlace a su sitio web.

Escenas​

Disparadores (categoría Integraciones del editor de escenas). Elija opcionalmente el altavoz; vacío, vale cualquiera.

DisparadorCuándoVariables
Radio iniciadaun altavoz empieza a sonar (desde Gladys, su app, sus botones)player, station, station_uuid
Radio detenidaun altavoz se detiene o el flujo se cortaplayer, station, station_uuid
Altavoz inaccesibleun altavoz ya no responde en la redplayer

Úselas en las acciones siguientes con {{triggerEvent.data.station}}. Un inicio o una parada causados por una acción de escena de RadioPlayer no disparan nada: una escena nunca puede entrar en bucle.

Acciones

AcciónParámetrosSalidas
Reproducir una emisoraaltavoz, nombre de la emisora, volumenstarted, station_name, station_uuid
Reproducir un favoritoaltavoz, posición (1 = el primero), volumenstarted, station_name, station_uuid
Emisora siguientealtavozstarted, station_name, station_uuid
Detener la radioaltavozstopped

Una emisora no encontrada no es un error: started vale false, úselo en una condición. El campo emisora acepta variables de escena.

Ejemplo — un radio-despertador: Cada día laborable a las 7:00 → Reproducir una emisora «Cadena SER» en el dormitorio al 20 % → Esperar 1 hora → Detener la radio.

Límites​

  • Sonos: reproduzca en el coordinador de un grupo.
  • Formatos: una emisora publicada solo en AAC u Ogg, sin versión MP3, puede no sonar en una Android TV o un reproductor DLNA antiguo: los logs indican qué flujo se rechazó. Elija otra emisora u otra ficha de la misma radio en el catálogo.
  • Los reproductores DLNA antiguos pueden rechazar flujos https o AAC: elija otra emisora u otro flujo de la misma radio.
  • Los flujos HLS (.m3u8) solo suenan en Google Cast; están ocultos mientras Ocultar flujos HLS esté activado.
  • No se muestra el título de la canción: sí el nombre de la emisora, sus géneros y la calidad del flujo.

Solución de problemas​

  • Ningún altavoz en Descubrimiento: pulse Buscar altavoces en Configuración y lea el informe. 0 respuesta(s) en un canal significa que los altavoces no respondieron a la búsqueda en red: compruebe que están encendidos y en la misma red que Gladys (sin wifi de invitados ni VLAN separada), o añádalos por IP en Altavoces añadidos a mano. Un error indica la causa.
  • «El catálogo de radios no es accesible»: Gladys no tiene Internet o Radio Browser no responde (la integración prueba todos sus servidores).
  • Una emisora no arranca: use Probar un altavoz y pruebe otra emisora; el flujo puede estar fuera de línea.
  • La integración registra todo lo que hace: abra sus logs en Gladys (LOG_LEVEL=debug para todo el detalle).

Privacidad​

La integración envía a Radio Browser las búsquedas y las emisoras reproducidas (de forma anónima, sin cuenta). Los favoritos y las últimas emisoras quedan en el volumen de datos de la integración, en su Gladys. Nada más sale de su red.

RadioPlayer es un proyecto independiente, sin relación con Radio Browser, Google, Sonos ni Radioplayer Worldwide.

Parámetros de configuración​

Estos son los parámetros que RadioPlayer te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Cómo empezarsectionNo1. Elija abajo el país del catálogo y guarde. 2. Abra la pestaña Descubrimiento de esta integración y añada sus altavoces (Google Cast, Sonos, DLNA); ¿no aparece nada? Pulse «Buscar altavoces» al final de esta página. 3. Escuche: «Reproducir una emisora ahora» abajo, la caja Música o los widgets RadioPlayer del panel, o las escenas. Se necesita acceso a Internet para el catálogo y los flujos.
País del catálogoselectSíLas emisoras ofrecidas son las de este país.
Volumen inicial (%)numberNoVolumen al iniciar una emisora. 0 mantiene el volumen del altavoz.
Ocultar flujos HLSbooleanNoMuchos altavoces DLNA no reproducen flujos HLS (.m3u8): déjelo activado salvo que todos sean Google Cast.
Preferir flujos MP3booleanNoReproduce la versión MP3 de una emisora si existe: algunos altavoces (Android TV, reproductores DLNA antiguos) no reproducen flujos AAC u Ogg. El flujo original queda como reserva.
AltavocessectionNoGladys busca los altavoces en su red local. El altavoz descarga el flujo por sí mismo: ningún sonido pasa por Gladys.
Altavoces Google CastbooleanNoChromecast, Google Nest, Android TV y altavoces con Chromecast integrado.
Altavoces Sonos y UPnP/DLNAbooleanNoSonos, receptores de red, televisores, Kodi y otros reproductores DLNA.
Altavoces añadidos a manostringNoPara un altavoz que la búsqueda no encuentra: la dirección IP de un Sonos o de un dispositivo Google Cast, o la URL de una descripción UPnP. Separe varias entradas con comas.

Cómo instalar RadioPlayer en Gladys​

  1. En Gladys, abre Integraciones: RadioPlayer aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/gboulvin/gladys-radioplayer:1.2.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-RadioPlayer.

RadioPlayer requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

RadioPlayer es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂