#playback #toml #minimal

app quing

A (hopefully) minimalist toml based song shuffler

52 stable releases

1.16.0 Sep 19, 2023
1.15.2 Sep 18, 2023
1.13.2 Aug 26, 2023
1.11.1 Jul 30, 2023

#38 in Audio

Download history 359/week @ 2023-07-05 124/week @ 2023-07-12 118/week @ 2023-07-19 276/week @ 2023-07-26 29/week @ 2023-08-02 121/week @ 2023-08-09 48/week @ 2023-08-16 98/week @ 2023-08-23 29/week @ 2023-08-30 22/week @ 2023-09-06 134/week @ 2023-09-13 61/week @ 2023-09-20

289 downloads per month

Custom license

42KB
777 lines

quing, a (hopefully) minimalist toml based music player

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

name = "" # optional name of the playlist
time = -1 # an optional setting for repeating a playlist n times. if the number is below zero, it'll repeat infinitely

[[song]]
name = "" # same as playlist-level name, though for a 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 ('-').

'h' = "to manually enter headless mode."
'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:

' ctrl_l' = "skip one playlist forwards"
' ctrl_j' = "skip one playlist backwards"
' ctrl_k' = "exit the program when in active playback"
'      l' = "skip one track forwards"
'      j' = "skip one track backwards"
'      k' = "toggle the playback"
'shift_l' = "Increase the volume of the currently playing track"
'shift_j' = "Decrease the volume of the currently playing track"
'shift_k' = "Toggle the volume of the currently playing track"
NOTE: all inputted playlists are loaded upon starting. all files of the playlist are loaded when it is its turn to play. the program will run in headless mode if the creation of the control thread fails.

Dependencies

~5–44MB
~693K SLoC