limestone

README

Limestone

CLI app for downloading music from Slav Art.

Usage

All commands have help/usage information available, just pass --help or -h as a flag.

Divolt

You can use limestone to download zipped albums/tracks from the Slav Art server, provided you have an account on Divolt. limestone does not currently support multi-factor authentication.

$ limestone login bob@bob.com
Enter the password for bob@bob.com:
Logging in... login successful.
$ limestone divolt <url>

You can specify the quality of the download, according to the table on the FAQ:

$ limestone divolt -q 3 <url>

Web

limestone also supports the website's API for individual tracks from Qobuz. You do not need to authenticate to use it. This download method only downloads the highest quality available.

$ limestone web "the police"
Getting results for query "the police"...

# Searching for a track in the TUI... found one!

# Fancy progress bar...

Downloaded to /home/dxbednarczyk/Downloads/The Police - Every Breath You Take.flac

You can also use the -c flag to automatically download the closest match to your query.

$ limestone web -c "cherry bomb tyler the creator"
Getting results for query "cherry bomb tyler the creator"...

# Fancy progress bar...

Downloaded to /home/dxbednarczyk/Downloads/Tyler, The Creator - CHERRY BOMB.flac

Building

Unix

Install Go through your system's package manager or from the download page.

$ git clone https://github.com/dxbednarczyk/limestone
$ cd limestone
$ go get
$ make

Windows

Install Go using winget, or alternatively download the latest MSI package from the download page. Preferably, use Powershell 7 or higher.

> git clone https://github.com/dxbednarczyk/limestone
> cd limestone
> go get
> ./make

Installing

Using go install

$ go install github.com/dxbednarczyk/limestone@latest

Using make

Installs to ~/.local/bin by default, make sure this directory is somewhere on your PATH.

$ make && make install
$ which limestone
/home/damian/.local/bin/limestone
$ make uninstall
Do you want to remove all saved logins and configuration? [y/n] n
rm -f /home/damian/.local/bin/limestone

Comparison

	limestone	slavartdl	slavolt-scraper
STDIN input	❌	✅	❌
CLI	✅	✅	❌
TUI	✅	❌	❌
Website Track API	✅	❌	❌
Unzip downloaded tracks	❌	✅	❌
Credential storage	✅	✅	✅
Session token storage	✅	✅	❌
Self-update	❌	✅	❌

limestone supports both Slav Art download methods, and uses websockets instead of large REST payloads.