mpdart/README.md

57 lines
1.3 KiB
Markdown
Raw Normal View History

2021-01-28 15:45:01 +01:00
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 it's time idle and according to top it uses `0.0%` of my CPU and `0.1%` of my ram.
2021-01-28 15:45:01 +01:00
Depends
2021-01-28 15:45:01 +01:00
-------
libX11
libmpdclient
libim2
pkg-config # optional build time dependency
2021-01-28 15:45:01 +01:00
Building
2021-01-28 15:45:01 +01:00
--------
./configure.sh
make
make install # supports PREFIX and DESTDIR
Usage
2021-01-28 15:45:01 +01:00
-----
There are three flags:
mpdart -d musicdir -h host -p port -t timeout # timeout is milliseconds
2021-01-28 15:45:01 +01:00
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`.
2021-01-28 15:45:01 +01:00
Once mpdart is running you can press the window to toggle mpd's pause/play.
Contributing
2021-01-28 15:45:01 +01:00
------------
### 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
2021-01-28 15:45:01 +01:00
-------
Big thanks to my friend wooosh for helping me debug and develop this :)