No description

Find a file

Felix Breuer befad26e33 format code Signed-off-by: Felix Breuer <fbreuer@pm.me>		2022-01-27 17:08:47 +01:00
.cargo	Fix download of non search inputs & .cargo config	2021-11-27 09:11:15 +01:00
.github	Fix formatting and add badges to readme	2021-10-18 03:58:49 +02:00
.vscode	Add initial files	2021-10-11 02:12:22 +02:00
assets	Add initial files	2021-10-11 02:12:22 +02:00
src	format code	2022-01-27 17:08:47 +01:00
.gitignore	Add Cargo.lock back to version control	2021-10-13 17:31:37 +02:00
build.rs	Add initial files	2021-10-11 02:12:22 +02:00
Cargo.lock	Bump version and explain issue in readme	2021-11-28 23:13:50 +01:00
Cargo.toml	Bump version and explain issue in readme	2021-11-28 23:13:50 +01:00
LICENSE	Add initial files	2021-10-11 02:12:22 +02:00
mp3lame.lib	Add initial files	2021-10-11 02:12:22 +02:00
README.md	Update license	2022-01-22 19:25:08 +01:00
rustfmt.toml	format code	2022-01-27 17:08:47 +01:00

README.md

DownOnSpot

A Spotify downloader written in Rust

Disclaimer

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 (if using free-librespot fork)
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

Building

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

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

A private ssh key is needed to use free Spotify accounts. Follow this answer by DopeGhoti on stackexchange.com on how to set up ssh with the required 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, then remove the git dependency of free-librespot. For that, delete git = "ssh://git@github.com/oSumAtrIX/free-librespot.git" inside Cargo.toml.

Nightly Rust is required to build this project. Install it by following rustup.rs instructions.

cargo build --release

If you get a linker error, you might need to download the standard libmp3lame library.

Usage/ Examples

Running DownOnSpot once will create the default configuration file in the same directory as your shell.

$ down_on_spot.exe
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.

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

Template variables

Following variables are available for path and filename_template in the settings.json:

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