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.


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:

Project details

Download files

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

Source Distribution

mpdlcd-0.5.2.tar.gz (32.8 kB view hashes)

Uploaded source

Built Distribution

mpdlcd-0.5.2-py2.py3-none-any.whl (28.7 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page