musicflow
Herramienta web ligera para buscar y descargar música desde múltiples plataformas chinas (NetEase, QQ Music) a un repositorio local compatible con reproductores como Navidrome o Swing Music. Incluye gestión automática de metadatos ID3, portadas y letras sin autenticación por defecto.
Ficha actualizada 28 sept 2026, 8:14 · upstream 28 sept 2026, 8:07 · release sin release detectada
Qué es musicflow
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
MusicFlow es una herramienta de búsqueda y descarga de música diseñada para alimentar bibliotecas locales desde múltiples fuentes chinas, incluyendo NetEase, QQ Music, Kugou y más. Permite realizar búsquedas rápidas mediante una interfaz web sencilla y descargar archivos directamente a un directorio compartido por reproductores externos como Navidrome o Swing Music.
El sistema utiliza FastAPI en el backend para gestionar las peticiones de búsqueda y descarga, mientras que la interfaz de usuario es un archivo HTML único que soporta selección en masa y seguimiento de tareas. Tras la descarga, el software realiza automáticamente la extracción de metadatos ID3, portadas y letras (LRC), asegurando que los archivos estén listos para su reproducción inmediata sin necesidad de escaneo manual.
Es importante destacar que la herramienta no incluye autenticación por defecto, lo que exige precauciones estrictas al desplegarla en entornos accesibles desde internet. Además, opera bajo una licencia PolyForm Noncommercial, lo que restringe su uso a fines educativos o personales y prohíbe cualquier explotación comercial.
- Construir una biblioteca local libre de DRM utilizando música de plataformas chinas populares.
- Alimentar un servidor Navidrome o similar con música descargada automáticamente desde múltiples fuentes.
- Gestionar metadatos (ID3, portadas y letras) al instante tras la descarga sin intervención manual.
- Probar y comparar resultados de búsqueda entre diferentes proveedores de audio en una sola interfaz.
- Soporte nativo para múltiples APIs chinas como NetEase, QQ Music y Kugou mediante el motor musicdl.
- Integración directa con reproductores externos vía sistema de archivos compartido (no requiere base de datos interna).
- Gestión automática de metadatos y letras sin intervención manual tras la descarga.
- Arquitectura ligera basada en FastAPI y HTML estático, optimizada para bajo consumo de recursos.
- No incluye autenticación por defecto, lo que representa un riesgo de seguridad si se expone a internet sin protección adicional.
- Licencia PolyForm Noncommercial impide el uso comercial o la distribución monetaria del software.
- Dependencia de APIs externas que pueden cambiar sus estructuras o políticas sin aviso previo.
- La descarga es secuencial (serial), lo que puede ralentizar el proceso con grandes volúmenes de datos.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliegue recomendado en contenedor Docker con volumen persistente para `/music`. No exponer puerto 8000 a internet sin autenticación. Configurar `MUSIC_SOURCES` según disponibilidad regional. Asegurar que el directorio destino tenga permisos de escritura correctos.
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.