spotify-dl/README.md

68 lines
1.9 KiB
Markdown
Raw Normal View History

2020-10-25 01:39:20 +02:00
# spotify-dl
2024-02-03 15:57:12 +01:00
A command line utility to download songs, podcasts, playlists and albums directly from Spotify's servers.
2020-10-25 01:39:20 +02:00
You need a Spotify Premium account.
2024-05-11 13:08:07 +02:00
## Installation
2024-05-13 21:50:45 +02:00
You can install it using `cargo`, `homebrew` or from source.
2024-05-11 13:08:07 +02:00
### Using `cargo`
```
cargo install spotify-dl
```
### Using homebrew
```
brew tap guillemcastro/spotify-dl
brew install spotify-dl
```
### From source
```
git clone https://github.com/GuillemCastro/spotify-dl.git
cd spotify-dl
cargo build --release
cargo install --path .
```
2020-10-25 01:39:20 +02:00
## Usage
```
2024-05-11 13:08:07 +02:00
spotify-dl 0.2.0
2020-10-25 01:39:20 +02:00
A commandline utility to download music directly from Spotify
USAGE:
2024-05-11 13:08:07 +02:00
spotify-dl [OPTIONS] <tracks>... --username <username>
2020-10-25 01:39:20 +02:00
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
2024-01-12 12:41:26 +01:00
-c, --compression <compression> Setting the flac compression level from 0 (fastest, least compression) to
2024-01-12 13:07:14 +01:00
8 (slowest, most compression). A value larger than 8 will be Treated as 8.
Default is 4.
2024-05-11 13:08:07 +02:00
-d, --destination <destination> The directory where the songs will be downloaded
-t, --parallel <parallel> Number of parallel downloads. Default is 5. [default: 5]
2023-01-25 17:07:52 +01:00
-p, --password <password> Your Spotify password
2020-10-25 01:39:20 +02:00
-u, --username <username> Your Spotify username
ARGS:
2024-05-11 13:08:07 +02:00
<tracks>... A list of Spotify URIs or URLs (songs, podcasts, playlists or albums)
```
2020-10-25 01:39:20 +02:00
2024-02-03 15:57:12 +01:00
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`).
2020-10-25 01:39:20 +02:00
2021-02-12 18:19:31 +01:00
## Disclaimer
The usage of this software may infringe Spotify's ToS and/or your local legislation. Use it under your own risk.
2020-10-25 01:39:20 +02:00
## License
2024-05-11 13:08:07 +02:00
spotify-dl is licensed under the MIT license. See [LICENSE](LICENSE).