/mpdlcd

A small tool to display MPD status on a lcdproc server

Primary LanguagePythonMIT LicenseMIT

mpdlcd

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.

Running

The command line is quite simple:

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

Other options are possible:

mpdlcd --mpd=mpd.example.org:1234 --lcdproc=lcd.example.org:456 \
        --syslog --syslog-facility=user2 --loglevel=debug --lcdd_debug

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

Installing

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

Gentoo

Use the Sunrise overlay at http://overlays.gentoo.org/proj/sunrise/browser/app-misc/mpdlcd

Debian/Ubuntu

  1. Install the python-mpd package:

    apt-get install python-mpd

  2. Install the lcdproc package from PIP

pip install lcdproc

  1. Install mpdlcd from PIP:

    pip install mpdlcd

Other

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 and lcdproc Python libraries.

Example initd scripts are provided in the initd/ folder.

Reporting issues

Issues should be reported on https://github.com/rbarrois/mpdlcd/issues.

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

Contact

The main channel for reporting issues would be https://github.com/rbarrois/issues.

I'm also available: