DownOnSpot

⚒️ Building

Clone the repository using git and change to the local repository directory:
```
git clone https://github.com/oSumAtrIX/DownOnSpot.git
cd DownOnSpot
```
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.
Build
```
cargo build --release
```

🕹️ Usage

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.

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.