mpdart/README.md

62 lines
1.4 KiB
Markdown

mpdart
======
![preview gif](preview.gif)
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 it's time idle and only uses `0.1%` of my RAM and `0.0%` of my CPU according to top.
Depends
-------
C compiler
make
libX11
libmpdclient
libim2
pkg-config # optional build time dependency
Building
--------
./configure.sh
make
make install # supports PREFIX and DESTDIR
Usage
-----
There are four flags:
mpdart -d musicdir -h host -p port -t timeout # timeout is milliseconds
Though all but -d have default values:
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, export them in your `~/.profile`.
Once mpdart is running you can left click the window to toggle mpd's pause/play or right click it to close it.
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 don't like github you can contribute by emailing me at
depsterr at protonmail dot com with the output of
git format-patch
after you've commited your changes to your local tree.
Credits
-------
Big thanks to my friend wooosh for helping me debug and develop this :)