A new and improved version of spotDL: still the fastest, easiest and most accurate command-line music downloader
Read the documentation on ReadTheDocs!
- Visual C++ 2019 redistributable (on Windows)
- Python 3.7 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.
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
piptopip3. - spotDL can be installed by running
- Prebuilt Executable
- You can download the latest version from the Releases Tab
- 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]
-
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 ffmpegor use your distro's package manager
To get started right away:
spotdl download [urls]To start the Web UI:
spotdl webYou can run spotDL as a package if running it as a script doesn't work:
python -m spotdl [urls]Read the documentation on ReadTheDocs!
Interested in contributing? Check out our 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.