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.