Música — Navidrome + AudioMuse-AI + Music Assistant¶

Stack de streaming, curación e IA musical de la casa: servidor Navidrome, pipeline de metadatos (Lidarr → beets), letras sincronizadas, normalización de volumen, smart playlists, radio por IA local (AudioMuse-AI en GPU), un mapa visual de la biblioteca (galaxia sónica), orquestación multiroom real (Music Assistant), un reproductor en la tablet familiar y un DJ conversacional para Vera (ver DJ conversacional).

Para la adquisición de música (Lidarr / Soulseek / soularr) ver Media Stack → Music Acquisition. Este doc cubre todo lo que pasa después de tener los ficheros en el NAS.

Componentes¶

• Navidrome admin: monxas / alfagann · Lidarr API key en config.xml.
• AudioMuse / Music Assistant: monxas/alfagann SSH al Bazzite y al 208 (puerto 22; el wsl-ai:2222 del ssh config está obsoleto).

Arquitectura¶

graph TB
    subgraph NAS["NAS .237 (NFS)"]
        MUSIC[(/Volume1/Media/music
214GB FLAC · monxas:monxas)]
    end
    subgraph VM208["VM 208 — Docker"]
        LIDARR[Lidarr :8686
dueño de la estructura]
        BEETS[beets
re-tag MusicBrainz]
        ND[Navidrome :4533
ND_PID_ALBUM=folder]
    end
    subgraph BAZ["Bazzite .141 — podman + RTX 3080"]
        AM[AudioMuse-AI :8123
pod: postgres+redis+flask+worker]
    end
    subgraph EDGE["Edge"]
        CF[Cloudflare Tunnel + Access]
    end
    CLIENT[Cassette / Amperfy
iPhone]

    LIDARR -->|import| MUSIC
    BEETS -->|write tags| MUSIC
    MUSIC -->|NFS ro| ND
    ND -->|/rest stream| AM
    AM -->|getSimilarSongs plugin| ND
    ND --> CF --> CLIENT
    AM -.->|IP interna .208:4533| ND

Pipeline de biblioteca¶

Regla de oro: Navidrome agrupa por TAGS, no por carpetas. Mover carpetas NO cambia la agrupación. Y Lidarr es el dueño de la estructura de ficheros.

Adquisición (Soulseek/torrent) → Lidarr importa a /data/music (con carpeta de álbum)
        ↓
beets re-taggea contra MusicBrainz (albumartist, MBID, año, feat.)  [move:no, write:yes]
        ↓
NAS /mnt/nfs_media/music  (monxas:monxas)
        ↓
Navidrome escanea (read-only) → agrupa por PID=folder

Configuración de Navidrome¶

Variables clave en el compose (/home/monxas/stacks/media/compose.yaml, no versionado):

ND_PID_ALBUM: folder              # una carpeta = un álbum (ignora tags inconsistentes)
ND_SCANNER_PURGEMISSING: full    # purga SOLO en full scans (era 'always': con el
                                  # historial de caídas NFS, un escaneo en mal momento
                                  # podía purgar la biblioteca entera — ver auditoría 26-jul)
ND_COVERARTPRIORITY: "cover.*, folder.*, front.*, embedded"
ND_LASTFM_ENABLED: "true"         # arte de artista + biografías + getTopSongs
ND_LASTFM_APIKEY: ${LASTFM_API_KEY}      # SOPS secrets/media.sops.yaml
ND_LASTFM_SECRET: ${LASTFM_SHARED_SECRET}
ND_ENABLETRANSCODINGCONFIG: "true"       # transcode al vuelo (datos móviles)
# ND_ENABLESHARING: default ON — NO desactivar (ver gotcha)

scan --full (forzar re-lectura)¶

docker exec navidrome navidrome scan --full   # re-lee TODOS los tags

El startScan de la API es incremental — NO detecta cambios de tags ni borrados. Tras cualquier re-tag de beets o cambio de ficheros, hay que forzar el scan --full.

Acceso y auth (CF Access)¶

Tres Access apps (creadas vía CF API, patrón n8n-webhook-bypass):

Letras (LRCLIB)¶

8.643 pistas con .lrc (7.111 sincronizadas con timestamps, 1.532 planas). Bajadas con un fetcher a LRCLIB (gratis, sin API key) que escribe un .lrc sidecar al lado de cada audio.

