Popularity
8.5
Stable
Activity
8.9
Declining
5,388
140
737

Description

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

README

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

spotDL

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

The fastest, easiest, and most accurate command-line music downloader

What spotDL does

  1. Downloads music from YouTube as an MP3 file
  2. Applies basic metadata gathered from Spotify such as:
    • Track Name
    • Track Number
    • Album
    • Album Cover
    • Genre
    • and more!

⚠ We have dropped the active development of spotDL v2 due to support and maintainability. No focused efforts will be made to resolve v2 specific issues.

Prerequisites

  • Python 3.6 or above (added to PATH)
  • FFmpeg 4.3 or above (added to PATH)

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.

Installation

Installing FFmpeg

Installing spotDL

  • Recommended Stable Version:
  pip install spotdl
  • Dev Version: (NOT STABLE)
  pip install https://codeload.github.com/spotDL/spotify-downloader/zip/dev

If you have trouble installing spotdl take a look at the extended installation guide here or ask for help in our discord server

On Termux

curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/termux/setup_spotdl.sh | sh

Usage

  • #### To download a song, run
  spotdl [trackUrl]

example:

  spotdl https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b?si=1stnMF5GSdClnIEARnJiiQ
  • #### To download an album, run
  spotdl [albumUrl]

example:

  spotdl https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj?si=AssgQQrVTJqptFe7X92jNg
  • #### To download a playlist, run
  spotdl [playlistUrl]

example:

  spotdl https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID?si=oGd5ctlyQ0qblj_bL6WWow
  • #### To search for and download a song, run, with quotation marks
  spotdl '[songQuery]'

example:

  spotdl 'The Weeknd - Blinding Lights'

Note: This is not accurate and often causes errors.

  • #### To resume a failed/incomplete download, run
  spotdl [pathToTrackingFile]

example:

  spotdl 'The Weeknd - Blinding Lights.spotdlTrackingFile'

Note: .spotdlTrackingFiles are automatically created when a download starts and deleted on completion

  • #### You can queue up multiple download tasks by separating the arguments with spaces
  spotdl [songQuery1] [albumUrl] [songQuery2] ... (order does not matter)

example:

  spotdl 'The Weeknd - Blinding Lights' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID?si=oGd5ctlyQ0qblj_bL6WWow ...

Note: spotDL downloads up to 4 songs in parallel, so for a faster experience, download albums and playlist, rather than tracks.

pipx Isolated Environment Alternative

For users who are not familiar with pipx, it can be used to run scripts without installing the spotDL package and all the dependencies globally with pip. (Effectively skipping over the spotDL Installation step)

First, you will need to install pipx by running:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Next, you can jump directly to running spotDL with:

pipx run spotdl ...

Contributor Guide

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.

Contributors

contributors

Authors

  1. @ritiek for creating and maintaining spotDL for 4 years
  2. @rocketinventor for figuring out YouTube Music querying
  3. @MikhailZex for, never mind...

License

MIT


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