Skip to main content
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 Guide for more information).

The following features were added:

  • Python 3 support (but you need at least Python 3.6)

  • asyncio/twisted support

  • support for the client-to-client protocol

  • support for new commands from MPD (seekcur, prio, prioid, config, searchadd, searchaddpl, listfiles, rangeid, addtagid, cleartagid, mount, umount, listmounts, listneighbors)

  • 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)

  • configurable 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 https://github.com/Mic92/python-mpd2.git

Getting the latest release

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

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:

See INSTALL.rst

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.

Documentation

Documentation

Getting Started

Command Reference

Examples

Testing

Just run:

$ 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

If you have nix, you can also use the provided default.nix to bring all supported python versions in scope using nix-shell. In that case run tox directly instead of using setup.py:

$ nix-shell --command 'tox'

Building Documentation

Install Sphinx:

$ pip install Sphinx

Change to the source directory and run:

$ python ./setup.py build_sphinx

The command reference is generated from the official mpd protocol documentation. In order to update it, install python-lxml and run the following command:

$ python ./doc/generate_command_reference.py > ./doc/topics/commands.rst

Release files for python-mpd2 3.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-mpd2 3.1.1
File Size Uploaded
python-mpd2-3.1.1.tar.gz 58.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for python-mpd2 3.1.1
File Interpreter ABI Platform
python_mpd2-3.1.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 93.8 kB

Release files / python-mpd2-3.1.1.tar.gz

Download URL python-mpd2-3.1.1.tar.gz
Size 58.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4baec3584cc43ed9948d5559079fafc2679b06b2ade273e909b3582654b2b3f5
BLAKE2b-256 checksum
How to use checksums
53bee77206eb35eb37ccd3506fba237e1431431d04c482707730ce2a6802e95c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.6

Release files / python_mpd2-3.1.1-py2.py3-none-any.whl

Download URL python_mpd2-3.1.1-py2.py3-none-any.whl
Size 35.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
86bf1100a0b135959d74a9a7a58cf0515bf30bb54eb25ae6fb8e175e50300fc3
BLAKE2b-256 checksum
How to use checksums
8e6d1b9e1c203057c9a7fa6971db3605188a8ef1120ca305e4878c960ab6e2d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.6

Release history Release notifications | RSS feed

This release

3.1.1 This release

2 release files

3.1.0

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.6.0

1 release file

0.5.5

3 release files

0.5.4

3 release files

0.5.3

3 release files

0.5.2

3 release files

0.5.1

3 release files

0.5.0

3 release files

0.4.6

3 release files

0.4.5

3 release files

0.4.4

3 release files

0.4.3

3 release files

0.4.2

3 release files

0.4.1

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page