Music Assistant: el cerebro musical definitivo para tu hogar inteligente

3 Replies, 61 Views

Portal › Integraciones y Dispositivos
Si tienes varios altavoces inteligentes repartidos por casa —como Sonos, Google Nest, dispositivos AirPlay o reproductores DLNA— y utilizas distintas plataformas de música o archivos locales en un NAS, seguro que te has encontrado con el mismo problema: cada ecosistema va por su lado.

[Imagen: music-assistant.jpg]

Aquí es donde entra en juego Music Assistant, una de las herramientas de código abierto más potentes y populares del ecosistema Home Assistant. En este artículo te explico qué es exactamente, para qué sirve, qué implica a nivel de privacidad y mi valoración tras integrarlo en un entorno domótico real.

¿Qué es Music Assistant?
Music Assistant es un gestor de bibliotecas musicales gratuito y de código abierto diseñado para convertir tu instancia de Home Assistant en un servidor centralizado de streaming de audio.

A diferencia de las integraciones tradicionales de reproductores multimedia que se limitan a pausar, subir el volumen o mostrar qué suena, Music Assistant actúa como un centro unificado: recoge tu música de diferentes orígenes (servicios en la nube, emisoras de radio o carpetas locales) y la envía hacia prácticamente cualquier altavoz conectado de tu red local, todo desde una interfaz web moderna, rápida y perfectamente integrada en Home Assistant.

¿Para qué se usa? Principales funciones
El objetivo de Music Assistant es eliminar las barreras entre proveedores de música y marcas de altavoces. Entre sus usos más destacados encontramos:

Biblioteca unificada multiorigen: Puedes buscar un artista o crear una lista de reproducción mezclando canciones de Spotify, Tidal, Qobuz, YouTube Music, Deezer, Subsonic o tu propia colección de archivos MP3/FLAC almacenados en un servidor NAS.

Compatibilidad universal con altavoces: Permite enviar audio a altavoces Sonos, Chromecast, AirPlay, DLNA, Squeezebox, Bluesound o reproductores basados en ESPHome, incluso combinando funciones avanzadas según el protocolo.

Reproducción inteligente y audio de calidad: Incluye reproducción sin pausas (gapless), fundido cruzado entre pistas (crossfading) y normalización de volumen para evitar saltos bruscos entre canciones.

Automatizaciones de audio avanzadas: Al integrarse con Home Assistant, puedes lanzar listas de reproducción específicas, emisoras de radio o avisos de voz (TTS) en habitaciones concretas mediante escenas, sensores de presencia o interruptores físicos.

Cómo se instala (Traeré un guía de instalación)

El despliegue en Home Assistant OS consta de dos partes bien diferenciadas que conviene entender:

La Aplicación / Servidor (Add-on): Se instala desde Configuración → Aplicaciones → Tienda de aplicaciones. Es el motor principal que gestiona la base de datos musical, los proveedores y la transmisión de audio.

La Integración en Home Assistant: Una vez arrancado el servidor, Home Assistant lo detecta automáticamente en Dispositivos y servicios. Esta integración es la que crea las entidades media_player dentro de Home Assistant para poder controlar la música desde tus paneles (dashboards) y automatizaciones.

Integración, privacidad y seguridad: ¿qué compartimos y qué exponemos?
Uno de los puntos fuertes de Music Assistant frente a otras soluciones comerciales es su enfoque hacia el control local, aunque hay matices importantes en materia de privacidad y seguridad que conviene tener claros:

Procesamiento 100 % local: La base de datos de tu biblioteca, las carátulas, el historial de reproducción y la gestión de los altavoces se almacenan exclusivamente en el almacenamiento interno de tu servidor Home Assistant. No existe una «nube de Music Assistant» que recopile tus hábitos de escucha.

Credenciales de servicios externos: Si conectas plataformas como Spotify, Tidal o Qobuz, Music Assistant necesita autenticarse contra sus APIs oficiales (mediante tokens OAuth o credenciales de sesión) para acceder a tu catálogo. Esos tokens se guardan de forma local en tu instancia, pero lógicamente el proveedor de streaming seguirá registrando las reproducciones asociadas a tu cuenta.

Acceso a almacenamiento en red (NAS): Si utilizas música local mediante carpetas compartidas (SMB/NFS), la mejor práctica de seguridad es crear un usuario dedicado de solo lectura en tu NAS exclusivo para Music Assistant. De este modo, si ocurre algún fallo o error de configuración, el sistema nunca podrá modificar ni borrar tus archivos originales.

Sin necesidad de abrir puertos: No requiere abrir puertos en el router hacia Internet. Si quieres controlar tu música desde fuera de casa de forma segura, basta con acceder a través de tu VPN habitual (como Tailscale o WireGuard) o mediante Home Assistant Cloud.

