hax/grufkork-DownOnSpot
9
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
20 commits 2 branches 0 tags 487 KiB
Find a file
oSumAtrIX 1d00f0c993
Add Cargo.lock back to version control
2021-10-13 17:31:37 +02:00
.github Update issue templates 2021-10-11 11:08:21 +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 Add variables documentation to the readme and allow variables in the downloader path 2021-10-13 17:26:36 +02: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 Add Cargo.lock back to version control 2021-10-13 17:31:37 +02:00
Cargo.toml Add initial files 2021-10-11 02:12:22 +02: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 Add variables documentation to the readme and allow variables in the downloader path 2021-10-13 17:26:36 +02:00

README.md

DownOnSpot

A Spotify downloader written in Rust

drawing

Build project

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

  • Multi-threaded
  • Download 96, 160, 256 and 320 kbit/s audio from spotify, directly
  • Download tracks, playlists, albums and artists
  • Convert to mp3
  • Metadata tagging
  • Simple usage over CLI

Building

To build this project you will need Nightly Rust. You can install it by following rustup.rs instructions.

git clone https://github.com/oSumAtrIX/DownOnSpot.git
cd DownOnSpot
cargo build --release

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

Usage/Examples

To install and use DownOnSpot, edit the configuration file which is being created in the same directory as your shell on first launch.

$ 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 (track_url | album_url | playlist_url | artist_url)

Template variables

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

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

Known issues

  • KDE Konsole specific prints to clear the screen or color the text does not work on windows
  • Premium account dependency due to librespot
  • Sometimes downloads slow down

Authors

License

GPL3