UGREEN-NAS-Lyrics-Downloader
Herramienta Python para descargar lyrics sincronizados (.lrc) a bibliotecas de música en UGREEN NAS con UGOS. Usa LRCLIB, soporta Docker y ejecución directa. Incluye generación de reportes JSON y configuración flexible vía variables de entorno para integración en flujos de trabajo multimedia locales
Ficha actualizada 27 sept 2026, 19:12 · upstream 27 sept 2026, 18:50 · release v1.0.2
Qué es UGREEN-NAS-Lyrics-Downloader
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El repositorio contiene un script Python (lyrics_downloader.py) diseñado específicamente para sistemas UGREEN NAS ejecutando UGOS, aunque es compatible con cualquier host Docker. Su función principal es escanear directorios de música, buscar coincidencias en la API de LRCLIB y descargar archivos .lrc sincronizados que se guardan junto a los archivos de audio originales. El sistema soporta múltiples formatos como MP3, FLAC y M4A, permitiendo también la escritura de etiquetas incrustadas o archivos secundarios según configuración.
La herramienta opera mediante un contenedor Docker preconfigurado con docker-compose.yaml o ejecuciones directas vía SSH/CLI. Incluye un archivo .env para gestionar rutas del host, permisos (PUID/PGID) y parámetros de operación como intervalos de escaneo o modo dry-run. Proporciona logs detallados en el contenedor y genera informes JSON (last_report.json) que resumen las acciones realizadas, incluyendo éxitos, saltos por archivos existentes y fallos de búsqueda.
Destaca por su ligereza y enfoque en la automatización de tareas específicas dentro del ecosistema UGREEN, evitando interfaces gráficas pesadas. Es ideal para usuarios técnicos que buscan mejorar la experiencia de reproducción en apps nativas como UGREEN Music al asegurar que los metadatos de letra estén disponibles localmente antes de que la aplicación realice su propia indexación.
- Automatizar el llenado de bibliotecas de música con letras sincronizadas en UGREEN NAS
- Preparar archivos de audio para ser detectados correctamente por la app nativa UGREEN Music
- Ejecutar tareas de mantenimiento de metadatos sin interfaz gráfica compleja
- Generar informes periódicos del estado de la biblioteca musical escaneada
- Soporte nativo para Docker y ejecución directa en terminal/SSH
- Configuración flexible mediante variables de entorno (.env) para rutas y permisos
- Capacidad de generar reportes JSON detallados del proceso de escaneo
- Detección automática de archivos .lrc existentes para evitar sobrescrituras innecesarias
- Compatibilidad con múltiples formatos de audio (MP3, FLAC, M4A, etc.)
- Depende de la disponibilidad y límites de tasa de la API externa LRCLIB
- Requiere acceso SSH o interfaz Docker del host para la gestión del servicio
- La integración en apps nativas puede requerir reinicio de la app tras el escaneo
- No incluye interfaz web propia, requiere ejecución programada o manual
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.
Copiar el repositorio al NAS (ej. /volume2/docker/). Configurar .env con HOST_MUSIC_DIR y PUID/PGID adecuados. Importar docker-compose.yaml en la app Docker de UGOS o ejecutar vía CLI docker compose up. Para escaneo continuo, establecer SCAN_INTERVAL_SECONDS > 0. Verificar logs para confirmar escritura de archivos .lrc.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.