docker exec beets sh -c 'find /music -name "*.lrc" -exec chown 1000:1000 {} + ; \
                         find /music -name "*.lrc" -exec chmod 644 {} +'

Limpieza de basura de scraping ("N Contributors… Lyrics", "…Embed") en letras embebidas: FLAC=VorbisComment lyrics; MP3=frame USLT (no la clave lyrics); M4A=\xa9lyr.

ReplayGain (normalización de volumen)¶

Nivela el volumen entre pistas (la biblioteca era muy "loud": rango de 32 dB, mediana de ajuste −9 dB). Usar rsgain, NO el plugin de beets (su backend ffmpeg da status 254 en beets 2.12 aunque ffmpeg tenga ebur128).

docker exec beets sh -c "apk add --no-cache rsgain"      # Alpine
docker exec beets rsgain easy -m 4 /music                # track_gain + album_gain, in-place

Smart playlists¶

7 playlists .nsp (JSON auto-actualizable) en /mnt/nfs_media/music/Smart Playlists/. Aparecen en Navidrome tras scan --full y en cualquier cliente.

Formato NSP: {"name": "...", "all": [{"op": {"field": val}}], "sort": "...", "limit": N}. Operadores: is/gt/lt/inTheRange/inTheLast/notInTheLast/isMissing, sort: random.

AudioMuse-AI (radio por IA local)¶

Analiza el audio real de cada pista (huella sónica, no tags) para dar similares por sonido, Instant Mix/radio y mood playlists — self-hosted, sin APIs externas. Integra con Navidrome vía sonicSimilarity (0.62+).

Despliegue (Bazzite .141, podman + GPU)¶

Pod audiomuse con 4 contenedores + workers, imagen ghcr.io/neptunehub/audiomuse-ai:latest-nvidia. Web: http://192.168.0.141:8123 (puerto 8123 porque SillyTavern ocupa el 8000).

podman pod create --name audiomuse -p 8123:8000
# postgres15 + redis + flask + worker(s), cada uno en el pod
podman run -d --pod audiomuse --name am-worker \
  --device nvidia.com/gpu=all --security-opt=label=disable \   # <-- clave
  -e SERVICE_TYPE=worker -e PER_SONG_MODEL_RELOAD=false \
  -e POSTGRES_HOST=127.0.0.1 -e REDIS_URL=redis://127.0.0.1:6379/0 \
  ghcr.io/neptunehub/audiomuse-ai:latest-nvidia

Persistencia: podman generate systemd --new --files --name audiomuse + loginctl enable-linger monxas + systemctl --user enable pod-audiomuse.

Config media server: por el Setup Wizard web (no env). Se guarda en la tabla music_servers (Postgres). Apuntar a la IP interna http://192.168.0.208:4533 (no el dominio público — evita el túnel CF para 10k descargas):

podman exec -i am-postgres psql -U audiomuse -d audiomusedb -c \
  "update music_servers set creds='{\"url\":\"http://192.168.0.208:4533\",\"user\":\"monxas\",\"password\":\"alfagann\"}' where server_type='navidrome';"

Lanzar análisis (incremental — resume, los embeddings persisten en Postgres):

curl -X POST http://127.0.0.1:8123/api/analysis/start \
  -H "Content-Type: application/json" -d '{"num_recent_albums":0,"top_n_moods":5}'
# num_recent_albums:0 = todos. Progreso: /api/last_task ; cancelar: /api/cancel/<task_id>

Rendimiento del análisis — lecciones¶

Uso desde Cassette¶

• Instant Mix / radio de una canción (icono ✨) → va por el plugin de Navidrome AudioMuse-AI-NV-plugin (getSimilarSongs). Funciona en cualquier cliente Subsonic, sin configurar nada en la app.
• Mood playlists por sonido → Cassette → Ajustes → AudioMuse → URL http://192.168.0.141:8123. Sin conectar, las moods usan tags (más burdas).

Galaxia sónica (mapa visual)¶

Visualización interactiva de la biblioteca: cada pista es una estrella posicionada por cómo suena (embeddings de AudioMuse, no tags). Vive en http://192.168.0.208:4544/ (LAN, sin auth — misma zona de confianza que el resto de dashboards del homelab).

