An application for viewing album art of the song currently playing in mpd
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Rachel Samuelsson 6361404f6d added allcaps file extensions 2 years ago
.gitignore Works decently (except for issues with violent resizing). 2 years ago
LICENSE Updated README and added LICENSE 2 years ago
Makefile made mpdart prioritize images containting keywords indicating it's album 2 years ago added ability to close window by right clicking 2 years ago use pkg-config for configuring x11 2 years ago
mpdart.c added allcaps file extensions 2 years ago
preview.gif updated preview 2 years ago


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.


C compiler

pkg-config # optional build time dependency


make install # supports PREFIX and DESTDIR


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.


Pull requests

If you like github you can contribute by sending in a pull request at


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.


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