spotdl
Download your Spotify playlists and songs along with album art and metadata
Decision gist · record as of 2026-08-14
Yes, if you accept the legal responsibility for downloading music and have or can install FFmpeg and Deno. spotDL is actively maintained, has low install friction, carries no known vulnerabilities, and offers a mature feature set for playlist backup and sync. The MIT license is permissive. Install it if offline Spotify access is your goal; skip it if you need lossless audio or have legal concerns about YouTube-sourced downloads.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- FFmpeg is required; install via `spotdl --download-ffmpeg` or system package manager.
- Deno is strongly recommended for reliable YouTube downloads, especially for videos marked 'made for kids'.
- Low friction install with a pure Python wheel.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions, making it safe for personal and commercial projects.
last release 2026-07-20 (25 days) · last repo commit 2026-08-12 · 25,782 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 290,310 downloads/mo, #7,991 on PyPI
Alternatives
Verify before relying
pip install spotdl
spotdl download "https://open.spotify.com/track/..."
# or for a playlist:
spotdl download "https://open.spotify.com/playlist/..."- Whether the 128 kbps bitrate from regular YouTube accounts is acceptable for your use case, or if 256 kbps (YouTube Music premium) is necessary.
- Legal status of downloading copyrighted music in your jurisdiction—spotDL disclaims responsibility for user actions.
What it is and what it does
spotDL is a command-line tool that fetches songs from Spotify playlists and downloads them from YouTube, automatically embedding album art, lyrics, and metadata into the resulting audio files. It supports multiple operations: downloading individual tracks or entire playlists, syncing directories to keep them in sync with playlist changes, saving metadata without downloading, and updating metadata on existing files.
The tool depends on a large ecosystem of music and web libraries—Spotify API clients (spotipy, spotipyfree), YouTube downloaders (yt-dlp, ytmusicapi), metadata handlers (mutagen), and a web interface built on FastAPI and Jinja2. It requires FFmpeg for audio processing and recommends Deno for reliable YouTube access. The package is actively maintained, supports Python 3.10 through 3.14, and has no known security vulnerabilities.
Use it for
- Backup Spotify playlists as local files with full metadata and album art intact.
- Keep a local music directory synchronized with a Spotify playlist, automatically downloading new additions and removing deleted tracks.
- Download individual songs from Spotify for offline listening without a premium subscription.
- Batch-update metadata and album art on existing music files using the `meta` operation.
- Access a web interface for downloading single songs when command-line usage is inconvenient.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you accept the legal responsibility for downloading music and have or can install FFmpeg and Deno.
spotDL is actively maintained, has low install friction, carries no known vulnerabilities, and offers a mature feature set for playlist backup and sync. The MIT license is permissive. Install it if offline Spotify access is your goal; skip it if you need lossless audio or have legal concerns about YouTube-sourced downloads.
Install
spotdl on PyPI
Before you install
Low friction install with a pure Python wheel. Actively maintained with a recent release; however, it requires external system dependencies (FFmpeg mandatory, Deno recommended) that must be installed separately or via spotDL's own download commands.
FFmpeg is required; install via `spotdl --download-ffmpeg` or system package manager. Deno is strongly recommended for reliable YouTube downloads, especially for videos marked 'made for kids'.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it safe for personal and commercial projects.
Quickstart
pip install spotdl
spotdl download "https://open.spotify.com/track/..."
# or for a playlist:
spotdl download "https://open.spotify.com/playlist/..."Verify before relying
- Whether the 128 kbps bitrate from regular YouTube accounts is acceptable for your use case, or if 256 kbps (YouTube Music premium) is necessary.
- Legal status of downloading copyrighted music in your jurisdiction—spotDL disclaims responsibility for user actions.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <3.15,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 21 packagesbeautifulsoup4datastar-pyfastapijinja2mutagenplatformdirspydanticpykakasipython-multipartpython-slugifyrapidfuzzrequestsrichsoundcloud-v2spotipyspotipyfreesyncedlyricsuvicornwebsocketsyt-dlpytmusicapi |
| Maintenance | Actively maintained 25 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 290,310 / month, #7,991 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: End Users/DesktopLicense :: OSI Approved :: MIT LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: MultimediaTopic :: Multimedia :: Sound/AudioTopic :: Utilities |
Evidence: spotdl-4.5.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “spotify playlist downloader”
- spotdlspotDL downloads songs from Spotify playlists on YouTube, embedding…
- spotapiSpotAPI wraps Spotify's private and public APIs to search, retrieve,…
- spotipySpotipy is a Python client library for the Spotify Web API that…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also pytube · syncedlyrics · spotapi · youtube_dl · ytmusicapi · spotipyFree · eyeD3 · spotipy · pytubefix · musicbrainzngs