Aspectos técnicos importantes a tener en cuenta
Antes de lanzarte a instalarlo, hay tres detalles clave que marcan la diferencia en el rendimiento diario:

Almacenamiento y memoria RAM: Music Assistant genera una base de datos propia que puede crecer bastante si tienes miles de canciones o varios proveedores conectados. Se recomienda encarecidamente ejecutarlo sobre un disco SSD y contar con al menos 4 GB de RAM en el equipo donde corra Home Assistant.

Copias de seguridad: Toda la configuración y la base de datos se guardan dentro del directorio de datos de la aplicación. Hacer un backup de la app desde Home Assistant antes de actualizar te garantiza poder volver atrás en segundos si una nueva versión introduce algún fallo.

Estabilidad de red: El audio multiroom en tiempo real es muy sensible a la latencia. Siempre que sea posible, conecta tu servidor de Home Assistant (y los altavoces que lo permitan) por cable Ethernet o asegúrate de tener una red Wi-Fi mallada (Mesh) bien optimizada.

Mi opinión sobre Music Assistant
Tras probarlo en un entorno doméstico con música local en NAS y altavoz sonos en red, Music Assistant se ha convertido en un imprescindible dentro de Home Assistant.

Lo mejor: La sensación de tener toda tu música —tanto streaming como archivos propios— en un único buscador y poder enviarla a cualquier altavoz de casa sin depender de aplicaciones propietarias lentas. Además, el ritmo de desarrollo es espectacular, con mejoras constantes en protocolos como AirPlay, Cast, Sonos o Sendspin.

Lo menos bueno: La configuración inicial de ciertos proveedores (especialmente algunas autenticaciones de servicios de streaming o permisos de carpetas en red) puede requerir algo de paciencia, y el consumo de memoria es superior al de una integración convencional.

En definitiva, si buscas profesionalizar el audio de tu hogar inteligente, ganar independencia de los ecosistemas cerrados y exprimir las automatizaciones sonoras en Home Assistant, merece totalmente la pena instalarlo.
(Última modificación: 13-11-2026, 08:16 PM por Toni.)
Versión estable (Stable Release) - Cambios desde la versión 2.10.9

