Integración domótica AzuraCast, gratuita y de código abierto
Su radio web AzuraCast en Gladys: canción, oyentes, directos y escenas en cada cambio.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
AzuraCast es una radio web autoalojada: un AutoDJ que reproduce sus listas, programas en directo de sus locutores y una página pública para sus oyentes. Esta integración lleva sus emisoras a Gladys: lo que suena ahora, el número de oyentes, si un locutor está en directo, y escenas que reaccionan a una nueva canción, al inicio o al final de un programa en directo, a un umbral de oyentes o a una emisora que deja de emitir. Las escenas también pueden pasar a la siguiente canción.
AzuraCast puede funcionar en casa o en un servidor alquilado: la integración funciona con ambos (la insignia del dispositivo indica «local» o «cloud» según la dirección).
Probada con un AzuraCast real en Docker (versión continua posterior a 0.23.9, octubre de 2026), con tonos de prueba generados en una lista, oyentes y un programa en directo enviado por ffmpeg: canciones, oyentes, el directo y su final, saltar una canción, la carátula. Sus comentarios son bienvenidos en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un servidor AzuraCast accesible desde Gladys (su interfaz web, puerto 80 o 443 por defecto).
- La API pública activada en cada emisora (Edit Station Profile → Profile → «Enable public API», activada por defecto).
- Opcional: una clave de API de AzuraCast, para saltar canciones desde Gladys.
Primeros pasos
1. Encontrar la dirección de AzuraCast
Es la dirección de su interfaz web, por ejemplo http://192.168.1.2 o
https://radio.example.org. También sirve una dirección copiada del navegador
(un reproductor público …/public/mi_emisora, el panel): la integración
conserva su inicio.
2. Configurar la integración
En Gladys, abra la integración y rellene:
- Dirección de AzuraCast.
- Clave de API (opcional): en AzuraCast, abra My Account → API Keys, cree una clave y péguela aquí. El usuario debe poder gestionar la emisora (permiso «Broadcasting»). Solo para el botón Siguiente y la acción «Pasar a la siguiente canción».
- Intervalo de actualización: 15 segundos por defecto. Una petición ligera para todas las emisoras cada vez.
- Idioma de los nombres: el idioma de los nombres de las funciones y de los resultados de escena.
Después use Probar la conexión: lee AzuraCast, indica lo que suena en cada emisora y comprueba la clave de API.
3. Añadir los dispositivos
Abra la pestaña Descubrir: cada emisora pública es un dispositivo, con su nombre. Añada las que desee.
Los dispositivos
| Función | Lo que indica |
|---|---|
| En antena | Sí mientras la emisora emite |
| Oyentes | Las personas que escuchan ahora |
| Pico de oyentes de hoy | El máximo de oyentes desde medianoche |
| Canción actual | «Artista – Título» de la canción en antena («—» fuera de antena) |
| En directo | Sí cuando un locutor está en directo, no con el AutoDJ |
| Locutor | El nombre del locutor en antena («—» con el AutoDJ) |
| Siguiente canción | La próxima canción del AutoDJ («—» cuando AzuraCast no la conoce) |
Una emisora queda fuera de antena tras un minuto sin emitir (o sin respuesta de AzuraCast), y un programa en directo termina tras un minuto sin locutor: un corte breve no cambia nada.
Panel
El widget AzuraCast ahora muestra el título y el artista de la canción con su carátula, los oyentes y el pico del día, si la emisora está en antena, el locutor durante un directo y la siguiente canción. Elija la emisora en los ajustes del widget (vacío: la primera emisora). El botón Siguiente (con la clave de API, tras una confirmación) salta la canción; el botón Escuchar abre la página pública de la emisora cuando su dirección es https://.
Escenas
Disparadores
Cada disparador puede limitarse a una emisora (vacío: cualquier emisora) y ofrece el nombre de la emisora.
- Suena una nueva canción: con la canción, el artista, el título y el álbum. También se dispara con una canción reproducida dos veces seguidas.
- Empieza un programa en directo: con el nombre del locutor.
- Termina un programa en directo: con el nombre del locutor y la duración en minutos.
- Los oyentes alcanzan un umbral: elija 1, 5, 10, 25, 50, 100, 250, 500 o 1000; se dispara una vez al día cuando los oyentes lo alcanzan. 1 significa «alguien escucha».
- Una emisora deja de emitir: la emisora (o todo AzuraCast) lleva un minuto sin emitir.
La integración recuerda lo que ha visto: un reinicio de Gladys no anuncia dos veces un directo o un umbral, y una canción empezada mientras tanto se anuncia una vez.
Acciones
- Canción actual: lee una emisora para las siguientes acciones: en antena o no, en directo o no, canción, artista, título, álbum, locutor, siguiente canción, oyentes y una frase lista («Mi Radio: En antena, en directo con DJ Max, Artista – Título, 12 oyente(s)»).
- Pasar a la siguiente canción: salta la canción del AutoDJ. Requiere la clave de API de la configuración.
Ideas de escenas
- Luz «On air»: «Empieza un programa en directo» pone en rojo la lámpara del estudio; «Termina un programa en directo» la apaga y le envía la duración.
- La canción en la televisión: «Suena una nueva canción» muestra la canción en la pantalla del salón, o la anuncia por el altavoz.
- Alerta fuera de antena: «Una emisora deja de emitir» le envía una notificación; una escena matinal salta una canción que no le gusta.
Solución de problemas
- AzuraCast no responde: compruebe la dirección desde la máquina donde funciona Gladys.
- No hay ningún AzuraCast en esta dirección: la dirección lleva a otro servicio.
- La dirección redirige: introduzca la dirección https://.
- AzuraCast responde, pero no muestra ninguna emisora pública: active «Enable public API» en el perfil de la emisora.
- Clave de API rechazada, o sin permisos sobre esta emisora: vuelva a crear la clave con un usuario que gestione la emisora.
- Sin carátula en el widget: la canción no tiene en AzuraCast, o su archivo supera 300 KB (el límite de Gladys).
Límites
- Un servidor AzuraCast por integración; las emisoras sin API pública no se ven.
- AzuraCast se lee al intervalo elegido (15 segundos por defecto), no en tiempo real: una canción más corta que el intervalo puede pasar desapercibida.
- Saltar solo funciona con el AutoDJ de AzuraCast (Liquidsoap), no durante un directo.
- El pico del día lo mide la integración en cada lectura.
- Sin relación con el proyecto AzuraCast.
Parámetros de configuración
Estos son los parámetros que AzuraCast te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su AzuraCast | section | No | Introduzca la dirección de su AzuraCast. Sus emisoras aparecen en la pestaña Descubrir: añada las que desee. La clave de API es opcional (botón y acción «Siguiente canción»). |
| Dirección de AzuraCast | string | Sí | Dirección de la interfaz web de AzuraCast. |
| Clave de API (opcional) | secret | No | Para pasar a la siguiente canción: créela en AzuraCast, My Account → API Keys, con un usuario autorizado a gestionar la emisora. |
| Opciones | section | No | |
| Intervalo de actualización | select | No | Con qué frecuencia se lee AzuraCast: una petición ligera para todas las emisoras. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones (fijados al añadir el dispositivo) y de los resultados de escena. |
Cómo instalar AzuraCast en Gladys
- En Gladys, abre Integraciones: AzuraCast aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-azuracast:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-azuracast.
AzuraCast 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
AzuraCast 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