mpdart/README.md

1.3 KiB
Raw Blame History

mpdart

mpdart is a simple X application that displays the album art of the currently playing mpd song and lets you toggle play pause. It spends almost all of its time idle and according to top it uses 0.0% of my CPU and 0.1% of my ram.

Depends

libX11
libmpdclient
libim2
pkg-config # optional build time dependency

Building

./configure.sh
make
make install # supports PREFIX and DESTDIR

Usage

There are three flags:

mpdart -d musicdir -h host -p port -t timeout # timeout is milliseconds

Though only -d is needed:

mpdart -d ~/music

These options can also be configured in the enviorment variables MPDART_DIR, MPDART_HOST, MPDART_PORT, and MPDART_TIMEOUT.

To make these changes persistent, add them to your ~/.profile.

Once mpdart is running you can press the window to toggle mpds pause/play.

Contributing

pull requests

If you like github you can contribute by sending in a pull request at https://github.com/depsterr/mpdart

patches

If you dont like github you can contribute by emailing me at depsterr at protonmail dot com with the output of

git format-patch

after youve commited your changes to your local tree.

Credits

Big thanks to my friend wooosh for helping me debug and develop this :)