python-mpd2

What it is and what it does

python-mpd2 is a Python client library for Music Player Daemon (MPD), a lightweight music server. It lets you control MPD playback, manage playlists, and query server state from Python code. The library supports both synchronous blocking calls and asynchronous patterns via asyncio or twisted, making it suitable for simple scripts, web applications, and event-driven systems.

The package started as a fork of python-mpd and has evolved to support Python 3.6+, client-to-client protocol messaging, and newer MPD commands including seekcur, prio, config, mount, and others. It includes explicit command declarations for IDE autocomplete, configurable connection timeouts, logging support, and improved Unicode handling. With zero runtime dependencies and a pure-Python wheel, it installs quickly and runs anywhere Python 3.6+ is available.

Use it for:

• Build a web dashboard or REST API to control MPD playback and queue from a browser.
• Write a command-line tool to automate playlist management and music library operations.
• Create a home automation script that integrates MPD with other services via asyncio.
• Develop a music client application with custom UI that talks to a remote MPD server.
• Monitor and log MPD server state and playback events for analytics or debugging.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python client library to communicate with Music Player Daemon (MPD) servers, supporting both synchronous and asynchronous operations.

Yes. This is a mature, actively maintained library with zero dependencies, a permissive copyleft license, and no known vulnerabilities. Install it if you need to control MPD from Python—whether for a simple script, web service, or async application. The only prerequisite is having an MPD server running; the library itself is straightforward to integrate.

Install

python-mpd2 on PyPI

pip install python-mpd2

uv add python-mpd2

poetry add python-mpd2

Installing python-mpd2

Before you install

Low friction: pure Python wheel with no runtime dependencies. Actively maintained with recent commits; last release was 2024-01-13 and repository shows ongoing development.

License in practice

LGPLv3 copyleft license: you may use this library freely in proprietary software, but any modifications to the library itself must be released under the same license.

Quickstart

pip install python-mpd2

import python_mpd2
client = python_mpd2.MPDClient()
client.connect('localhost')
status = client.status()
client.close()

Requires Python 3.6 or later and a running Music Player Daemon server to connect to.

Verify before relying

• Whether asyncio/twisted support is production-ready or still experimental.
• Performance characteristics when controlling large playlists or music libraries.
• Compatibility matrix with specific MPD server versions.
• Default port and connection parameters for MPD server connections.

Package facts

Evidence: python_mpd2-3.1.1-py2.py3-none-any.whl

Keywords: mpd

Tags

More Python Modules packages