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

Radios web de todo el mundo del directorio libre Radio Browser: favoritos, logotipos y flujos.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Las radios web de todo el mundo en Gladys, desde Radio Browser, un directorio libre de unas 50 000 emisoras mantenido por voluntarios. Esta integración no está afiliada a radio-browser.info.

Qué hace la integración

• Buscar en el directorio por nombre, país, idioma o género, desde la pestaña Configuración de la integración.
• Guardar sus emisoras favoritas: cada favorito se convierte en un dispositivo de Gladys, con el estado de su flujo, su tasa de bits, su códec y la dirección del flujo.
• Mostrarlas en el panel con su logotipo, en el widget Radios favoritas.
• Usarlas en escenas: las acciones de escena Obtener el flujo de una radio y Elegir una radio al azar pasan la dirección del flujo al reproductor que usted elija (por ejemplo la integración DLNA).

Gladys todavía no permite que una integración inicie el reproductor de otra integración: reproducir una radio requiere por tanto dos acciones en una escena (vea Ejemplos de escenas).

Antes de empezar

• Gladys 5.1.0 o posterior.
• Acceso a Internet desde el equipo donde funciona Gladys. Sin cuenta ni clave.
• Para escuchar una radio: una integración cuyo reproductor pueda reproducir una URL en una escena, como la integración DLNA (acción «Reproducir una URL en un reproductor DLNA»).

Configuración

Abra la pestaña Configuración de la integración.

• Idioma de los nombres y mensajes: el idioma de los nombres de las funciones de las emisoras que añada a partir de ahora (Gladys los conserva una vez añadido el dispositivo) y de los mensajes de error de las acciones de escena. Francés por defecto.
• Intervalo de actualización (minutos): con qué frecuencia se vuelven a leer los favoritos en Radio Browser, cada 60 minutos por defecto (de 15 a 360).

Buscar y añadir emisoras

Los favoritos se gestionan con las acciones de la parte inferior de la pestaña Configuración (haga clic en Ejecutar debajo de cada una):

1. Buscar una emisora: rellene uno o varios campos, por ejemplo el nombre FIP, o el género jazz y el país ES. El país es un nombre en inglés (Spain, Mexico) o un código de dos letras; el idioma se escribe en inglés (spanish, french). Se muestran las 10 emisoras en funcionamiento más escuchadas, cada una con un número. Las emisoras que ya están en sus favoritos llevan una ★.
2. Añadir a favoritos: escriba el número de un resultado de la última búsqueda (o el identificador, UUID, de una emisora, o su dirección en radio-browser.info). Puede darle otro nombre. Hasta 50 favoritos.
3. Abra la pestaña Descubrir: la emisora está ahí. Haga clic en Añadir a Gladys.
4. Ver los favoritos los muestra numerados e indica si se han añadido a Gladys.
5. Quitar un favorito acepta su número en esa lista, su nombre o su UUID. Su dispositivo permanece en Gladys: elimínelo en la pestaña Dispositivos si ya no lo quiere.

Los favoritos se guardan en la carpeta de datos de la integración, con sus últimos datos conocidos: el panel y las escenas siguen funcionando cuando el directorio no está disponible.

Los dispositivos emisora

Cada favorito añadido a Gladys es un dispositivo con el nombre de la emisora y cuatro funciones de solo lectura:

Función	Qué indica
Flujo en línea	Encendido cuando la última comprobación del flujo por Radio Browser fue correcta, Apagado cuando falló o la emisora salió del directorio
Tasa de bits	En kbit/s, tal como la anuncia la emisora (no se envía si se desconoce)
Códec	MP3, AAC, OGG...
Dirección del flujo	La dirección que debe indicar a un reproductor

El país, el idioma, los géneros, el sitio web y la dirección del logotipo se guardan como parámetros del dispositivo. La propia integración actualiza el dispositivo, con el intervalo de la configuración.

El widget «Radios favoritas»

Añada el widget Radios favoritas a un panel. Muestra sus favoritos con su logotipo, su país, su códec y su tasa de bits, y una insignia verde En línea o roja Sin conexión. Toque una emisora para ver su idioma, sus géneros y enlaces a su sitio web y, cuando el flujo es seguro (https), al propio flujo: su navegador lo reproduce en una pestaña nueva.

Ajustes:

• Emisoras mostradas: elija algunas de las emisoras añadidas a Gladys, en el orden que desee; vacío muestra todos los favoritos (12 como máximo).
• Visualización: una Cuadrícula de logotipos, o una Lista (8 como máximo).

El widget no tiene botón de «reproducir»: Gladys todavía no permite que una integración inicie el reproductor de otra integración.

Disparadores y acciones de escena

La integración no declara ningún disparador de escena: una emisora que pasa a estar sin conexión es el estado de su función Flujo en línea, que el disparador «Cambio de estado de un dispositivo» de Gladys ya cubre.

Obtener el flujo de una radio

Elija una emisora favorita. La acción entrega a las acciones siguientes de la escena:

• Dirección del flujo: para la acción «Reproducir una URL» de un reproductor;
• Nombre de la emisora, Códec, Tasa de bits (kbit/s);
• Flujo en línea: la última comprobación del flujo por Radio Browser fue correcta;
• Flujo HLS (.m3u8): muchos reproductores de red no pueden reproducirlos.

También cuenta una escucha en Radio Browser, como pide el directorio. Cuando el directorio no responde, se entrega igualmente la última dirección de flujo conocida.

Elegir una radio al azar

Una emisora en funcionamiento al azar, de un Género, un País y/o un Idioma (mismas reglas que la búsqueda). Entrega los mismos valores que arriba.

