DownOnSpot

⚒️ 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. Install dependencies

   If you are on Linux, make sure you have the libasound2-dev package installed.
   Additionally, you need the libmp3lame library.
   On Mac OS, run brew install lame, provided you have Homebrew installed.

3. Build

   cargo build --release

🕹️ Usage

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

   The client_id and client_secret can be obtained by creating an app at spotify for developers.

   You can obtain your access_token by following this guide. Or the webplayer also uses an access token (with a longer ttl), which you can view by inspecting the network traffic via your browser dev tools, when logged in.

🎉 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, filename_template, and filename_template_playlist in the settings.json file:

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

Use filename_template_playlist to override the filename format applied when downloading items from playlists. Leave it empty to fall back to filename_template.

🧭 Additional scripts

• Userscript to download titles from YouTube

🐞 Known issues

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

🔑 License

DownOnSpot is licensed under the GPLv3 licence. Please see the licence file for more information. tl;dr you may copy, distribute and modify DownOnSpot as long as you track changes/dates in source files. Any modifications to DownOnSpot must also be made available under the GPL, along with build & install instructions.