AudioMuse Postgres (embedding + score + track_server_map)
   → galaxy_project.py (dentro de am-worker: umap/sklearn)
     · L2-normalize → UMAP(cosine) → 2D
     · KMeans(k=26) → 26 "regiones sónicas" (color por género dominante)
   → web/galaxy_data.json (~2.2 MB)
   → web/index.html — WebGL2 self-contained (sin CDNs), covers+audio directo de Navidrome

Fuente en el repo: services/sonic-galaxy/ (README.md, galaxy_project.py, deploy.sh, web/). Actualizar tras crecer el análisis: regenerar el JSON dentro de am-worker (reusa sus libs), copiarlo a web/galaxy_data.json y ./deploy.sh (rsync + recreate contenedor nginx). El nginx sirve web/ de solo lectura, así que un scp del JSON solo basta para refrescar datos.

Music Assistant (multiroom real)¶

Orquesta los altavoces físicos de la casa (Sonos, HomePods/AirPlay, Apple TV) sobre el catálogo de Navidrome — Navidrome sigue siendo la biblioteca; MA es la capa de reproducción/colas/grupos. Contenedor Docker en VM 208 (no add-on de HAOS — la VM de HA solo tiene ~1.3 GB libres; 208 lo absorbe con ~150 MB).

image: ghcr.io/music-assistant/server:latest
network_mode: host        # obligatorio para mDNS de Sonos/AirPlay
mem_limit: 1536m          # sin swap

Web UI: http://192.168.0.208:8095 (admin monxas/alfagann). Conectado a Navidrome por IP interna (http://192.168.0.208:4533, no el dominio público — evita el túnel CF). Integración en HA: Ajustes → Dispositivos y servicios → Music Assistant (suele autodescubrirse vía zeroconf).

Auditoría de la capa MA/altavoces (2026-07-26) — todo verificado, sin cambios necesarios¶

Auditoría de arquitecto sobre MA 2.9.9 con evidencia en vivo. Resultado: limpio — cero cambios necesarios en esta capa. Lo verificado:

• Sin grupos huérfanos: tras un día entero de tests que crearon/deshicieron grupos sync, players/all muestra solo Dormitorio Grupo (el intencional). La disciplina de limpieza + el fix de reutilización de grupos aguantaron.
• 20 providers, todos available: true (opensubsonic, airplay, sonos, sendspin, lrclib para letras, lastfm_recommendations, loudness_analysis…).

Matriz de capacidades por altavoz (afecta a qué botones tienen sentido en cualquier UI — la tablet hoy no la consulta, mejora futura):

Los universal_player son objetivos "lanzar y parar" — ni pausa. El seek de la barra de progreso solo funciona de verdad en los dos Sonos.

Cassette — verificación server-side completa (2026-07-26)¶

Todo lo que Cassette necesita, probado desde el camino público real (music.monxas.casa/rest con el bypass de CF Access, credenciales tablet):

• ping → ok (Navidrome 0.63.2).
• getOpenSubsonicExtensions → transcodeOffset, formPost, songLyrics, indexBasedQueue, transcoding, playbackReport, sonicSimilarity — la extensión sonicSimilarity es la integración AudioMuse que Cassette usa para su Instant Mix sónico.
• getTopSongs → devuelve resultados reales (la feature por la que se eligió Cassette sobre Amperfy).
• getSimilarSongs2 → 5 resultados (Instant Mix operativo).
• getArtistInfo2 → URL de imagen bajo /share/img/<jwt> y la descarga da HTTP 200 sin cookies de CF (el bypass de /share funcionando — sin él, los móviles no ven fotos de artista).

Auditoría Navidrome + biblioteca + backups (2026-07-26) — hallazgos y arreglos¶

Auditoría de arquitecto con evidencia (DB, logs, permisos, cron). Lo bueno primero: DB sana (integrity_check=ok, 9.743 pistas / 776 álbumes / 3.252 artistas, missing=0), raíz NFS correcta, 8.643 .lrc bien, las 25 playlists presentes (las 7 "smart" con 0 canciones son evaluación perezosa, no un bug).

Arreglado en el momento:

