Music Assistant en Home Assistant: música local sin nube con Squeezelite
Music Assistant es el servidor de música pensado para Home Assistant: reproduce tus archivos locales y emisoras por URL, y deja cada reproductor disponible como entidad para automatizaciones, sin que el audio tenga que salir de tu red. La instalación no es un solo paso: primero se monta el servidor como add-on de Home Assistant y después se añade la integración para que los reproductores aparezcan en el sistema.
Qué aporta frente a un altavoz con streaming propio
El reproductor de altavoz clásico depende del servicio del fabricante. Music Assistant invierte el esquema: las fuentes (carpetas de música, emisoras, si quieres un servicio de streaming con tu cuenta) y los reproductores (Squeezelite, DLNA, entre otros) se conectan a un único servidor local. Home Assistant ve el resultado como entidades media_player y puede encender música, cambiar de emisora o detenerla según una automatización, sin intermediario en la nube.
Antes de instalar
La instalación cómoda (add-on dentro de Home Assistant) exige Home Assistant OS o una instalación supervisada. Si llevas Home Assistant en contenedor sin Supervisor, el servidor de Music Assistant puede correrse como contenedor aparte; el resto de la guía no cambia en lo esencial, pero no se instala desde la tienda de add-ons.
Paso 1: el servidor como add-on
En Home Assistant, abre Ajustes → Complementos → Tienda. En el menú de la esquina (tres puntos) entra en Repositorios y añade el repositorio de add-ons de Music Assistant; la URL exacta está en la documentación oficial, sección Installation. No la copio aquí porque no la he podido verificar literalmente a fecha de 07/09 y una URL equivocada es lo primero que rompe una instalación.
Tras añadir el repositorio, instala el add-on Music Assistant Server. En su configuración deja desactivado el modo "audio directo desde el servidor" si no vas a usar la salida de audio del propio equipo; con Squeezelite cada reproductor se encarga de su propio sonido.
Paso 2: la integración de Home Assistant
Esto es lo que hace que los reproductores aparezcan en Home Assistant. Una vez el add-on esté encendido, añade la integración Music Assistant desde Ajustes → Dispositivos y servicios. La propia documentación de Music Assistant la llama "Home Assistant integration" y es el puente en ambas direcciones: los media_player llegan a tu panel y a tus automatizaciones.
Paso 3: una fuente de música local
Dentro de Music Assistant, en Proveedores, añade el proveedor de sistema de archivos y apunta a la carpeta donde guardas tu música. Vale una carpeta del propio equipo, un disco USB o un recurso compartido del NAS accesible desde la máquina que ejecuta Home Assistant. Para radio local por URL, el proveedor de emisoras por URL cumple el mismo papel sin ficheros.
| Fuente | Funciona sin Internet | Notas |
|---|---|---|
| Carpeta local / NAS | Sí | Tu propia biblioteca |
| Emisora por URL directa | Solo si la URL apunta a tu red | Un stream de radio por Internet sigue necesitando Internet, no es culpa del audio local |
| Streaming comercial (Spotify, etc.) | No | Pide cuenta del servicio y sigue dependiendo de él; no es la vía local-first |
Paso 4: Squeezelite como reproductor en la Raspberry Pi
Con Squeezelite conviertes una Raspberry Pi con altavoz en un reproductor de red visible para Music Assistant. Se instala desde los repositorios de Raspberry Pi OS:
sudo apt update && sudo apt install squeezelite
# lista las tarjetas de sonido para ajustar la salida
aplay -l
# arranque de prueba (cambia el nombre y la tarjeta según tu equipo)
squeezelite -n "Cocina" -o hw:CARD=Device,DEV=0El parámetro -o es la salida de audio tal como aparece en aplay -l; hw:CARD=Device,DEV=0 es el patrón de ejemplo, no una tarjeta universal. Si dejas -o sin definir, Squeezelite usa la salida por defecto del sistema, que es el punto de partida más fácil para una primera prueba.
Music Assistant detecta los reproductores Squeezelite por el protocolo de red local; aparecen en la sección de reproductores sin emparejado. A partir de ahí, en Home Assistant verás un media_player por cada habitación con su nombre.
Automatización sin sintaxis dudosa
La integración expone acciones para reproducir con media_player, pero no voy a pegar aquí un YAML de mass.play_media sin haberlo contrastado con la versión actual. Lo fiable hoy es lo que sí se puede verificar: encender música al detectar presencia con la entidad del reproductor y una fuente ya configurada. En la automatización eliges el media_player de Squeezelite como dispositivo y la acción de reproducir; la fuente (playlist o carpeta) se selecciona desde el selector de medios, sin escribir IDs a mano.
Dónde no llega esta pieza
Music Assistant no sustituye a Spotify Connect ni hace magia con servicios cerrados: si tu única fuente es Spotify, la cuenta y la dependencia del servicio siguen ahí. El caso que aquí gana es el que encaja con el resto del sitio: música en ficheros, emisora por URL o audio de tu red, controlado desde Home Assistant, funcionando aunque Internet se caiga.
Sin confirmar a fecha de 07/09: la URL del repositorio de add-ons de Music Assistant y la sintaxis exacta de los servicios mass.* actuales. Lo demás, validado contra la documentación oficial de Music Assistant consultada antes de escribir.
Última revisión: 07/09/2026