Skip to main content

Display MPD status on a lcdproc server.

Project description 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.


  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:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mpdlcd, version 0.5.2
Filename, size File type Python version Upload date Hashes
Filename, size mpdlcd-0.5.2-py2.py3-none-any.whl (28.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size mpdlcd-0.5.2.tar.gz (32.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page