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

Lanzamientos de los artistas que sigue: calendario, avisos, portadas y widgets.
Presentación
Esta integración lleva a Gladys los nuevos lanzamientos de los artistas que sigue: álbumes, EP, sencillos, álbumes en directo y recopilatorios llegan a un calendario «Lanzamientos musicales» para cada usuario que activa la integración. Las escenas pueden reaccionar cuando se anuncia un lanzamiento, el día en que sale (o la víspera, o una semana antes) y cuando cambia su fecha, y tres widgets del panel muestran lo que viene y lo que acaba de salir, con las portadas.
Los lanzamientos proceden de MusicBrainz, la enciclopedia libre de la música mantenida por su comunidad y la MetaBrainz Foundation, mediante su API oficial. No hace falta cuenta ni clave. Las portadas proceden de Cover Art Archive.
Requisitos
- Gladys Assistant 5.3.0 o posterior (integraciones de calendario).
- Acceso a internet.
- Opcional: una cuenta de MusicBrainz con una colección pública de artistas, un perfil de ListenBrainz o un perfil de Last.fm con una clave de API gratuita.
Configuración
Indique primero los artistas que quiere seguir. Cuatro maneras, que se suman (300 artistas como máximo):
- Botón «Seguir a un artista»: escriba un nombre; la integración encuentra al artista en MusicBrainz y le dice cuál ha elegido. Para un homónimo (hay varios «Nirvana»), pegue la dirección de la página del artista en musicbrainz.org, o el identificador que indica el mensaje. «Dejar de seguir a un artista» quita uno; «Listar los artistas seguidos» los muestra todos con su fuente.
- Colección de MusicBrainz: la dirección de una colección pública de artistas de su cuenta de MusicBrainz. Añada o quite artistas en musicbrainz.org; la integración vuelve a leer la colección una vez al día.
- Usuario de ListenBrainz: se sigue a sus artistas más escuchados.
- Usuario de Last.fm y Clave de API de Last.fm: se sigue a sus artistas más escuchados. La clave es gratuita y se crea en un minuto en last.fm/api.
| Campo | Descripción |
|---|---|
| Tipos de lanzamientos | Álbumes y EP por defecto; se pueden añadir sencillos, álbumes en directo, recopilatorios y otros (bandas sonoras, remezclas…). |
| Colección de MusicBrainz | Dirección (o identificador) de una colección pública de artistas. Opcional. |
| Usuario de ListenBrainz | Opcional. Estadísticas públicas, sin clave. |
| Usuario / clave de API de Last.fm | Opcional. La clave solo se envía a Last.fm. |
| Artistas más escuchados seguidos | 10, 20 (por defecto), 30 o 50, para ListenBrainz y Last.fm. |
| Periodo de escucha | El año (Last.fm: los últimos 12 meses; ListenBrainz: el año en curso, el anterior hasta finales de febrero), o desde el principio. |
| Lectura de MusicBrainz | Cada 3, 6 (por defecto), 12 o 24 horas. |
| Hora del disparador «día de lanzamiento» | De 0 a 23, hora local (9 por defecto). |
| Idioma de los textos de las escenas | Idioma de las frases hechas y de los mensajes de los botones. Automático: el idioma del panel. |
Guarde y después, en Mis calendarios en la misma página, pulse Activar para mí. Cada usuario que quiera el calendario activa la integración para sí mismo. La lista de artistas seguidos es la misma para todos.
Uso
Calendario
Cada usuario obtiene un calendario llamado «Lanzamientos musicales», con un evento de día completo por cada lanzamiento cuyo día está anunciado: «Muse – The Wow! Signal», su tipo en la descripción y un enlace a su página en MusicBrainz. El calendario conserva los lanzamientos desde 30 días atrás hasta dos años por delante. Si cambia la fecha de un lanzamiento, el evento la sigue; un lanzamiento que MusicBrainz retira, o cuyo artista deja de seguir, desaparece.
Un lanzamiento anunciado para «2027» o «marzo de 2027» aún no tiene día: aparece en los widgets y entra en el calendario en cuanto se conoce su día.
Un calendario nuevo es privado. En Mis calendarios, active Compartir con el hogar para usarlo en las escenas del hogar (y con el disparador nativo «Se acerca un evento del calendario»), o desactive Sincronizar este calendario para dejarlo de lado.
Widgets del panel

