mq

mq (music queue)

build

just run:

make

for installing:

# this need root, use doas or sudo.
make install

usage

basic usage:

# for seeing the current queue.
mq list
# to add a new song.
mq add example/some/song.mp3
# to see a directory in the mpd music directory.
mq see example
# add a new alias
mq alias --add example/some es
# use an alias on add
mq add :es
# write's the albumart to `/tmp/cover.jpg", and run a notification script everytime the song changes.
mq albumart --notify
# write's the albumart to `some.jpg" every song change.
mq albumart --output ./some.jpg
# opens man page.
mq --help

for more information on usage consult the manpage.

configuration

mq read's the config file in $XDG_CONFIG_HOME/mq/config.

# the mpd address.
addr: localhost:6600
# the music directory of mpd
base-path: ~/music
# the default command that mq will run when no args are provided.
default-command: list
# where to save the currentsong album art.
cover-path: /tmp/cover.jpg
# the notify script to run
notify-path: ~/.config/mq/notify

for config and script example see ./examples.