music-monitor
Herramienta de orquestación para NAS que automatiza la descarga de música desde plataformas como NetEase, QQ y Kugou. Actúa como cerebro lógico (FastAPI) delegando la tarea física a go-music-dl.
Ficha actualizada 22 sept 2026, 16:03 · upstream 22 sept 2026, 13:03 · release sin release detectada
Qué es music-monitor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
music-monitor es una aplicación de Python basada en FastAPI diseñada para funcionar como capa de orquestación sobre el motor de descarga go-music-dl. Su función principal es actuar como un 'cerebro' que decide qué música descargar, mientras que go-music-dl actúa como las 'manos' que ejecutan la descarga real. El sistema está diseñado específicamente para entornos NAS, permitiendo a los usuarios configurar monitorización automática de listas de reproducción, álbumes y artistas favoritos.
- Monitorizar listas de éxitos oficiales (Top 500,飙升榜) de plataformas como QQ Music o NetEase Cloud Music
- Descargar automáticamente nuevas canciones cuando se añaden a colecciones personales favoritas en la app móvil
- Seguir lanzamientos de artistas específicos filtrando versiones no deseadas (Live, DJ, Remix)
- Complementar fuentes de audio entre múltiples plataformas buscando la mejor calidad disponible
- Arquitectura modular clara: separación estricta entre lógica de decisión (monitor) y ejecución de descarga (engine)
- Filtrado inteligente de versiones: prioriza ediciones oficiales y descarta automáticamente fragmentos de prueba o remixes
- Soporte nativo para Docker Compose con configuración optimizada para entornos NAS como fnOS
- Mecanismo de retry automático por canción individual para evitar fallos en cascada al descargar grandes listas
- Dependencia crítica de cookies válidas de plataformas para acceder a calidad superior (FLAC/Hi-Res)
- No soporta Apple Music nativamente debido a limitaciones técnicas en la API subyacente
- Requiere configuración manual inicial de permisos y rutas de volúmenes en el sistema de archivos
- La monitorización de artistas depende de búsqueda por texto, lo que puede generar falsos positivos si los nombres son similares
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utiliza Docker Compose con dos servicios: music-monitor (puerto 9090) y go-music-dl (puerto 8085). Es obligatorio persistir las carpetas config/engine, config/monitor y data/downloads. Para entornos NAS como fnOS, se recomienda montar el directorio de música en modo solo lectura (:ro) desde la perspectiva del contenedor monitor para evitar corrupción de archivos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.