• ND_SCANNER_PURGEMISSING=always → full (el hallazgo más peligroso): con always, un escaneo que pillara el NFS caído (historial real: nfsd D-state 14-jul, root:root 21-jul) purgaría permanentemente pistas + anotaciones + entradas de playlists, sin papelera. Con full solo purga en escaneos completos deliberados, nunca en los rápidos del watcher.
• 1.894 ficheros root:root en la biblioteca → 0, incluidas las 207 carátulas con modo 600 ilegibles para Navidrome (verificado antes/después con la que fallaba en el log: Lil Wayne/Rebirth/cover.jpg → legible). Causa: beets corre como root con umask 077. Pendiente: chown al final de cada pasada de beets (hoy solo existe el fix-script de movies/tvshows).
• Cuarentena oculta .quarantine-dupes-20260723 (71M) movida fuera del árbol de la biblioteca a _music_quarantine_20260724/hidden-quarantine-20260723/.
• 3 playlists TEST_*_DELETE_ME borradas (restos de los tests del DJ: library_sync_back de MA no propagó el borrado a Navidrome — gotcha).
• Script de backup v4: el run del 25-jul murió sin dejar rastro (sin línea de fin, tarball 2G más pequeño) y el del 19-jul quedó truncado tras un "Terminated" — un backup truncado que no avisa es peor que uno fallido. v4 añade: trap que loguea si lo matan, snapshot transaccional de las DBs sqlite (navidrome.db + library.db de MA) antes del tar, y gzip -t del tarball al final. Última copia buena conocida: 24-jul (18G, verificada por rc); la del 19 la purga la retención de 7 días sola.
• Warmer de imágenes de artista: el fix Last.fm del 23-jul rellena perezosamente (solo al abrir cada artista) — 3.243/3.252 seguían grises. /home/monxas/scripts/warm-artist-images.sh recorre getArtistInfo2 para todos a 2/s (one-shot, re-ejecutable).

Backlog documentado (decisión pendiente, no ejecutado):

• Segunda copia de backup fuera del NAS: hoy única copia en el mismo NAS que la biblioteca (/mnt/nfs_media/backups/appdata, retención 7d). El appdata de Navidrome Y de Music Assistant SÍ están dentro (verificado) — el gap es el destino único. Candidato natural: PBS.
• ~15-25 grupos de duplicados reales restantes (query título+álbum+ artista da 30 grupos; muestreo: algunos falsos positivos tipo interludios, otros reales tipo 05 Clocks.flac + 05 Clocks__1.flac). Pasada fina de dedup como la del 24-jul, otro día.
• ND_CONFIGFILE apunta a un fichero inexistente (arranca igual — cosmético).
• Ruido en logs a vigilar: plugin AudioMuse devolviendo 404 esporádicos y ráfagas HTTP 429 en getCoverArt del cliente "galaxy".

AudioMuse — postura de disponibilidad (documentada, sin cambios)¶

AudioMuse vive en bazzite (sobremesa .141), que puede apagarse. Estado auditado: vivo, clustering al día (run 43, kmeans con 85 clusters), y el boolean del auto-apagado nocturno (input_boolean.bazzite_auto_apagado_noche) está off por defecto — el riesgo real es solo un apagado manual. Tras la revisión de arquitectura del backend, ese riesgo está acotado: las llamadas a AudioMuse corren fuera del event loop con timeout de 8s, así que con bazzite apagado fallan la búsqueda/moods/similares del DJ (con error limpio) pero el transporte (play/pausa/volumen/colas) sigue funcionando. Migrar AudioMuse a VM 208 eliminaría el riesgo pero pierde la GPU (RTX 3080) que usa el análisis de biblioteca — decisión consciente de dejarlo donde está.

Grupos sincronizados (multi-altavoz, misma sala)¶

Reproducir la misma canción llamando por separado a cada altavoz NO sincroniza de verdad — cada uno arranca con su propia latencia de red y se oye desfasado/ con eco. La sincronía real cruza protocolos (Sonos nativo + AirPlay 2) vía el puente Sendspin (protocolo abierto de la Open Home Foundation, reloj maestro compartido — por eso el elapsed_time de altavoces agrupados sale idéntico hasta el último decimal, verificado con players/all).

