Skip to main content

A Python MPD client library

Project description

Build Status

python-mpd2 is a Python library which provides a client interface for the Music Player Daemon.

Difference with python-mpd

python-mpd2 is a fork of python-mpd. While 0.4.x was backwards compatible with python-mpd, starting with 0.5 provides enhanced features which are NOT backward compatibles with the original python-mpd package. (see PORTING.txt for more information)

The following features were added:

  • Python 3 support (but you need at least Python 2.6)
  • support for the upcoming client-to-client protocol
  • support for new commands from MPD v0.17 (seekcur, prio, prioid, config, searchadd, searchaddpl)
  • remove deprecated commands (volume)
  • explicitly declared MPD commands (which is handy when using for example IPython)
  • a test suite
  • API documentation to add new commands (see Future Compatible)
  • support for Unicode strings in all commands (optionally in python2, default in python3 - see Unicode Handling)
  • configureable timeouts
  • support for logging
  • improved support for sticker
  • improved support for ranges

If you like this module, you could try contact the original author or join the discussion on the issue tracker so that it gets merged upstream.

Getting the latest source code

If you would like to use the latest source code, you can grab a copy of the development version from Git by running the command:

$ git clone git://

Getting the latest release

The latest stable release of python-mpd2 can be found on PyPI


$ pip install python-mpd2

Installation in Linux/BSD distributions

Until Linux distributions adapt this package, here are some ready to use packages to test your applications:


Installing from source

To install python-mpd2 from source, simply run the command:

$ python install

You can use the –help switch to for a complete list of commands and their options. See the Installing Python Modules document for more details.


Just run:

$ python test

This will install Tox. Tox will take care of testing against all the supported Python versions (at least available) on our computer, with the required dependencies

Building Documentation

Install Sphinx:

$ easy_install -U Sphinx

Change to the source directory an run:

$ python ./ build_sphinx

Contacting the author

Just contact me (Mic92) on Github or via email (

Usually I hang around on Jabber:

You can contact the original author by emailing J. Alexander Treuman

He can also be found idling in #mpd on as jat.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
python-mpd2-0.5.2.tar.bz2 (26.2 kB) Copy SHA256 hash SHA256 Source None Nov 3, 2013
python-mpd2-0.5.2.tar.gz (30.9 kB) Copy SHA256 hash SHA256 Source None Nov 3, 2013 (39.3 kB) Copy SHA256 hash SHA256 Source None Nov 3, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page