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
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://github.com/Mic92/python-mpd2.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 setup.py install
You can use the --help switch to setup.py for a complete list of commands and their options. See the Installing Python Modules document for more details.
$ python setup.py 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
$ easy_install -U Sphinx
Change to the source directory an run:
$ python ./setup.py build_sphinx
Contacting the author
Just contact me (Mic92) on Github or via email (firstname.lastname@example.org).
Usually I hang around on Jabber: email@example.com
You can contact the original author by emailing J. Alexander Treuman firstname.lastname@example.org.
He can also be found idling in #mpd on irc.freenode.net as jat.