spotify-saver
Herramienta para descargar música desde Spotify usando YouTube Music como fuente, con metadatos completos para Jellyfin. Soporta CLI, API RESTful e interfaz web.
Ficha actualizada 18 sept 2026, 20:52 · upstream 17 dic 2025, 2:18 · release 0.7.5
Qué es spotify-saver
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SpotifySaver es una herramienta todo-en-uno diseñada para descargar y organizar música utilizando la API de YouTube Music como fuente principal, mientras incorpora metadatos de Spotify para crear bibliotecas enriquecidas en Jellyfin. El proyecto conecta ambas APIs para generar archivos .nfo XML que completan los requisitos de metadatos de Jellyfin al construir librerías musicales.
La aplicación ofrece múltiples modos de operación: interfaz web con progreso en tiempo real, línea de comandos completa y API RESTful para integraciones externas. Soporta conversión a MP3/M4A, descarga de letras sincronizadas (.lrc), portadas de álbumes y estructura de carpetas automática por artista/álbum.
El proyecto está construido con FastAPI en Python 3.8+, utiliza yt-dlp como motor de descarga, FFmpeg para procesamiento de audio y Redis para caché. Incluye soporte Docker nativo con imágenes pre-construidas en GitHub Container Registry y Docker Compose para despliegue simplificado.
- Descargar álbumes o playlists completas de Spotify usando YouTube Music como fuente
- Generar archivos .nfo XML compatibles con Jellyfin para bibliotecas musicales organizadas
- Crear interfaz web local para descargar música sin usar línea de comandos
- Integrar en sistemas automatizados mediante API RESTful con progreso en tiempo real
- Convertir audio a formatos específicos (MP3, M4A) con control de bitrate
- Soporte nativo para Docker con imágenes oficiales en ghcr.io y archivos docker-compose.yml
- Generación automática de metadatos Jellyfin (.nfo XML) con estructura Artist/Album
- Interfaz web moderna con validación de URLs, progreso en tiempo real y logs detallados
- Compatibilidad con yt-dlp 2023.7.6+ para máxima compatibilidad con restricciones geográficas
- Soporte para letras sincronizadas (.lrc) desde LRC Lib integrado
- Requiere cuenta desarrolladora de Spotify con app registrada (client_id y client_secret obligatorios)
- Dependencia externa de FFmpeg instalado en el sistema o en la imagen Docker
- El archivo .nfo para Jellyfin está marcado como 'Still some things to work on' indicando desarrollo activo
- La interfaz web requiere que el servidor API esté ejecutándose (spotifysaver-api)
- En desarrollo activo con cambios constantes según advertencia en README
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: usar docker-compose.yml con volumen para persistencia de música y config. Variables obligatorias: SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET, SPOTIFY_REDIRECT_URI. Puerto por defecto 8000. Requiere Python 3.8+ o imagen Docker pre-construida. Verificar permisos de escritura en directorios de salida antes de iniciar.
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.