En el editor de escenas, los valores de una acción aparecen en el selector de variables de las acciones siguientes, como {{0.0.stream_url}} para la primera acción del primer bloque.

Ejemplos de escenas

Despertarse con FIP (con la integración DLNA):

1. Disparador: Hora, 7:00, de lunes a viernes.
2. Acción: Obtener el flujo de una radio, emisora FIP.
3. Bloque siguiente, acción: Reproducir una URL en un reproductor DLNA, reproductor del dormitorio, URL {{0.0.stream_url}}, título {{0.0.name}}, volumen 20.

Una radio de jazz al azar el domingo por la mañana:

1. Disparador: Hora, 10:00, el domingo.
2. Acción: Elegir una radio al azar, género jazz.
3. Bloque siguiente, acción: Reproducir una URL en un reproductor DLNA, URL {{0.0.stream_url}}, título {{0.0.name}}.

Recibir un aviso cuando su emisora favorita falla:

1. Disparador: Cambio de estado de un dispositivo, función Flujo en línea de la emisora, igual a 0.
2. Acción: Enviar un mensaje: «FIP está sin conexión en Radio Browser».

Solución de problemas

• «No se puede contactar con Radio Browser» en la pestaña Configuración: compruebe que el equipo de Gladys tiene acceso a Internet. El directorio funciona en servidores mantenidos por voluntarios: la integración prueba el servidor siguiente, y de nuevo en la actualización siguiente. Mientras tanto, los favoritos conservan sus últimos datos conocidos.
• Una emisora aparece sin conexión pero suena: el estado es la última comprobación del flujo por el directorio, que se hace aproximadamente una vez al día. Se actualiza en la actualización que sigue a una nueva comprobación.
• Sin logotipo: en un widget de Gladys solo se pueden mostrar logotipos PNG, JPEG y WebP de 300 KB como máximo; muchas emisoras publican un icono (.ico) o un archivo SVG.
• El reproductor no reproduce el flujo: pruebe otra versión de la emisora (una en MP3 en lugar de AAC, o en http en lugar de https) y evite los flujos HLS (.m3u8).
• La emisora no aparece en la pestaña Descubrir: ejecute Ver los favoritos y vuelva a abrir la pestaña Descubrir.
• Registros detallados: ponga la variable LOG_LEVEL en debug. Los registros nunca contienen las direcciones de los flujos.

Cómo usa la integración Radio Browser

Radio Browser es gratuito y lo mantienen voluntarios. La integración sigue sus indicaciones:

• una sola petición para todos sus favoritos en cada actualización (cada 60 minutos por defecto, cada 15 minutos como mucho); una búsqueda solo cuando usted la ejecuta;
• un servidor elegido al azar entre los que anuncia el directorio (DNS), y luego el siguiente si falla;
• un User-Agent explícito: gladys-radio-browser/<version>;
• la dirección de flujo resuelta por el directorio (url_resolved);
• una escucha contada cada vez que una acción de escena inicia una emisora, para que la popularidad de las emisoras siga teniendo sentido (el directorio cuenta una por día y por dirección).

Radio Browser no publica ninguna cuota. Los logotipos se descargan directamente de los sitios web de las emisoras, que ven entonces la dirección de Internet de su hogar.

Límites

• Sin reproducción directa: Gladys 5.2 no permite que una integración controle un dispositivo de otra integración, ni reproducir una dirección en los altavoces del núcleo mediante una acción de escena (Sonos, AirPlay, Google Cast: su «difundir una notificación» solo reproduce un texto leído y se detiene al cabo de unos segundos o minutos). Por eso la dirección del flujo pasa por una escena hacia el reproductor de una integración que la acepte, como DLNA.
• 50 favoritos como máximo; el widget muestra 12 (8 en lista).
• El estado del flujo es el que comprueba el directorio, no una comprobación en directo.
• Los nombres de las funciones se quedan en el idioma en que se añadieron.
• Quitar un favorito no elimina su dispositivo.
• Desarrollada sin conexión directa al directorio, con respuestas grabadas de su API: sus comentarios son bienvenidos en el repositorio de GitHub.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Para empezar	section	No	Radio Browser es un directorio libre de unas 50 000 radios web, mantenido por voluntarios: sin cuenta ni clave. Busque una emisora con la acción «Buscar una emisora» de abajo y añádala con «Añadir a favoritos» y su número. Cada favorito aparece entonces en la pestaña Descubrir: haga clic en «Añadir a Gladys». Esta integración no está afiliada a radio-browser.info.
Reproducir una radio	section	No	Gladys todavía no permite que una integración inicie el reproductor de otra integración. En una escena, añada la acción «Obtener el flujo de una radio» y luego la acción «Reproducir una URL» de su reproductor (la integración DLNA, por ejemplo) con la dirección del flujo como URL. La documentación muestra un ejemplo completo.
Idioma de los nombres y mensajes	select	No	Nombres de las funciones de las emisoras añadidas a partir de ahora (Gladys los conserva una vez añadido el dispositivo) y mensajes de error de las acciones de escena.
Intervalo de actualización (minutos)	number	No	Con qué frecuencia se vuelven a leer los favoritos en Radio Browser (comprobación del flujo, tasa de bits, logotipo), en una sola petición para todos. De 15 a 360 minutos: el directorio comprueba cada flujo aproximadamente una vez al día.

Cómo instalar Radio Browser en Gladys

1. En Gladys, abre Integraciones: Radio Browser 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/guim31/gladys-radio-browser:1.0.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/guim31/gladys-radio-browser.

Radio Browser requiere Gladys >=5.1.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

Radio Browser 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 guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

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 🙂