spotify-dl - Spotify Playlist Downloader

Downloads Spotify playlists in high quality without login by matching each track and downloading it from YouTube Music.

YouTube video demonstrating usage (binaries)

Features

• No premium subscription required
• No login required
• Lightweight
• Downloads in higher bitrate (around 300 kbps)
• With embed metadata (title, artist, album and album art, etc)

Warning

This program uses YouTube Music as the source for music downloads, there is a chance of mismatching.

This program is for educational purposes only. Users are responsible for complying with YouTube Music and Spotify's terms of service.

Usage

This program requires ffmpeg to work. Install ffmpeg and add the folder where ffmpeg.exe is located to PATH/system environment variables.

Unlike most downloader, this program does not require a Spotify Developers account.

Using Binaries (Windows Only)

1. Download the latest binaries from the release section.

2. Extract the files and navigate to the extracted folder.

3. Open command prompt/terminal and run the program with your playlist URL.

   spotify-dl.exe playlist_url

Available Options

• To get help on available options:

  spotify-dl.exe --help

• To specify where to store downloaded files:

  spotify-dl.exe -o path playlist_url

• To change audio format (for example mp3):

  spotify-dl.exe -f mp3 playlist_url

• To set how many songs are matched at the same time (default: 3. P.S. There is no hard limit set, but please don't go wild)

  spotify-dl.exe -c 5 playlist_url

• To enable yt-dlp's --download-archive option

  Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it.

  spotify-dl.exe --download_archive FILE playlist_url

• To save as <title> - <artist>.<ext> instead of the default <artist> - <title>.<ext>:

  spotify-dl.exe --title-first playlist_url

Using Source Code

1. Clone the repository.

   git clone https://github.com/invzfnc/spotify-downloader.git
   cd spotify-downloader

2. Create and activate a virtual environment (Optional but recommended).

   python -m venv venv
   venv\Scripts\activate.bat  # Windows
   # or
   source venv/bin/activate   # Linux/macOS

3. Install required dependencies.

   python -m pip install -r requirements.txt

4. Run the program with your playlist URL.

   python -m spotify-dl playlist_url

Available Options

• To get help on available options:

  python -m spotify-dl --help

• To specify where to store dowloaded files:

  python -m spotify-dl -o path playlist_url

• To change audio format (for example mp3):

  python -m spotify-dl -f mp3 playlist_url

• To set how many songs are matched at the same time (default: 3. P.S. There is no hard limit set, but please don't go wild)

  python -m spotify-dl -c 5 playlist_url

• To enable yt-dlp's --download-archive option

  Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it.

  python -m spotify-dl --download_archive FILE playlist_url

• To save as <title> - <artist>.<ext> instead of the default <artist> - <title>.<ext>:

  python -m spotify-dl --title-first playlist_url

Issues

If you have encountered problems, please read the guidelines for detailed instructions on how to open an issue.

Contributing

Contributions are welcome! If you'd like to contribute, please read our CONTRIBUTING.md guide for details on how to get started.

Credits

Icon designed by exia098.

License

This software is licensed under the MIT License © Cha