vaporget allows to easily retrieve and listen to vaporwave music stored in the Vaporwave Library Project (specifically, in the clone at https://vaporwave.ivan.moe/).

Matteo Savatteri 43636a8197 Put \n at the end of format strings when `printf` is used as `echo` 4 months ago
COPYING 420d0d52e0 Rename license file to comply to GPL guidelines 5 months ago
README.md f58e424c47 Document incompatible options in README 4 months ago
vaporget 43636a8197 Put \n at the end of format strings when `printf` is used as `echo` 4 months ago

README.md

vaporget

vaporget allows to easily retrieve and listen to v a p o r w a v e music stored in the Vaporwave Library Project (specifically, in the clone at https://vaporwave.ivan.moe/, thanks to Ivan Moe).

Required software

vaporget is a POSIX sh script and requires that the following software is installed on the user's computer:

Tested on GNU/Linux, expected to work on every system with a POSIX Shell and required software.

Usage

Usage: vaporget [-Vh] [-pd | -m MPV_OPTION,...]

After launching the script, if the connection with the music library succeeds a menu with a list of artists will appear. Select the artists you want to listen to (with the spacebar) and then press enter. If no option is provided to vaporget, mpv will fetch the music and reproduce it. To pass options (both long and short) directly to mpv, use -m MPV_OPTION,... (incompatible with options -pd). For example to pass mpv options --shuffle, --start=50% and -v use:

vaporget -m "shuffle,start=50%,v"

See MPV(1) for command line options and interactive use of the music player.

If the program is called with -p, the list of URLs of the songs by the selected artists will be printed to standard output. If the program is called with -d, all the songs by the selected artists will be downloaded in the current directory. If a combination of -p and -d is used, only the operation corresponding to the last option written will be executed. To display the script version, use -V. To display a help message, use -h.