# spotDL: download spotify playlists

Canonical URL: https://geekist.co/github/spotdl-download-spotify-playlists/
Source repository: https://github.com/spotDL/spotify-downloader
Topics: Media Tools

[Stars26.8k](https://github.com/spotDL/spotify-downloader "spotDL/spotify-downloader - Stars: 26.8k")[Forks2.3k](https://github.com/spotDL/spotify-downloader "spotDL/spotify-downloader - Forks: 2.3k")[Updated22d ago](https://github.com/spotDL/spotify-downloader "spotDL/spotify-downloader - Updated: 22d ago")

## **What it is**

[`spotDL`](https://github.com/spotDL/spotify-downloader) is a tool that helps you download your favorite Spotify playlists and songs from YouTube, along with their album art and metadata, so you can listen to them offline. Music lovers get access to their playlists without needing an internet connection, making it easier to enjoy music on-the-go or in areas with poor connectivity. By downloading the highest possible bitrate of each song, spotDL ensures that your music stays high-quality, even when stored locally.

## **What’s new**

Recent v4 updates focused on stability and modern Python support, plus a handy sync mode that keeps a local folder in step with a playlist, adding new tracks and removing ones you’ve taken out, so your offline copy stays fresh.

## **What else is similar to it**

Music lovers sometimes turn to [yt-dlp](https://geekist.co/github/yt-dlp-an-audio-video-downloader/), for quick audio grabs, though it’s not built around Spotify. [Deemix](https://deemix.org/) (for Deezer) is another community favorite. They all aim to turn streaming music into personal collections.  
For a comparison across categories – including images, streams, and general videos – see our [5 Best Downloaders](/the-5-best-downloaders-for-videos-music-images-no-browser-needed/)

## **Why it’s different**

spotDL is built around Spotify first: paste a Spotify link and you get tagged, named, cover-art-ready tracks. The sync workflow makes ongoing playlist mirroring painless.

## **How to get started**

Choose a tab for what you need next. Work through the steps in order, then use the checks if you get stuck.

1.  Install Python and open Terminal or PowerShell; on Windows choose “Add Python to PATH” during setup.
2.  Run `python -m pip install spotdl`. Some Macs and Linux systems use `python3` instead.
3.  Install FFmpeg for audio conversion: `spotdl --download-ffmpeg` installs a copy for spotDL.

1.  Open the folder where you want the files saved.
2.  Copy a Spotify track or playlist link and run `spotdl download "SPOTIFY_URL"`, replacing the placeholder.
3.  Check the terminal output and open the downloaded files in that folder. spotDL matches Spotify metadata to audio from other sources.

1.  If spotDL is not found, reopen the terminal and check Python’s scripts folder is on PATH.
2.  A missing or incorrect match can occur; check the output before relying on it. The project also recommends Deno for some YouTube downloads.
3.  Only download material you have permission to use.

[Official setup instructions](https://github.com/spotDL/spotify-downloader/blob/master/docs/installation.md)

