A simple Go library / CLI app for downloading songs/podcasts from Spotify.
Find a file
2026-01-11 02:34:20 +08:00
cmd/spotdl fix: remove dual format 2025-11-20 03:40:24 +08:00
config fix: remove dual format 2025-11-20 03:40:24 +08:00
injector optimize injector 2025-08-18 17:44:49 +08:00
logger remove (file:line) log on non debug 2024-11-06 02:19:33 +08:00
playplay remove playplay 2024-11-28 01:20:08 +08:00
spotify fix: file name too long 2026-01-11 02:34:20 +08:00
token fix: config corruption 2025-10-30 02:09:55 +08:00
.gitattributes init commit 2024-10-27 21:51:43 +08:00
.gitignore Initial commit 2024-10-27 21:45:52 +08:00
go.mod Dynamic TOTP secret refresh 2025-08-12 19:20:26 +08:00
LICENSE Initial commit 2024-10-27 21:45:52 +08:00
README.md fix: remove dual format 2025-11-20 03:40:24 +08:00

Spot-DL

A simple downloader for downloading spotify songs/products with metadata.

Credits:

Installation

go install github.com/XiaoMengXinX/spotdl/cmd/spotdl@latest

For macOS, you may need to codesign the binary file:

sudo codesign --force --deep --sign - ~/go/bin/spotdl

Usage

Usage of spotdl:
  -c, --config string     Path to configuration file (default "config.json")
  -d, --debug             Debug mode
  -h, --help              Show this help message
  -i, --id string         ID/URL/URI of a spotify track/playlist/album/podcast to download (Required)
                          Example: -i https://open.spotify.com/track/4jTrKMoc44RYZsoFsIlQev
      --mp3               Convert downloaded files to mp3 format
      --no-metadata       Skip adding metadata to downloaded files
  -o, --output string     Output directory for downloaded files (default "./output")
  -q, --quality string    Audio quality level. (default "MP4_128")
                          Options:	MP4_128, MP4_256

Notice

  • A .vwd file is required in the ./cdm directory for mp4 decryption. Detailed instructions can be found in: https://github.com/hyugogirubato/KeyDive.

  • Get the sp_dc cookie value from your browser and enter to the cli at first run.