A fully-featured, dependency-free PHP library for MPD

MphpD is a library for the Music Player Daemon. It lets you control MPD from within your PHP application in a simple and object-oriented way while also taking care of escaping, parsing, error reporting and all the other painful stuff.

The whole MPD protocol is supported!


This Library as well as it's documentation is rather young and therefore not perfect.

Please report any bugs or issues you encounter here. Thanks.


You can either install this library by using composer:

composer require flofaber/mphpd

and then autoload it:

require_once __DIR__ . "/vendor/autoload.php";

or by simply downloading it and including it in your code like so:

require_once __DIR__ . "/MphpD/MphpD.php";


Create a new MphpD instance:

use FloFaber\MphpD\MphpD;
use FloFaber\MphpD\MPDException;

$mphpd = new MphpD([
  "host" => "",
  "port" => 6600,
  "timeout" => 5

and connect to MPD

}catch (MPDException $e){
  echo $e->getMessage();
  return false;


Here are some examples of what you can do with it:

// get MPD's status like current song, volume, state, etc...
$status = $mphpd->status();

// if you only want to retrieve only one (or more) values
// you can pass it a list of keys.
$state = $mphpd->status([ "state" ]);

// clear the queue

// load the first 10 songs of a playlist into the queue and exit on failure.
  echo $mphpd->get_last_error()["message"]; // prints "No such playlist"
  return false;

// shuffle the queue

// adjust volume to 40%

// start playing

For further information have a look at the Documentation.

Supported PHP versions

Required PHP extensions

Required PHP functions

A list of PHP functions required by MphpD for socket communication:

© 2023 Florian Faber