🚀 Nuevas funciones y mejoras
Permite añadir múltiples instancias de Pocket Casts (por @OzGav en #7328).

Refactorización del proceso de configuración de Subsonic (por @khers en #7456).

El proveedor de Subsonic ahora utiliza la fecha de última modificación del marcador (bookmark) (por @khers en #7536).

🐛 Corrección de errores
Mantiene el último volumen de Squeezelite cuando caduca su entrada en caché (por @thelad-dev en #6944).

Soluciona los fallos en las actualizaciones de reproductores de Home Assistant cuando media_content_id no es de tipo texto (por @MarvinSchenkel en #7152).

Corrige la desaparición de reproductores multizona Bluesound en redes enrutadas (por @MarvinSchenkel en #7159).

Soluciona un problema por el cual un grupo de altavoces quedaba en silencio tras desconectarse el altavoz principal (leader) (por @marcelveldt en #7320).

Corrige el fallo que impedía emparejar dispositivos Apple TV (por @cleverer en #7352).

Reconstruye los grupos de altavoces más rápido y mantiene preparada la siguiente pista cuando cae el altavoz principal (por @marcelveldt en #7356).

Soluciona un problema por el cual la salida de Sendspin permanecía no disponible en algunos altavoces AirPlay y Cast (por @maximmaxim345 en #7357).

Mantiene activo un grupo en reproducción en Sendspin cuando se une un altavoz Sendspin (por @maximmaxim345 en #7358).

Inicia en 0:00 al retroceder hasta el principio de un audiolibro o episodio (por @fmunkes en #7363).

Añade la opción de autenticación heredada (Legacy Auth) al flujo de configuración de Subsonic (por @khers en #7439).

Soluciona un fallo por el cual un grupo Sendspin se quedaba en silencio tras un cambio de altavoz principal con un miembro visualizador (por @MarvinSchenkel en #7461).

Corrige un error en la búsqueda de ARD Sounds cuando un programa o emisora no tiene enlaces a redes sociales (por @OzGav en #7496).

Evita la distorsión (clipping) cuando la normalización de volumen sube una pista con sonido bajo (por @marcelveldt en #7538).

Evita que los altavoces Cast vuelvan a reproducir pistas anteriores al llegar al final de una cola (por @marcelveldt en #7549).

Evita que el final de una cola de reproducción se corte en altavoces Cast y Bluesound (por @marcelveldt en #7550).

Soluciona los cortes de conexión en altavoces Cast durante reproducciones prolongadas (por @marcelveldt en #7568).

Tidal: muestra el nombre de los artistas del álbum y de los propietarios de las listas de reproducción en los resultados de búsqueda (por @jozefKruszynski en #7585).

🧰 Mantenimiento y actualización de dependencias
Actualización de CodSpeedHQ/action de la versión 5.6.0 a la 5.6.3 (por @dependabot[bot] en #7411).

Instalación del frontend desde su lanzamiento (release) en GitHub en lugar de PyPI (por @marcelveldt en #7434).

Completa la configuración inicial (onboarding) al finalizar el asistente de instalación y no al añadir el primer proveedor (por @marcelveldt en #7509).

🙇 Agradecimientos a los colaboradores
Un agradecimiento especial a los siguientes colaboradores que han contribuido en esta versión:

@MarvinSchenkel, @OzGav, @cleverer, @fmunkes, @jozefKruszynski, @khers, @marcelveldt, @maximmaxim345, @thelad-dev
[2.10.12] - 14.11.2026

📦 Versión estable (Stable Release)

¿Por qué esta versión adicional? Music Assistant estaba enviando más solicitudes de las necesarias a los servicios de música, lo que provocaba que la reproducción fuese lenta o poco fiable, especialmente en Spotify. Esta actualización vuelve a reducir dichas solicitudes. También soluciona varios problemas con AirPlay: el emparejamiento en OS 27.2 y los altavoces HomePod mini 2 y Shairport Sync que se quedaban sin sonido. Se recomienda actualizar a todos los usuarios que utilicen Spotify o AirPlay.

Cambios desde la versión 2.10.11

🐛 Corrección de errores
Rechaza caracteres de control en las listas de archivos concat (por @chrisuthe en #7412).

Elimina caracteres de control de los metadatos de reproducción actual (now-playing) de AirPlay (por @chrisuthe en #7413).

Soluciona la desincronización de los miembros de un grupo AirPlay tras un arranque en frío corregido (por @cTopher en #7503).

Establece un tiempo de espera límite (timeout) para el análisis de etiquetas mediante ffprobe/ffmpeg (por @OzGav en #7584).

Mantiene la reproducción dentro de los límites de solicitudes de los servicios de música (por @marcelveldt en #7599).

Cancela las solicitudes de reproducción que tarden más de un minuto (por @marcelveldt en #7601).

Evita que los artistas carguen todo su catálogo completo al reproducirlos o abrir su perfil (por @marcelveldt en #7602).

Soluciona el fallo de sonido en el HomePod mini 2 y los errores al iniciar grupos AirPlay (airplay-cli v0.5.10) (por @musicassistant-bot[bot] en #7615).

Corrige el emparejamiento AirPlay con Apple TV y HomeView en OS 27.2 (por @marcelveldt en #7632).

Corrige el emparejamiento AirPlay en OS 27.2 y muestra los controles del HomePod en la app Casa (airplay-cli v0.5.11) (por @musicassistant-bot[bot] en #7633).

Soluciona la reproducción sin sonido en AirPlay 2 en receptores Shairport Sync (por @marcelveldt en #7662).

Soluciona el fallo por el cual los altavoces Shairport Sync se quedaban en silencio tras la primera transmisión por AirPlay 2 (airplay-cli v0.5.12) (por @musicassistant-bot[bot] en #7668).

🎨 Cambios en la interfaz (Frontend)
Muestra las canciones principales de un artista en la página de invitados (party guest) cuando el servicio no lista pistas del artista (por @marcelveldt en #3168).

🧰 Mantenimiento y actualización de dependencias
Evita que la reproducción envíe nuevas solicitudes a servicios de música que hayan pedido esperar (por @marcelveldt en #7600).

Evita que se reproduzca de golpe toda una carpeta completa de la biblioteca (por @marcelveldt en #7604).

Soluciona el fallo que impedía importar archivos de música cuando el servidor estaba ocupado (por @marcelveldt en #7660).

🙇 Agradecimientos a los colaboradores
Un agradecimiento especial a los siguientes colaboradores que han contribuido en esta versión:

@OzGav, @cTopher, @chrisuthe, @marcelveldt
[2.10.13] - 21.11.2026

📦 Versión estable (Stable Release)

Cambios desde la versión 2.10.12

🚀 Nuevas funciones y mejoras
Explica en el registro (log) por qué se omite el puente Sendspin Cast en dispositivos no compatibles (por @MarvinSchenkel en #7775).

🐛 Corrección de errores
Soluciona un problema por el cual los altavoces AirPlay 1 se quedaban en silencio tras reiniciarse una entrada en directo (por @devon3000 en #6819).

Mantiene la carátula del álbum en AirPlay cuando la siguiente pista comparte la misma portada (por @MarvinSchenkel en #6912).

Cierra la configuración inicial 15 minutos después de que arranque el servidor (por @chrisuthe en #7410).

Corrige el inicio de sesión en cuentas de ARD Sounds y sincroniza las suscripciones y el progreso de reproducción (por @meiser79 en #7645).

Soluciona el fallo al eliminar varios reproductores de un grupo Squeezelite a la vez (por @marcelveldt en #7666).

Mantiene la portada del álbum en un Apple TV entre pistas del mismo álbum (airplay-cli v0.5.14) (por @musicassistant-bot[bot] en #7699).

Restablece el modo de repetición al entrar en el modo dinámico (por @willowkap en #7754).

Refuerza la validación de las URL de retorno y gestiona los errores de proveedor de identidad (IdP) en la devolución de llamada de autenticación (auth callback) (por @apophisnow en #7759).

Acepta etiquetas de ganancia ReplayGain sin espacio antes de dB (por @OzGav en #7767).

Reproduce episodios de gPodder e iTunes Podcasts cuyo guid y URL de transmisión contienen un espacio (por @fmunkes en #7768).

Inicia desde el principio los episodios de pódcast y audiolibros ya reproducidos por completo (por @MarvinSchenkel en #7772).

Soluciona un error por el cual aparecían pistas atenuadas (greyed out) en una lista guardada cuando varios usuarios comparten un mismo tipo de proveedor (por @MarvinSchenkel en #7774).

Corrige los fallos de reproducción en alta resolución (hi-res) en altavoces HEOS de primera generación (por @MarvinSchenkel en #7776).

Elimina únicamente las portadas de listas de reproducción ubicadas dentro de la carpeta de imágenes del proveedor (por @MarvinSchenkel en #7781).

Soluciona el fallo por el cual Snapcast no restauraba una transmisión default ausente tras un anuncio (por @MarvinSchenkel en #7784).

Corrige el bloqueo de inicio de sesión por parte de Cloudflare para direcciones Tailscale y CGNAT (por @MarvinSchenkel en #7791).

Evita cerrar sesiones de Cast que no hayan sido iniciadas por Music Assistant (por @benjamin-m-holden en #7811).

Soluciona el fallo por el cual Smart Fades no se recuperaba cuando fallaba la descarga de su modelo (por @OzGav en #7823).

Solicita guardar el certificado SSL y la clave antes de verificar (Verify) (por @MarvinSchenkel en #7832).

Mantiene silenciado un altavoz WiiM cuando cambia su volumen (por @MarvinSchenkel en #7834).

Mantiene disponibles los reproductores DLNA tras fallar la renovación de una suscripción a eventos (por @MarvinSchenkel en #7846).

Corrige la carátula del álbum en Apple TV, la pausa y el avance/retroceso (seek) en Shairport Sync, y la desincronización en grupos de HomePod (airplay-cli v0.5.15) (por @musicassistant-bot[bot] en #7850).

Oculta los tokens de los proveedores en el aviso de error al obtener imágenes (por @MarvinSchenkel en #7855).

Reinicia la reproducción en el punto donde estaba cuando un altavoz pierde su conexión de transmisión (por @marcelveldt en #7878).

Mantiene la cola en la nueva pista tras pulsar Siguiente (Next) mientras el reproductor aún informa de la transmisión anterior (por @MarvinSchenkel en #7955).

Evita que la comprobación de álbumes duplicados congele una biblioteca con muchos álbumes del mismo título (por @MarvinSchenkel en #7956).

Muestra un error de conexión en lugar de «sin bibliotecas» (no libraries) cuando la configuración de Plex no logra conectar con el servidor (por @MarvinSchenkel en #7957).

🎨 Cambios en la interfaz (Frontend)
Soluciona un problema por el cual el control deslizante de volumen ignoraba el ratón en PC con pantalla táctil (por @MarvinSchenkel en #3242).

📌 Otros cambios
Utiliza MP3 por defecto en la mayoría de los altavoces Google Cast para evitar cortes de audio (por @marcelveldt en #8014).

Muestra un máximo de 100 lanzamientos de un artista en un servicio de música (por @marcelveldt en #8018).

🧰 Mantenimiento y actualización de dependencias
Detiene los avisos repetidos de direcciones Docker de AirPlay en el registro (log) (por @OzGav en #7829).

🙇 Agradecimientos a los colaboradores
Un agradecimiento especial a los siguientes colaboradores que han contribuido en esta versión:

@MarvinSchenkel, @OzGav, @apophisnow, @benjamin-m-holden, @chrisuthe, @devon3000, @fmunkes, @marcelveldt, @meiser79, @willowkap



Usuarios navegando en este tema: 1 invitado(s)