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

🎉 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

🔑 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.