Saltar al contenido principal

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

Integración MusicBrainz para Gladys Assistant

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):

  1. 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.
  2. 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.
  3. Usuario de ListenBrainz: se sigue a sus artistas más escuchados.
  4. 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.
CampoDescripció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 MusicBrainzDirección (o identificador) de una colección pública de artistas. Opcional.
Usuario de ListenBrainzOpcional. Estadísticas públicas, sin clave.
Usuario / clave de API de Last.fmOpcional. La clave solo se envía a Last.fm.
Artistas más escuchados seguidos10, 20 (por defecto), 30 o 50, para ListenBrainz y Last.fm.
Periodo de escuchaEl 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 MusicBrainzCada 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 escenasIdioma 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​

Los tres widgets: los próximos lanzamientos en lista, los últimos lanzamientos en cuadrícula de portadas y la cuenta atrás hasta el próximo lanzamiento (ilustración generada, no una captura de pantalla; portadas inventadas)

  • 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_date contiene 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ámetroTipoObligatorioDescripción
Cómo funcionasectionNo1. 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 lanzamientosmulti_selectSíEl calendario, los widgets y las escenas solo ven estos. Los bootlegs siempre se descartan.
Otras fuentes de artistas (opcional)sectionNoEstas 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 MusicBrainzstringNoDirección de una colección pública de artistas de su cuenta de MusicBrainz: se siguen todos sus artistas.
Usuario de ListenBrainzstringNoSigue a sus artistas más escuchados (estadísticas públicas, sin clave).
Usuario de Last.fmstringNoSigue a sus artistas más escuchados. Requiere la clave de API de abajo.
Clave de API de Last.fmsecretNoGratuita, se crea en un minuto en last.fm/api (enlace arriba). Solo se envía a Last.fm.
Artistas más escuchados seguidosselectNoPara ListenBrainz y Last.fm.
Periodo de escuchaselectNoLast.fm: los últimos 12 meses. ListenBrainz: el año en curso (el anterior hasta finales de febrero).
Lectura y escenassectionNoMusicBrainz 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 MusicBrainzselectNo
Hora del disparador «día de lanzamiento»numberNoDe 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 escenasselectNoPara las frases hechas de las escenas y los mensajes de los botones. Automático: el idioma del panel.

Cómo instalar MusicBrainz en Gladys​

  1. En Gladys, abre Integraciones: MusicBrainz 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/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).
  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/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.

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 🙂