spotdl
TLDR
Download track
$ spotdl "[song name]"
Download from URL$ spotdl [https://open.spotify.com/track/...]
Download playlist$ spotdl [https://open.spotify.com/playlist/...]
Download album$ spotdl [https://open.spotify.com/album/...]
Specify output format$ spotdl --output "[{artist} - {title}]" [url]
Download as MP3$ spotdl --format mp3 [url]
SYNOPSIS
spotdl [options] queryorurl
DESCRIPTION
spotdl downloads songs from Spotify by finding and downloading matching tracks from YouTube Music. It uses Spotify's metadata for tagging.
The tool downloads audio, adds metadata and cover art, creating properly tagged music files from Spotify links.
PARAMETERS
--output template
Output filename template.--format fmt
Audio format (mp3, flac, ogg, m4a).--bitrate rate
Audio bitrate.-o dir, --output-dir dir
Output directory.--threads n
Download threads.--no-cache
Don't use cache.--sponsor-block
Remove sponsor segments.--sync file
Sync with saved file.--cookie-file file
YouTube cookies file.
CAVEATS
Depends on YouTube Music availability. Quality varies. Rate limiting may occur. Respect copyright laws.
HISTORY
spotdl was created to bridge Spotify's catalog with downloadable audio. It evolved from earlier tools and uses yt-dlp for downloading, adding Spotify integration for metadata.
SEE ALSO
yt-dlp(1), youtube-dl(1), ffmpeg(1)