- Próximos lanzamientos: los 3, 5 u 8 próximos lanzamientos con su fecha, el tiempo que falta, una insignia para el tipo y la portada. Toque un lanzamiento para ver sus detalles y su página de MusicBrainz.
- Últimos lanzamientos: los 6, 9 o 12 últimos discos publicados en los últimos 30, 60 o 90 días, en cuadrícula de portadas.
- Próximo lanzamiento: la cuenta atrás hasta el próximo lanzamiento, su fecha, su tipo y su portada grande.
Cada uno puede limitarse a ciertos tipos de lanzamientos en sus ajustes. Una portada solo se muestra cuando Cover Art Archive tiene una, lo que es raro mucho antes del lanzamiento.
Escenas
Disparadores (filtros: tipos de lanzamientos y el nombre de un artista exactamente como lo escribe MusicBrainz):
- MusicBrainz: lanzamiento anunciado: ha aparecido en MusicBrainz un nuevo lanzamiento de un artista seguido. Seguir a un artista nuevo no anuncia nada: solo lo que aparece después.
- MusicBrainz: día de lanzamiento: un lanzamiento sale hoy, mañana o dentro de una semana (se elige en «Cuándo»), a la hora de la configuración. Solo para los lanzamientos cuyo día se conoce.
- MusicBrainz: fecha de lanzamiento modificada: la fecha de un próximo lanzamiento se ha aplazado, adelantado o precisado;
previous_datecontiene la anterior.
Las variables: full_title («Muse – The Wow! Signal»), title, artist, credit, kind (album, ep, single, live, compilation, other), kind_name, date, date_text, days, url, cover_url, text (una frase hecha), release_id.
Acciones: MusicBrainz: próximo lanzamiento y MusicBrainz: último lanzamiento devuelven un lanzamiento (de ciertos tipos, o de un artista): título, artista, tipo, fecha, días que faltan o transcurridos, enlace, dirección de la portada y una frase hecha text.
Ejemplos:
- Cuando un álbum de un artista seguido sale hoy → enviar
{{triggerEvent.data.text}}por Telegram a las 9:00. - Cuando se anuncia un lanzamiento → enviar
{{triggerEvent.data.full_title}}, {{triggerEvent.data.date_text}}y el enlace{{triggerEvent.data.url}}. - Cada viernes a las 18:00 → MusicBrainz: último lanzamiento, y hacer que Gladys diga su
text.
Transporte
Solo nube. Los identificadores de los artistas seguidos van a MusicBrainz; las portadas se descargan de Cover Art Archive cuando un panel las muestra; su usuario de ListenBrainz o de Last.fm solo va a ese servicio, cuando lo indica. Nada más sobre usted o su hogar sale de su red.
Solución de problemas
- El calendario sigue vacío: compruebe que ha pulsado Activar para mí en Mis calendarios, que se sigue al menos a un artista («Listar los artistas seguidos») y que algún lanzamiento de los tipos elegidos tiene un día conocido. Muchos artistas no tienen nada anunciado.
- Se siguió al artista equivocado: varios artistas comparten ese nombre. Deje de seguirlo y siga al correcto pegando la dirección de su página en musicbrainz.org.
- «MusicBrainz está saturado»: sus servidores responden «busy» cuando están cargados. La integración lo reintenta por sí sola unos minutos después; no se pierde nada.
- Fuente «colección»: colección no encontrada: la colección debe ser pública (edítela en musicbrainz.org) y contener artistas, no lanzamientos.
- Fuente «Last.fm»: la clave de API de Last.fm es rechazada: compruebe la clave, creada en last.fm/api. Un artista al que Last.fm llama de otro modo que MusicBrainz se omite.
- Falta un lanzamiento o su fecha es errónea: MusicBrainz lo edita su comunidad; cualquiera puede añadir o corregir un lanzamiento en musicbrainz.org, y la integración lo recoge en su próxima lectura. Los bootlegs se descartan a propósito, y la reedición de un disco antiguo no es una novedad.
- Un lanzamiento no tiene portada: Cover Art Archive aún no tiene ninguna; la integración vuelve a preguntar cada día.
- La escena «día de lanzamiento» no se ejecutó: se dispara una vez, a la hora de la configuración, si Gladys está en marcha en ese momento; el lanzamiento necesita un día exacto y un tipo seguido.
Para un informe de error, indique las versiones de Gladys y de la integración, las fuentes de artistas que usa y las líneas de la pestaña Registros de la integración; en modo desarrollador, DEBUG=gladys-integration-sdk añade los registros del SDK.
Parámetros de configuración
Estos son los parámetros que MusicBrainz te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cómo funciona | section | No | 1. Indique los artistas que quiere seguir: el botón «Seguir a un artista» más abajo (basta un nombre) y/o una de las fuentes siguientes (una colección de MusicBrainz, su perfil de ListenBrainz o de Last.fm). 2. Active la integración en «Mis calendarios» más abajo: obtendrá un calendario «Lanzamientos musicales». 3. Añada los widgets a un panel y use los disparadores de escena (lanzamiento anunciado, día de lanzamiento, fecha modificada). Los lanzamientos proceden de MusicBrainz, la enciclopedia libre de la música: sin cuenta ni clave. Solo se le envían los identificadores de los artistas seguidos. |
| Tipos de lanzamientos | multi_select | Sí | El calendario, los widgets y las escenas solo ven estos. Los bootlegs siempre se descartan. |
| Otras fuentes de artistas (opcional) | section | No | Estas listas se suman a los artistas del botón «Seguir a un artista» y se vuelven a leer una vez al día. 300 artistas como máximo en total. |
| Colección de MusicBrainz | string | No | Dirección de una colección pública de artistas de su cuenta de MusicBrainz: se siguen todos sus artistas. |
| Usuario de ListenBrainz | string | No | Sigue a sus artistas más escuchados (estadísticas públicas, sin clave). |
| Usuario de Last.fm | string | No | Sigue a sus artistas más escuchados. Requiere la clave de API de abajo. |
| Clave de API de Last.fm | secret | No | Gratuita, se crea en un minuto en last.fm/api (enlace arriba). Solo se envía a Last.fm. |
| Artistas más escuchados seguidos | select | No | Para ListenBrainz y Last.fm. |
| Periodo de escucha | select | No | Last.fm: los últimos 12 meses. ListenBrainz: el año en curso (el anterior hasta finales de febrero). |
| Lectura y escenas | section | No | MusicBrainz es un servicio gratuito mantenido por una fundación: la integración lo lee con cuidado, una petición por segundo como máximo. |
| Lectura de MusicBrainz | select | No | |
| Hora del disparador «día de lanzamiento» | number | No | De 0 a 23, hora local: las escenas se ejecutan a esa hora el mismo día (o la víspera, o una semana antes). |
| Idioma de los textos de las escenas | select | No | Para las frases hechas de las escenas y los mensajes de los botones. Automático: el idioma del panel. |
Cómo instalar MusicBrainz en Gladys
- En Gladys, abre Integraciones: MusicBrainz 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/william-de71/gladys-musicbrainz:0.1.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/William-De71/gladys-musicbrainz.
MusicBrainz 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
MusicBrainz 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 William-De71, 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