Descargador de Spotify
spotDL es un descargador de Spotify gratuito y de código abierto que convierte canciones, álbumes, listas de reproducción y artistas en archivos de audio locales y organizados - con metadatos, carátula del álbum y letras incluidas.
Spotify proporciona la información de la canción y de la lista. El audio procede de YouTube Music, YouTube u otro proveedor configurado - no de Spotify.
Enlaces de Spotify a la entrada. Archivos bien organizados a la salida.
El streaming es estupendo para descubrir y organizar música, pero no te da archivos de audio normales que puedas gestionar por tu cuenta. spotDL conecta esos dos flujos de trabajo.
Un enlace de Spotify aporta detalles estructurados - título de la canción, artista, álbum, fecha de lanzamiento, número de pista y carátula. spotDL busca una coincidencia adecuada en un proveedor compatible, descarga el audio, lo convierte cuando es necesario e incrusta los metadatos. El resultado es una colección de música portátil, y no una carpeta llena de descargas sin identificar.
Cómo funciona spotDL
Tres pasos desde un enlace de Spotify hasta un archivo de música etiquetado y listo para reproducir.
Añade un enlace de Spotify o una búsqueda
Pega un enlace a una canción, un álbum, una lista de reproducción o un artista - o encuentra una canción con una simple búsqueda de texto. Puedes incluir varios enlaces y búsquedas en el mismo comando.
spotDL encuentra el audio
spotDL lee los metadatos de Spotify y busca en YouTube Music de forma predeterminada. La coincidencia y el filtrado distinguen la grabación deseada de versiones, remezclas, directos y resultados no relacionados.
Guarda un archivo de música completo
El audio se procesa con FFmpeg y, a continuación, los metadatos, la carátula y las letras disponibles se incrustan automáticamente - con el formato, las carpetas, los nombres de archivo y el comportamiento de sobrescritura totalmente configurables.
Más que un simple descargador
Una aplicación centrada en convertir enlaces de Spotify en una biblioteca de música estructurada y fácil de mantener.
Canciones, álbumes, listas y artistas
Acepta URL de Spotify de canciones individuales, álbumes completos, listas de reproducción y páginas de artistas - además de búsquedas de texto y lotes mixtos.
Coincidencia automática de canciones
Los metadatos de Spotify construyen y filtran la búsqueda para identificar una grabación adecuada, en lugar del primer vídeo vagamente relacionado.
Metadatos incrustados
Título, artistas, álbum, artista del álbum, carátula, números de pista y de disco, año, género, sello, ISRC, ID de Spotify y letras.
Letras y archivos .lrc sincronizados
Reúne letras de Genius, Musixmatch o AZLyrics y genera archivos .lrc sincronizados independientes para reproductores compatibles.
Seis formatos de salida
MP3, M4A, Opus, OGG, FLAC y WAV - elige el que necesite tu reproductor o flujo de trabajo.
Nombres de archivo y carpetas configurables
Las plantillas de salida crean una biblioteca {artist}/{album} predecible, en lugar de una carpeta única con nombres incoherentes.
Generación de listas M3U
Crea archivos de lista M3U o M3U8 junto al audio, incluido un archivo independiente por lista en un trabajo con varias listas.
Control de duplicados y sobrescritura
Omite, actualiza los metadatos, fuerza una nueva descarga, busca canciones existentes o mantén un archivo de las descargas completadas.
Varios proveedores de audio
YouTube Music de forma predeterminada, con YouTube, SoundCloud, Bandcamp, Piped y slider.kz como alternativas o respaldos.
Sincronización de listas
Un archivo de sincronización .spotdl mantiene una carpeta local alineada con una lista o un álbum de Spotify que cambia con el tiempo.
Configuración reutilizable
Guarda una vez tus formatos, plantillas, proveedores, hilos y reglas preferidos - se cargan automáticamente en cada ejecución.
Interfaz web local
Una interfaz de navegador sencilla para descargas individuales, alojada en tu propio equipo - no un servicio de conversión remoto.
Descargar spotDL
Aplicación precompilada: abrirla sin argumentos inicia la interfaz web local para descargas sencillas de canciones individuales. La sincronización de listas, los trabajos por lotes y los controles avanzados están en la línea de comandos. FFmpeg sigue siendo necesario (spotdl --download-ffmpeg) y se recomienda Deno (spotdl --download-deno).
Instalar con Python
La instalación a través de Python es la recomendada para un uso habitual, actualizaciones, automatización y el conjunto completo de funciones de la línea de comandos. Requisitos: Python 3.10-3.14, FFmpeg 4.2+, Deno recomendado y el Visual C++ Redistributable en Windows.
Docker
Una imagen mantenida es adecuada para servidores, sistemas NAS y entornos reproducibles. El directorio de música montado debe tener permisos de escritura para el usuario del contenedor.
Termux, Arch y compilación desde el código fuente
spotDL también se instala en Android mediante Termux, a través del Arch User Repository o compilando el ejecutable desde el código fuente con uv.
Componentes necesarios
FFmpeg
FFmpeg es necesario para procesar, convertir y etiquetar el audio. Instálalo directamente en el directorio de spotDL, o en todo el sistema mediante tu gestor de paquetes.
Deno
Deno es muy recomendable: las descargas actuales de YouTube a través de yt-dlp pueden requerir un entorno de ejecución de JavaScript. Sin él, algunas pistas pueden fallar, incluidos ciertos vídeos marcados como dirigidos a menores.
Autenticación de Spotify
Los enlaces públicos funcionan para los flujos de trabajo estándar de canciones, álbumes, listas, artistas y búsquedas. El acceso a los datos privados de la cuenta - canciones que te gustan, listas personales, artistas seguidos, álbumes guardados - requiere autenticación de Spotify, y algunos atajos también necesitan la opción de la API oficial de Spotify con credenciales válidas.
Empieza con un solo comando
La operación predeterminada es download. Los archivos se guardan en la carpeta en la que ejecutas spotDL, salvo que se defina una ruta --output.
Si el comando spotdl no está disponible pero el paquete está instalado, ejecútalo como módulo con python -m spotdl [query] (o python3 -m spotdl en macOS / Linux).
Elegir una coincidencia concreta de YouTube
La coincidencia automática busca la grabación deseada, pero puedes asociar una fuente concreta de YouTube con los metadatos de Spotify cuando quieres un control exacto sobre el audio utilizado.
Descargar una biblioteca personal de Spotify
Los atajos autenticados pueden procesar las canciones que te gustan, todas tus listas, las listas guardadas, los artistas seguidos y los álbumes guardados. Requieren autenticación de Spotify; el flujo de trabajo actual con la API oficial está pensado para cuentas de Spotify Premium.
Las opciones de autenticación incluyen --user-auth, --use-official-api, --client-id, --client-secret, --auth-token, --cache-path, --no-cache, --headless y --max-retries. Trata las credenciales y los tokens como privados - nunca los subas a un repositorio público.
Seis operaciones principales
download
Descarga el audio e incrusta los metadatos disponibles.
save
Reúne los metadatos de Spotify en un archivo .spotdl sin descargar el audio.
sync
Mantiene una carpeta local alineada con una lista o un álbum de Spotify.
meta
Actualiza los metadatos, la carátula y las etiquetas de archivos de audio existentes.
url
Resuelve las canciones de una consulta en sus URL de audio correspondientes.
web
Inicia la interfaz web local en el navegador.
Mantén tus listas locales sincronizadas
Una lista descargada no tiene por qué convertirse en una instantánea obsoleta. La operación sync compara tu carpeta local con la fuente actual de Spotify: las pistas nuevas se descargan y las pistas eliminadas de la fuente pueden eliminarse localmente.
De forma predeterminada, sync refleja la fuente y puede eliminar las pistas retiradas de Spotify. Usa --sync-without-deleting para conservar los archivos locales, o --sync-remove-lrc para eliminar también los archivos .lrc correspondientes cuando se retiran canciones. Ideal para listas que cambian cada semana y para actualizaciones automatizadas de la biblioteca.
Cómo funciona la coincidencia de canciones
spotDL construye una búsqueda a partir de los datos de Spotify - título, artistas, álbum, duración, tipo de lanzamiento - y evalúa los resultados candidatos, valorando si un resultado está verificado y vigilando los términos asociados a directos, remezclas, versiones y grabaciones alternativas. Reduce el riesgo de obtener una subida no relacionada, pero ningún sistema de coincidencia es perfecto.
Controla la coincidencia con --search-query (plantilla personalizada), --dont-filter-results, --only-verified-results, --album-type, o una asociación manual YouTubeURL|SpotifyURL para una fuente exacta.
Proveedores de audio
YouTube Music es la opción predeterminada. Configura varios proveedores por orden de respaldo - si el primero no puede devolver un resultado adecuado, spotDL prueba el siguiente.
La disponibilidad de los proveedores, el acceso regional, la autenticación, la calidad de audio y la precisión de búsqueda varían. No se garantiza que una canción de Spotify esté disponible en un proveedor de audio determinado.
Seis formatos de salida
Elige el formato que necesite tu reproductor de destino o tu flujo de trabajo. Defínelo con --format.
MP3
La opción predeterminada. Amplia compatibilidad con reproductores, coches, teléfonos, servidores multimedia y hardware más antiguo.
M4A
Útil cuando la fuente ya es compatible y conviene evitar una transcodificación innecesaria.
Opus
Compresión eficiente que puede preservar la fuente sin otra conversión cuando los ajustes lo permiten.
OGG
Para reproductores y flujos de trabajo que requieren un formato de contenedor abierto.
FLAC
Para el etiquetado y la estandarización de la biblioteca. Convertir una fuente con pérdidas a FLAC no recupera el audio perdido.
WAV
PCM sin comprimir para aplicaciones que lo requieren. Archivos más grandes, sin ganancia de calidad frente a una fuente con pérdidas.
Calidad de audio, sin afirmaciones engañosas
spotDL descarga el audio disponible en el proveedor seleccionado. No descarga las propias transmisiones de Spotify y no puede crear una calidad que falte en la fuente. Las fuentes estándar de YouTube suelen ofrecer hasta 128 kbps; los usuarios de YouTube Music Premium pueden alcanzar 256 kbps con cookies autenticadas y ajustes compatibles de M4A u Opus.
Elegir 320 kbps, FLAC o WAV no convierte una fuente de menor tasa de bits en mayor calidad - solo crea un archivo más grande. Para un procesamiento mínimo, usa M4A u Opus con la conversión desactivada; para una compatibilidad máxima, usa el MP3 predeterminado.
La tasa de bits acepta tasas constantes de 8 a 320 kbps, niveles variables de 0 a 9, auto (coincidir con la fuente) o disable. Con M4A y Opus, auto o disable pueden omitir la conversión cuando la fuente ya es compatible.
Metadatos, carátula y letras
Los archivos pueden incluir todo lo que esperan un reproductor y un gestor de biblioteca modernos. Los metadatos también pueden aplicarse a audio existente con la operación meta.
La carátula del álbum se incrusta de forma predeterminada. Para las listas, --playlist-numbering usa el título y la imagen de la lista como álbum/carátula, mientras que --playlist-retain-track-cover conserva la carátula propia de cada pista. Las letras provienen de Genius, Musixmatch o AZLyrics por orden de respaldo, y un proveedor sincronizado puede generar archivos .lrc independientes.
Controlar los nombres de archivo y carpeta
La plantilla predeterminada es {artists} - {title}.{output-ext}. Una plantilla personalizada puede definir nombres de archivo, directorios o ambos - produciendo una biblioteca predecible en lugar de una carpeta única.
| Variable | Significado |
|---|---|
{title} | Título de la canción |
{artists} | Todos los artistas de la canción |
{artist} | Artista principal |
{album} | Título del álbum |
{album-artist} | Artista principal del álbum |
{genre} | Género |
{year} | Año de lanzamiento |
{original-date} | Fecha de lanzamiento original |
{track-number} | Número de pista en el álbum |
{tracks-count} | Total de pistas en el álbum |
{disc-number} | Número de disco |
{isrc} | Código Internacional Normalizado de Grabación (ISRC) |
{track-id} | ID de pista de Spotify |
{publisher} | Editorial o sello discográfico |
{list-name} | Nombre de la lista o colección |
{list-position} | Posición en la lista |
{output-ext} | Extensión del archivo de salida |
Limita la longitud con --max-filename-length y depura los nombres para la compatibilidad con dispositivos con --restrict strict|ascii|none. El sistema operativo aún puede imponer una ruta máxima más corta.
Controles de biblioteca y automatización
Listas M3U
Genera archivos M3U o M3U8 junto al audio con --m3u, elige un nombre con --m3u "My Playlist.m3u8", o un archivo por lista con --m3u "{list}". Registra las canciones no disponibles en los archivos M3U y de archivo con --add-unavailable.
Duplicados y sobrescritura
Tres modos de sobrescritura - --overwrite skip (conservar lo existente), --overwrite metadata (actualizar etiquetas, conservar el audio) y --overwrite force (volver a descargar). Añade --scan-for-songs para detectar pistas existentes, --archive para registrar las descargas completadas, y --create-skip-file / --respect-skip-file para trabajos por lotes idempotentes.
Filtrar la colección
Omite las pistas explícitas con --skip-explicit, ignora los álbumes con --ignore-albums, obtén los álbumes de una canción con --fetch-albums, limita el tipo de lanzamiento con --album-type single|album|compilation, acepta solo resultados verificados con --only-verified-results, o desactiva el filtrado con --dont-filter-results.
Gestionar errores en descargas grandes
Los trabajos largos pueden contener pistas no disponibles, restricciones regionales y fallos de proveedores. Muestra un resumen con --print-errors o guárdalo con --save-errors errors.txt, para poder procesar primero una colección grande y revisar las excepciones después.
Controles de descarga avanzados
Ajusta el rendimiento y el comportamiento con --threads, --ffmpeg / --ffmpeg-args, --yt-dlp-args, --proxy http://host:port, --sponsor-block y --detect-formats. Los argumentos de herramientas personalizados están pensados para usuarios experimentados y pueden entrar en conflicto con los valores predeterminados de spotDL.
Ejecutar la interfaz web local
Inicia la interfaz de navegador con spotdl web. Está alojada localmente - no en un servicio de conversión remoto - y es ideal para descargas sencillas de canciones individuales. Configúrala con --host, --port (predeterminado 8800), --keep-alive, --allowed-origins y opciones TLS (--enable-tls, --cert-file, --key-file). Usa --web-use-output-dir para seguir tu ubicación --output habitual.
Guardar la configuración una vez
Genera un archivo de configuración con spotdl --generate-config; se carga automáticamente en cada ejecución. Puede almacenar proveedores, formatos, tasa de bits, plantillas de salida, ajustes de FFmpeg/yt-dlp, hilos, archivos de cookies, proxy, reglas de sobrescritura, comportamiento de sincronización y ajustes de la interfaz web. Desactiva la carga automática con { "load_config": false }.
Registro y diagnóstico
Define el nivel de detalle con --log-level (CRITICAL → DEBUG, más un nivel MATCH), simplifica el terminal con --simple-tui, personaliza la salida con --log-format, perfila con --profile y ve todo con spotdl --help.
Diseñado para bibliotecas de música reales
Lleva una lista seleccionada sin conexión
Convierte una lista de reproducción de Spotify en archivos estándar para un portátil, un teléfono, el coche, un reproductor portátil o una biblioteca sin conexión.
Descarga lanzamientos completos
Procesa un álbum como un único trabajo conservando los números de pista y de disco, la información de lanzamiento y la carátula.
Crea una colección de un artista
Usa un enlace de artista para procesar el catálogo disponible sin enviar cada lanzamiento individualmente.
Mueve la música entre dispositivos
Los archivos no están vinculados a una sola aplicación - cópialos, haz copias de seguridad, renómbralos, indéxalos y reprodúcelos en cualquier lugar.
Mantén una biblioteca autoalojada
Las plantillas personalizadas y los metadatos estándar se adaptan a servidores de música, colecciones en NAS y carpetas de archivo.
Automatiza flujos de trabajo recurrentes
Los archivos de configuración, archivos, archivos de omisión, metadatos guardados y comandos de sincronización hacen reproducibles los trabajos repetidos.
Solución de problemas
Soluciones rápidas para los problemas de instalación y descarga más habituales.
«spotdl» no se reconoce en Windows+
Python o su carpeta Scripts no está en el PATH. Reinstala Python desde python.org y marca «Add Python to PATH», luego reinicia el terminal. El Python de Microsoft Store puede provocar problemas de resolución de comandos.
spotdl: command not found en Linux/macOS+
Falta en el PATH la carpeta bin de la instalación de usuario. Añádela y vuelve a cargar la configuración de tu shell:
Faltan dependencias de yt-dlp+
Instala o actualiza los paquetes necesarios:
AudioProviderError: YT-DLP download error+
Algunas descargas de YouTube necesitan un entorno de ejecución de JavaScript, incluidos ciertos vídeos marcados como dirigidos a menores. Instala Deno:
Error HTTP 404 en los metadatos de Spotify / error de recursión+
Una versión antigua puede depender de un comportamiento de la API que ha cambiado. Actualiza spotDL:
SSL: CERTIFICATE_VERIFY_FAILED+
Actualiza el almacén de certificados del sistema operativo y el paquete de certificados de Python. En macOS, ejecuta el script de instalación de certificados incluido con tu instalación de Python. Desactivar la verificación no es una solución segura.
Error _raw_ecb / Cryptodome en Apple Silicon+
Python y una dependencia compilada se instalaron para arquitecturas diferentes. Usa un Python nativo para Apple Silicon y reinstala las dependencias afectadas en el mismo entorno.
YouTube Music KeyError: 'header'+
Actualiza ytmusicapi y, si persiste, fuerza la reinstalación de spotDL. YouTube Music puede cambiar ocasionalmente su respuesta o activar un comportamiento anti-bot; volver a intentarlo más tarde puede resolverlo.
Preguntas frecuentes
¿Qué es spotDL?+
spotDL es un descargador de Spotify gratuito y de código abierto que convierte canciones, álbumes, listas de reproducción y enlaces de artistas de Spotify en archivos de audio locales y organizados. Usa Spotify para identificar la música y reunir los metadatos, y luego encuentra el audio correspondiente a través de proveedores compatibles como YouTube Music.
¿spotDL descarga el audio directamente de Spotify?+
No. Spotify proporciona información como el título, el artista, el álbum, la fecha de lanzamiento, el número de pista y la carátula. El audio en sí se descarga de YouTube Music, YouTube u otro proveedor configurado cuando hay una coincidencia adecuada disponible.
¿Puede spotDL descargar una lista de reproducción completa de Spotify?+
Sí. Un enlace de lista de reproducción puede procesarse como un único trabajo. spotDL encuentra el audio correspondiente, descarga cada pista disponible, incrusta los metadatos y organiza los archivos según tus ajustes de salida. Las listas grandes llevan tiempo y algunas pistas pueden omitirse cuando no se encuentra una coincidencia fiable.
¿Se pueden actualizar más tarde las listas descargadas?+
Sí. La operación de sincronización compara una colección local guardada con la lista de reproducción actual de Spotify. Las pistas nuevas se descargan automáticamente y las pistas eliminadas de Spotify también pueden borrarse de la carpeta. El borrado puede desactivarse con --sync-without-deleting.
¿Qué formatos de audio admite spotDL?+
spotDL admite MP3, M4A, Opus, OGG, FLAC y WAV. MP3 es el formato predeterminado y ofrece la mayor compatibilidad. M4A y Opus pueden reducir conversiones innecesarias cuando se usan con ajustes de fuente compatibles.
¿Puede spotDL descargar audio a 320 kbps o sin pérdidas?+
spotDL no puede crear una calidad que no exista en la fuente. Las fuentes estándar de YouTube suelen ofrecer hasta 128 kbps, mientras que las fuentes autenticadas de YouTube Music Premium pueden alcanzar 256 kbps. Elegir 320 kbps, FLAC o WAV solo convierte la fuente existente en un archivo diferente (a menudo mayor) - no recupera el audio que falta.
¿spotDL añade carátula del álbum, letras y metadatos?+
Sí. Según la disponibilidad y la configuración, los archivos pueden incluir el título, los artistas, el álbum, el artista del álbum, la carátula, los números de pista y de disco, la fecha de lanzamiento, el género, la editorial, el ISRC, el ID de pista de Spotify y las letras. spotDL también puede crear archivos de letras .lrc sincronizados.
¿Qué precisión tiene la coincidencia de canciones?+
spotDL utiliza los metadatos de Spotify para buscar y evaluar los resultados disponibles antes de descargar, lo que ayuda a distinguir la grabación de estudio de versiones, remezclas, directos y vídeos no relacionados. La coincidencia no es infalible - puedes asociar una URL concreta de YouTube con una canción de Spotify cuando se necesita un control exacto.
¿Existe una interfaz gráfica?+
Sí. spotDL incluye una interfaz web local para descargas individuales sencillas, que se ejecuta en tu propio ordenador en lugar de en un servicio remoto. La línea de comandos ofrece el conjunto completo de funciones, incluida la sincronización de listas, el procesamiento por lotes, los proveedores avanzados y la configuración.
¿Qué sistemas operativos admiten spotDL?+
spotDL funciona en Windows, macOS y Linux, con opciones de instalación para Docker, Termux, Arch Linux y compilaciones desde el código fuente. La compatibilidad depende del método elegido y de los componentes necesarios, como Python y FFmpeg.
¿Qué se necesita para ejecutar spotDL?+
FFmpeg es necesario para procesar, convertir y etiquetar el audio (instálalo con "spotdl --download-ffmpeg"). Deno es muy recomendable, ya que algunas descargas de YouTube necesitan un entorno de ejecución de JavaScript ("spotdl --download-deno"). La instalación recomendada es "pip install spotdl".
¿spotDL es gratuito?+
Sí. spotDL se distribuye bajo la Licencia MIT y puede descargarse, usarse, inspeccionarse, modificarse y redistribuirse según esos términos. No existe una suscripción de pago a spotDL. Las plataformas externas, los proveedores o las cuentas premium pueden tener sus propios términos y costes independientes.
¿spotDL está afiliado a Spotify o YouTube?+
No. spotDL es un proyecto de código abierto independiente y no está afiliado, patrocinado ni respaldado por Spotify, YouTube, Google ni ningún sello discográfico. Spotify y YouTube son marcas comerciales de sus respectivos propietarios.
¿Es legal usar spotDL?+
spotDL es una herramienta de software de uso general. Que una descarga concreta esté permitida depende de la música, la fuente, el uso previsto, la legislación de derechos de autor aplicable y los términos de las plataformas correspondientes. Descargar un archivo no otorga propiedad ni derechos de redistribución. Usa spotDL solo para audio que tengas permiso legal para descargar, copiar o procesar.
Crea una biblioteca de música que siga siendo portátil
Empieza con una canción, convierte una lista completa, o crea un flujo de trabajo local repetible con control total sobre formatos, metadatos, nombres de archivo y sincronización.