Welcome to the Spotify Music Downloader project! Dive into the world of offline music with this handy tool, making it easy to download your favorite tracks and playlists from Spotify. Whether you're prepping for a long flight or building your ultimate music collection, this downloader has got your back.
- Download songs in AAC 128kbps or in AAC 256kbps with a premium account
- Download music videos with a premium account
- Download synced lyrics with a premium account
- Highly configurable
- Python 3.8 or higher
- The cookies file of your Spotify account (free or premium)
- You can get your cookies by using one of the following extensions on your browser of choice at the Spotify website with your account signed in:
- Firefox: https://addons.mozilla.org/addon/export-cookies-txt
- Chromium based browsers: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
- FFmpeg on your system PATH.Older versions of FFmpeg may not work.
- Up to date binaries can be obtained from the links below:
- Windows: https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
- Linux: https://johnvansickle.com/ffmpeg/
- Install the package
spotify-web-downloaderusing pip
pip install spotify-web-downloader- Place your cookies file in the directory from which you will be running spotify-web-downloader and name it
cookies.txt.
You can use bash
spotify-web-downloader [OPTIONS] URLS...- Download song/Track/Playlist
spotify-web-downloader "spotify-link"Replace The spotify-link with your desired song/Track/Playlist
spotify-web-downloader can be configured using command line arguments or a config file. The config file is created automatically on the first run:
- Linux: ~/.spotify-web-downloader/config.json
- Windows: %USERPROFILE%.spotify-web-downloader\config.json
- Command Line Arguments / Config File Keys
| Command line argument / Config file key | Description | Default value |
|---|---|---|
--download-music-video / download_music_video |
Attempt to download music videos from songs (can lead to incorrect results). | false |
--save-cover, -s / save_cover |
Save cover as a separate file. | false |
--overwrite / overwrite |
Overwrite existing files. | false |
--read-urls-as-txt, -r / - |
Interpret URLs as paths to text files containing URLs. | false |
--lrc-only, -l / lrc_only |
Download only the synced lyrics. | false |
--no-lrc / no_lrc |
Don't download the synced lyrics. | false |
--config-path / - |
Path to config file. | <home>/.spotify-web-downloader/config.json |
--log-level / log_level |
Log level. | INFO |
--print-exceptions / print_exceptions |
Print exceptions. | false |
--cookies-path, -c / cookies_path |
Path to .txt cookies file. | ./cookies.txt |
--output-path, -o / output_path |
Path to output directory. | ./Spotify |
--temp-path / temp_path |
Path to temporary directory. | ./temp |
--wvd-path / wvd_path |
Path to .wvd file. | null |
--ffmpeg-path / ffmpeg_path |
Path to FFmpeg binary. | ffmpeg |
--mp4box-path / mp4box_path |
Path to MP4Box binary. | MP4Box |
--mp4decrypt-path / mp4decrypt_path |
Path to mp4decrypt binary. | mp4decrypt |
--aria2c-path / aria2c_path |
Path to aria2c binary. | aria2c |
--nm3u8dlre-path / nm3u8dlre_path |
Path to N_m3u8DL-RE binary. | N_m3u8DL-RE |
--remux-mode / remux_mode |
Remux mode. | ffmpeg |
--date-tag-template / date_tag_template |
Date tag template. | %Y-%m-%dT%H:%M:%SZ |
--exclude-tags / exclude_tags |
Comma-separated tags to exclude. | null |
--truncate / truncate |
Maximum length of the file/folder names. | 40 |
--template-folder-album / template_folder_album |
Template of the album folders as a format string. | {album_artist}/{album} |
--template-folder-compilation / template_folder_compilation |
Template of the compilation album folders as a format string. | Compilations/{album} |
--template-file-single-disc / template_file_single_disc |
Template of the song files for single-disc albums as a format string. | {track:02d} {title} |
--template-file-multi-disc / template_file_multi_disc |
Template of the song files for multi-disc albums as a format string. | {disc}-{track:02d} {title} |
--download-mode-song / download_mode_song |
Download mode for songs. | ytdlp |
--premium-quality, -p / premium_quality |
Download songs in premium quality. | false |
--template-folder-music-video / template_folder_music_video |
Template of the music video folders as a format string. | {artist}/Unknown Album |
--template-file-music-video / template_file_music_video |
Template of the music video files as a format string. | {title} |
--download-mode-video / download_mode_video |
Download mode for videos. | ytdlp |
--no-config-file, -n / - |
Do not use a config file. | false |
There are some variables can be used in the template folder/file and/or in the exclude_tags list:
albumalbum_artistartistcompilationcomposercopyrightcoverdiscdisc_totalisrclabellyricsmedia_typeproducerratingrelease_daterelease_yeartitletracktrack_totalurl
The following remux modes are available:
ffmpegmp4box- Requires mp4decrypt
- Can be obtained from here: https://gpac.wp.imt.fr/downloads
Music videos will be downloaded in the highest quality available in H.264/AAC, up to 1080p.
Songs
-
ytdlp -
aria2c- Faster than
ytdlp - Can be obtained from here: https://github.com/aria2/aria2/releases
Videos
-
ytdlp -
nm3u8dlre -
Faster than
ytdlp -
Download N_m3u8DL-RE:https://github.com/nilaoda/N_m3u8DL-RE/releases
- Faster than
Contributing 🤝 We love collaboration! If you'd like to contribute to the Spotify Music Downloader:
- Fork the repository.
- Create a new branch (git checkout -b feature-branch).
- Make your changes and commit them (git commit -m 'Add new feature').
- Push to the branch (git push origin feature-branch).
- Create a Pull Request.
Encountered a bug or have some feedback? Open an issue on GitHub Issues. We'd love to hear from you!
Made with 
For support, email me on this address [email protected] or join our Discord Server.
MADE WITH MIT License