DownOnSpot

A Spotify downloader written in Rust

Disclaimer

Note

DownOnSpot was not developed for piracy. It is meant to be used in compliance with DMCA, Section 1201, for educational, private and fair use. I am not responsible in any way for the usage of the source code.

Features

• Works with free Spotify accounts
• Download 96, 160kbit/s audio with a free, 256 and 320 kbit/s audio with a premium account from Spotify, directly
• Multi-threaded
• Search for tracks
• Download tracks, playlists, albums and artists
• Convert to mp3
• Metadata tagging
• Simple usage over CLI

Note

Free Spotify users can can't exceed 160kbit/s. Change the quality setting in the settings.json file to Q160 or lower. If you want to download 256 or 320kbit/s, you need to use a premium account.

Building

1. Clone the repository using git and change to the local repository directory:

   git clone https://github.com/oSumAtrIX/DownOnSpot.git
   cd DownOnSpot
   

2. Build

   cargo build --release
   

Warning

You need this private SSH key to clone a dependency of DownOnSpot in order to use it with a free Spotify account. Follow this answer by DopeGhoti on stackexchange.com to set up SSH with the private key. A sample ~/.ssh/config file could look like this:

Host github.com
  IdentityFile ~/.ssh/free_librespot_private_key

If you do not want to use free-librespot (i.e. if you are using a paid Spotify account), replace git = "ssh://git@github.com/oSumAtrIX/free-librespot.git" with librespot = "0.4.2" inside the Cargo.toml file.

Warning

If you get a linker error, you might be missing the libmp3lame library.
On Mac OS, run brew install lame, provided you have Homebrew installed.

Usage/ Examples

1. Create a new application on the Spotify developer dashboard

2. Run DownOnSpot

   $ ./down_on_spot
   Settings could not be loaded, because of the following error: IO: NotFound No such file or directory. (os error 2)...
   ..but default settings have been created successfully. Edit them and run the program again.
   

3. Edit the settings.json file

   The settings.json file is located in the following directories:

   • Windows: C:\Users\<user>\AppData\Roaming\down_on_spot\settings.json
   • Unix: ~/.config/down_on_spot/settings.json

4. Now you can use DownOnSpot

   $ ./down_on_spot
   Usage:
   down_on_spot.exe (search_term | track_url | album_url | playlist_url | artist_url)
   

Template variables

You can use the following template variables for path and filename_template in the settings.json file:

• %0disc%
• %0track%
• %album%
• %albumArtist%
• %albumArtists%
• %artist%
• %disc%
• %id%
• %title%
• %track%

Additional scripts

• Userscript to download titles from YouTube

Known issues

• Slow MP3 downloads due to libmp3lame
• Sporadic channel error when downloading tracks

Authors

• @oSumAtrIX
• @exttex
• @breuerfelix
• @thatpix3l

License

GPLv3