Skip to content
A small tool to display MPD status on a lcdproc server
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Happy New Year! Jan 2, 2013
initd Update Gentoo init.d script. Jan 2, 2019
man Updated the man-page Feb 10, 2016
mpdlcd Back to development: 0.5.3 Jan 2, 2019
tests Linting: Adjust line length, spacing. indent. Jan 2, 2019
.flake8 Cleanup packaging. Jan 2, 2019
.gitignore Ignore .eggs folder. Jan 2, 2019
.travis.yml Fix travis.yml. Jan 2, 2019
ChangeLog Back to development: 0.5.3 Jan 2, 2019
LICENSE Add vendored lcdproc library. Jan 2, 2019 Cleanup packaging. Jan 2, 2019
Makefile Cleanup packaging. Jan 2, 2019
README.rst Add badges on README. Jan 2, 2019
mpdlcd.conf Changed the parameter names Feb 9, 2016
setup.cfg Update tag format Jan 2, 2019 Include vendored lib in package. Jan 2, 2019


mpdlcd Latest Version Supported Python versions Wheel status License

MPDLcd is a small adapter which will display the status of a MPD server on a LCD screen, through lcdproc.

It allows defining various layouts depending on LCD size, with fix or moving parts.


The command line is quite simple:

# Connect to the local mpd and lcdproc, logging to stderr

Other options are possible:

mpdlcd \
        --syslog --syslog-facility=user2 --loglevel=debug --lcdd_debug

Please use mpdlcd --help or man mpdlcd for a full help description.


The simplest way to install MPDLcd is to use your distribution's packages. It requires the and python_mpd2 Python library.


Use the Sunrise overlay at


  1. Install the python-mpd package:

    apt-get install python-mpd
  2. Install mpdlcd from PIP:

    pip install mpdlcd


If it hasn't been packaged for your distribution yet, you can also install from sources by hand:

pip install mpdlcd

This will pull in the python_mpd2 Python library.

Example initd scripts are provided in the initd/ folder.

Reporting issues

Issues should be reported on

Crash report should include:

  • Current MPD status (playing, stopped, ...)

  • Custom /etc/mpdlcd.conf file content

  • Current MPDLcd version, as given by mpdlcd --version

  • Full output from running MPDLcd in debug mode, typically with the following options:

    mpdlcd --no-syslog --logfile=- --loglevel=debug


The main channel for reporting issues would be

I'm also available:

You can’t perform that action at this time.