qobuz-librarian
Herramienta para gestionar bibliotecas de audio lossless de Qobuz con interfaz web y CLI. Permite completar colecciones (gap-fill), mejorar calidad, reparar archivos corruptos y migrar estructuras de carpetas. Funciona en un único contenedor Docker integrando beets y streamrip.
Ficha actualizada 22 sept 2026, 14:47 · upstream 22 sept 2026, 14:07 · release v1.1.1
Qué es qobuz-librarian
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
qobuz-librarian es una aplicación para construir y mantener bibliotecas de audio lossless completas desde Qobuz. Utiliza una arquitectura basada en Python (FastAPI, Next.js) y se despliega mediante un único contenedor Docker que integra herramientas como beets, streamrip y ffmpeg. La herramienta permite rellenar huecos en la colección, actualizar archivos a mayor calidad si el servicio lo permite, reparar archivos truncados mediante ISRC y migrar bibliotecas existentes a una estructura de carpetas estandarizada.
La interfaz web principal facilita la gestión visual de descargas, revisiones de álbumes y descubrimiento musical (requiere API Last.fm). También ofrece un modo CLI para automatización o trabajos no supervisados. El sistema de cola es seguro ante fallos, permitiendo reanudar tareas interrumpidas sin perder el estado.
La configuración se maneja mediante variables de entorno y archivos JSON para backups. Es crucial asignar una ruta dedicada para la música (QL_MUSIC_DIR) y autenticarse con un token de Qobuz en lugar de contraseña. El despliegue soporta tanto entornos Docker nativos como WSL en Windows, manteniendo la compatibilidad con beets 2.14.0.
- Completar colecciones musicales faltantes (gap-fill) automáticamente
- Mejorar calidad de archivos existentes si Qobuz ofrece versiones superiores
- Reparar archivos FLAC truncados o corruptos usando ISRC
- Migrar bibliotecas locales a estructura Artist/Album (Year)
- Descubrir nuevos artistas y álbumes basándose en la API Last.fm
- Automatizar descargas y gestión de metadatos con CLI
- Único contenedor Docker que integra beets, streamrip y ffmpeg sin sidecars
- Sistema de cola crash-safe que sobrevive a reinicios y marca fallos
- Reparación de archivos basada en ISRC para evitar duplicados erróneos
- Backup JSON automático de la biblioteca con validación de integridad
- Interfaz web y CLI para uso interactivo o automatizado
- Gestión de versiones de álbumes (remasters/deluxe) sin descargar duplicados
- Requiere cuenta Qobuz Premium para acceso a calidad lossless
- Necesita autenticación con token de sesión, no contraseña directa
- Modo CLI requiere instalación manual de dependencias externas (beets/streamrip)
- Descubrimiento musical depende de API externa de Last.fm
- Migración de librerías existentes puede requerir espacio temporal duplicado
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.
Asigna QL_MUSIC_DIR a una carpeta dedicada, no al home. Usa WSL en Windows o Git Bash. En redes compartidas, bloquea el acceso antes del primer inicio. Verifica que la imagen Docker sea 'healthy' tras actualizar. No usar docker compose restart para actualizaciones de imagen; usa pull y up -d.
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.