#music-player #audio-playback #toml #playback #minimal #env-var

bin+lib quing

A (hopefully) minimalist toml based song shuffler

62 stable releases

2.2.1 Aug 5, 2024
2.1.0 Dec 8, 2023
2.0.6 Nov 17, 2023
1.17.0 Oct 3, 2023
1.11.1 Jul 30, 2023

#136 in Audio

Download history 44/week @ 2024-07-26 212/week @ 2024-08-02 15/week @ 2024-08-09 21/week @ 2024-09-13 108/week @ 2024-09-20 18/week @ 2024-09-27 3/week @ 2024-10-04

3,167 downloads per month

Custom license

61KB
1.5K SLoC

quing, a (hopefully) minimalist toml based music player

Usage: quing [-flags...] [playlist.toml...]

time = -1 # an optional setting for repeating a playlist n times. if the number is below zero, it'll repeat infinitely
vary = false # set that a playlist cannot be shuffled. Default is true

[[song]]
file = "" # file path pointing towards a file, which contains audio data.
# supported features:
#  environment variables: ${NAME}
#  NOTE: redcursive variables do also work e.g.: $${NAME} => ${VALUE_OF_NAME} => {VALUE_OF_VALUE_OF_NAME}
#  ~, at the start of the path, as a shortcut, for $HOME.

time = -1 # similar to playlist-level time, but for a single song.

Flags:

All flags must be passed in before the playlist files and start with a dash ('-').

'n' = "to not shuffle every playlist"
'f' = "to merge all tracks, from the playlist files, into one."
'v' = "to output some general package information."
'p' = "repeat the composed file-playlist for ever."
't' = "repeat the inputted file, inside of the file-playlist, infinitely."

Controls:

'C-l' = "skip one playlist forwards"
'C-j' = "skip one playlist backwards"
'C-k' = "exit the program when in active playback"
'C-h' = "reset back to the first playlist"
'  l' = "skip one track forwards"
'  j' = "skip one track backwards"
'  k' = "toggle the playback"
'  h' = "reset back to the first track"
'S-l' = "increase the volume"
'S-j' = "decrease the volume"
'S-k' = "toggle the volume"
'S-h' = "reset the volume"

Due to the nature of the updated control code, the program will often need a second input before fully shutting down.

Dependencies

~6–37MB
~601K SLoC