Bulk downloads your favorite Spotify playlists

Programming language: Python
License: MIT License
Tags: Downloader     Utilities     Multimedia     Sound     Youtube     Music     Spotify    

spotDL alternatives and similar packages

Based on the "Downloader" category.
Alternatively, view spotify-downloader alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of spotDL or a related project?

Add another 'Downloader' Package


<!--- mdformat-toc start --slug=github --->

<!--- !!! IF EDITING THE README, ENSURE TO COPY THE WHOLE FILE TO index.md in /docs/ --->

spotDL v4

Download your Spotify playlists and songs along with album art and metadata

MIT License PyPI version GitHub commits since latest release (by date) PyPi downloads Contributors Discord

A new and improved version of spotDL: still the fastest, easiest and most accurate command-line music downloader

Read the documentation on ReadTheDocs!


YouTube Music must be available in your country for spotDL to work. This is because we use YouTube Music to filter search results. You can check if YouTube Music is available in your country, by visiting YouTube Music.


Refer to our Installation Guide for more details

  • Python (Recommended)
    • spotDL can be installed by running pip install spotdl. > On some systems you might have to change pip to pip3.

Other options

  • Prebuilt Executable
  • On Termux
    • curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh
  • Arch
    • There is an Arch User Repository (AUR) package for spotDL.
  • Docker

    • Build image:
    docker build -t spotdl .
    • Launch container with spotDL parameters (see section below). You need to create mapped volume to access song files
    docker run --rm -v $(pwd):/music spotdl download [trackUrl]

Installing FFmpeg

If using FFmpeg only for spotDL, you can install FFmpeg to your local directory. spotdl --download-ffmpeg will download FFmpeg to your spotDL installation directory.

We recommend the above option, but if you want to install FFmpeg system-wide,

  • Windows Tutorial
  • OSX - brew install ffmpeg
  • Linux - sudo apt install ffmpeg or use your distro's package manager


To get started right away:

spotdl download [urls]

To start the Web UI:

spotdl web

You can run spotDL as a package if running it as a script doesn't work:

python -m spotdl [urls]

Further information can be found in our documentation

Read the documentation on ReadTheDocs!


Interested in contributing? Check out our [CONTRIBUTING.md](docs/CONTRIBUTING.md) to find resources around contributing along with a guide on how to set up a development environment.


This project is Licensed under the MIT License.

*Note that all licence references and agreements mentioned in the spotDL README section above are relevant to that project's source code only.