mirror/spotify-dl
1
0
Fork 0
mirror of https://github.com/GuillemCastro/spotify-dl.git synced 2025-12-06 03:32:28 +00:00
Code Issues Projects Releases Packages Wiki Activity
A command-line utility to download songs and playlists directly from Spotify's servers
104 commits 3 branches 11 tags 1 MiB
Find a file
Exact
GuillemCastro 83c34335fe docs: update CHANGELOG.md for v0.9.2 [skip ci]
2025-07-12 23:39:56 +00:00
.github/workflows Update create-release.yml 2025-07-07 23:12:26 +02:00
src refactor: handle failures loading tracks (#36) 2025-07-12 22:56:08 +02:00
.gitignore MP3 Support (#14) 2024-05-17 18:06:31 +02:00
.gitmodules Add files 2020-10-25 01:39:20 +02:00
Cargo.lock Bump version to v0.9.2 2025-07-12 23:39:43 +00:00
Cargo.toml Bump version to v0.9.2 2025-07-12 23:39:43 +00:00
CHANGELOG.md docs: update CHANGELOG.md for v0.9.2 [skip ci] 2025-07-12 23:39:56 +00:00
LICENSE Add files 2020-10-25 01:39:20 +02:00
README.md Update README.md (#35) 2025-07-11 19:54:32 +02:00

README.md

🎵 spotify-dl

A command line utility to download songs, podcasts, playlists and albums directly from Spotify.

Important

A Spotify Premium account is required.

Caution

Usage of this software may infringe Spotify's terms of service or your local legislation. Use it under your own risk.

🚀 Features

  • Download individual tracks, podcasts, playlists or full albums.
  • Built with Rust for speed and efficiency.
  • Supports metadata tagging and organized file output.

⚙️ Installation

You can install it using cargo, homebrew, from source or using a pre-built binary from the releases page.

From crates.io using cargo

cargo install spotify-dl

Using homebrew (macOs)

brew tap guillemcastro/spotify-dl
brew install spotify-dl

From source

cargo install --git https://github.com/GuillemCastro/spotify-dl.git

🧭 Usage

spotify-dl 0.9.0
A commandline utility to download music directly from Spotify

USAGE:
    spotify-dl.exe [FLAGS] [OPTIONS] <tracks>...

FLAGS:
    -F, --force      Force download even if the file already exists
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -d, --destination <destination>    The directory where the songs will be downloaded
    -f, --format <format>              The format to download the tracks in. Default is flac. [default: flac]
    -t, --parallel <parallel>          Number of parallel downloads. Default is 5. [default: 5]

ARGS:
    <tracks>...    A list of Spotify URIs or URLs (songs, podcasts, playlists or albums)

Songs, playlists and albums must be passed as Spotify URIs or URLs (e.g. spotify:track:123456789abcdefghABCDEF for songs and spotify:playlist:123456789abcdefghABCDEF for playlists or https://open.spotify.com/playlist/123456789abcdefghABCDEF?si=1234567890).

📋 Examples

  • Download a single track:
spotify-dl https://open.spotify.com/track/TRACK_ID
  • Download a playlist:
spotify-dl -u YOUR_USER -p YOUR_PASS https://open.spotify.com/playlist/PLAYLIST_ID

Save as MP3 to a custom folder:

spotify-dl --format flac --destination ~/Music/Spotify https://open.spotify.com/album/ALBUM_ID

📄 License

spotify-dl is licensed under the MIT license. See LICENSE.