players/cmd/group_many   {target_player, child_player_ids}     # agrupación EFÍMERA (no sobrevive reinicio)
players/create_group_player  {provider:"sync_group", name, members, dynamic:false}  # PERSISTENTE (recomendado)

Reproductor en la tablet familiar¶

Cliente Subsonic completo (artistas/álbumes/playlists/búsqueda/favoritos) embebido en el dashboard kiosk de Home Assistant (/homeassistant/www/tablet/, Fire Tablet + Fully Kiosk). Sigue el patrón de "capas takeover" ya existente en ese dashboard (#now-playing, #f1-live, #justeat-live).

• Entrada: botón flotante (FAB) abajo-derecha, siempre visible en home. Sin reproducción, es un botón circular; sonando, muta a una "pill" con carátula girando + control inline ("modo mixto" — convive con el resto del dashboard, no lo tapa). Se oculta bajo body.any-takeover (F1/TV/JustEat).
• Usuario Navidrome dedicado tablet (no admin) — credenciales en js/config.local.js (gitignored).
• Despliegue: SSH ha-addon + sudo tee (nunca scp a este host).

Code review completo del reproductor (2026-07-26)¶

Primera pasada de revisión completa de js/views/music.js (742→900 líneas, antes solo se había identificado el bug de z-index de arriba). Backups en la tablet: music.js.bak-20260726-codereview. Todo verificado con Playwright headless contra la tablet real antes de darlo por bueno.

• Scrobbles falsos (bug real, reproducible): loadCurrent() llamaba a scrobble() incondicionalmente, sin mirar si autoplay era true. Restaurar la cola en pausa al arrancar el dashboard (init() → loadCurrent(false)) o quitar de la cola la pista en pausa (removeFromQueue() → loadCurrent(!audio.paused)) registraba un "reproducido" en Navidrome sin que sonara ni un segundo. Fix: el "now playing" (Subsonic submission=false) solo se manda en el evento play real del <audio>; el scrobble de verdad (submission=true) solo al cruzar un umbral en tickSeek() — 50% reproducido o 4 minutos, la convención Subsonic/Last.fm que antes no existía en absoluto. Verificado: recargar con cola en pausa → cero peticiones a /rest/scrobble; reproducir de verdad → 1 petición submission=false inmediata, ninguna submission=true prematura.
• Auth Subsonic en claro → esquema salteado. p=<contraseña> por query string (quedaba en cada URL de stream/portada/scrobble, expuesto en logs de acceso y caché de red del WebView) sustituido por t=md5(pass+salt)& s=salt. MD5 propio en vanilla JS (sin dependencias, restricción del archivo) verificado contra los 6 vectores de prueba del RFC 1321 antes de usarlo. Verificado end-to-end: búsqueda, stream y portadas funcionando con el nuevo esquema, cero peticiones /rest/ fallidas.
• Condición de carrera navegando: renderArtists/renderPlaylists/ renderStackTop no comprobaban si su resultado seguía vigente tras el await — a diferencia de doSearch, que sí lo hacía. Abrir el artista A y volver atrás rápido a abrir B podía sobrescribir B con los datos de A si la respuesta de A llegaba tarde. Fix: navToken incrementado en cada navegación real (setSection/pushStack/MUS.home/MUS.crumb), comprobado antes de pintar.
• Cascada de saltos ante fallo de red: sin freno, un fallo del stream saltaba a la siguiente canción en 400ms, que fallaba igual, etc. — podía recorrer la cola entera en segundos. Para tras 3 fallos consecutivos.
• toggleStar/scrobble via call(): usaban fetch() directo, que no detecta que Subsonic responda HTTP 200 con status:"failed" en el JSON — un fallo real (permisos, id inválido) se trataba como éxito. Ahora usan call(), que sí valida el body.
• Fuga de memoria: _rowCtxStore (contexto de listas para reproducir en orden) crecía sin límite — cota LRU de 24 entradas, mismo patrón que _blobCache en core.js.
• Control de volumen ausente en "Sonando": en tablets ≤900px, .mus-bar- right (volumen + selector de salida) se oculta por CSS con el comentario "control desde Sonando" — pero renderNowPlaying() nunca lo implementaba, dejando el volumen inaccesible ahí. Añadido, reutilizando la lógica de arrastre ya existente (wireVolumeControl(), extraída de attachSeek()). Gotcha real al implementarlo: los IDs elegidos al principio (np-vol-track/np-vol-fill) ya existían en now-playing.js/index.html para el OTRO "ahora suena" (el de vídeo/Jellyfin, no música) — el choque de nombres hacía que getElementById devolviera el elemento equivocado (oculto, tamaño cero). Renombrado a mus-npv-track/mus-npv-fill.
• Código muerto eliminado (dos líneas sin efecto real, restos de una implementación anterior).

En dj.js (repasado por tercera vez): el desplegable de búsqueda ahora se cierra al tocar fuera (antes solo al vaciar el input), y S.selected ya no se queda con player_ids fantasma de altavoces que desaparecen.

Clientes iOS¶

Verificado en el código de cada repo qué soporta "top songs por artista" (getTopSongs) — Reddit recomienda Arpeggi pero NO lo tiene:

Gotchas críticos (resumen)¶

1. Navidrome agrupa por TAGS, no carpetas. ND_PID_ALBUM=folder para álbumes.
2. Lidarr es el dueño de los ficheros — no dedup manual, arreglar en su config.
3. /share en CF Access — sin él, no hay fotos de artista en móvil.
4. .lrc deben ser monxas:monxas — root no los deja leer a Navidrome.
5. ReplayGain con rsgain, no el plugin de beets (roto).
6. AudioMuse GPU: --security-opt=label=disable (SELinux) + PER_SONG_MODEL_RELOAD=false.
7. NFS raíz monxas:monxas — root:root rompe reproducción (ver NAS reboot).
8. NO desactivar ND_ENABLESHARING.
9. media_player.join de HA puede fallar en silencio para grupos cruzados Sonos+AirPlay — usar players/create_group_player nativo de MA (persistente).
10. El reproductor de la tablet puede tapar F1/JustEat si queda abierto — music no está en el orquestador refreshAll() (pendiente de arreglo).
11. mDNS duplicado en 208 — Music Assistant puede aparecer descubierta 2× en HA (~25 redes Docker anunciando por network_mode: host); es el mismo servidor, configurar solo la de 192.168.0.208:8095.

Reversibilidad / backups¶

• Cuarentenas de dedup (reversibles, con MANIFEST.txt): /mnt/nfs_media/_music_quarantine_20260724/{dedup2,dedup3}/.
• Backups DB Navidrome: navidrome.db.bak-*. La DB guarda playlists/favoritos/plays.
• beets: library.db.bak-*, config.yaml.bak-*.
• AudioMuse: embeddings en Postgres (volumen am-pgdata) → análisis resumible.
• Music Assistant: grupos sincronizados persistentes viven en config/players (provider sync_group) — sobreviven a reinicios del contenedor.
• Tablet: index.html/css/js con backups .bak-YYYYMMDD[-sufijo] en el propio directorio antes de cada cambio.

Operaciones comunes¶

# Re-escanear tras cambios de tags/ficheros
docker exec navidrome navidrome scan --full

# Re-tag de artistas contra MusicBrainz (arregla tildes/duplicados)
docker exec -d beets sh -c "beet import -q /music >> /tmp/reimport.log 2>&1"

# Estado análisis AudioMuse
sshpass -p alfagann ssh [email protected] \
  'curl -s localhost:8123/api/last_task | python3 -m json.tool'

# Medir duplicados de artista (script artdupes.py: normaliza NFKD, quita tildes)
docker cp navidrome:/data/navidrome.db /tmp/nav.db && python3 artdupes.py

# Lanzar clustering AudioMuse (genera playlists automáticas por género/mood/tempo)
curl -X POST http://192.168.0.141:8123/api/clustering/start \
  -H "Content-Type: application/json" -d '{"clustering_method":"kmeans","auto_parameter_discovery":true,...}'
# ver /api/config para los valores por defecto reales antes de lanzar

# Crear un grupo persistente en Music Assistant (Sonos+AirPlay sincronizados de verdad)
# ver docs de la API en projects/vera/music-dj.md — dj_group_players hace esto por Vera

Para el DJ conversacional de Vera (pedir música por vibra/mood por Telegram y que suene de verdad en un altavoz, con grupos sincronizados) ver Vera → DJ conversacional.