owntone-server/docs/clients/mpd.md

# MPD Clients

You can - to some extent - use clients for MPD to control OwnTone.

By default OwnTone listens on port 6600 for MPD clients. You can change
this in the configuration file.

Currently only a subset of the commands offered by MPD (see [MPD Protocol](https://mpd.readthedocs.io/en/latest/protocol.html)) are supported.

Due to some differences between OwnTone and MPD not all commands will act the
same way they would running MPD:

- crossfade, mixrampdb, mixrampdelay and replaygain will have no effect
- single, repeat: unlike MPD, OwnTone does not support setting single and repeat separately
  on/off, instead repeat off, repeat all and repeat single are supported. Thus setting single on will result in repeat single, repeat on results in repeat all.

The following table shows what is working for a selection of MPD clients:

|          Client                               |  Type  | Status          |
| --------------------------------------------- | ------ | --------------- |
| [mpc](https://www.musicpd.org/clients/mpc/)    | CLI    | Working commands: mpc, add, crop, current, del (ranges are not yet supported), play, next, prev (behaves like cdprev), pause, toggle, cdprev, seek, clear, outputs, enable, disable, playlist, ls, load, volume, repeat, random, single, search, find, list, update (initiates an init-rescan, the path argument is not supported)   |
| [ympd](http://www.ympd.org/)                  | Web    | Everything except "add stream" should work |
[doc] Add configuration documentation in the menu Moreover, the entries in the menu now match the title of the pages. 2024-04-27 15:53:01 -04:00			`# MPD Clients`
[docs] Split docs into multiple files and publish with gh-actions 2022-03-20 07:00:31 -04:00
			`You can - to some extent - use clients for MPD to control OwnTone.`

			`By default OwnTone listens on port 6600 for MPD clients. You can change`
			`this in the configuration file.`

[doc] Fix links in the documentation 2024-04-10 08:51:55 -04:00			`Currently only a subset of the commands offered by MPD (see [MPD Protocol](https://mpd.readthedocs.io/en/latest/protocol.html)) are supported.`
[docs] Split docs into multiple files and publish with gh-actions 2022-03-20 07:00:31 -04:00
			`Due to some differences between OwnTone and MPD not all commands will act the`
			`same way they would running MPD:`

			`- crossfade, mixrampdb, mixrampdelay and replaygain will have no effect`
[docs] Fix spelling mistakes and extraneous spaces 2024-03-05 05:23:25 -05:00			`- single, repeat: unlike MPD, OwnTone does not support setting single and repeat separately`
			`on/off, instead repeat off, repeat all and repeat single are supported. Thus setting single on will result in repeat single, repeat on results in repeat all.`
[docs] Split docs into multiple files and publish with gh-actions 2022-03-20 07:00:31 -04:00
			`The following table shows what is working for a selection of MPD clients:`

			`\| Client \| Type \| Status \|`
			`\| --------------------------------------------- \| ------ \| --------------- \|`
[doc] Fix links in the documentation 2024-04-10 08:51:55 -04:00			`\| [mpc](https://www.musicpd.org/clients/mpc/) \| CLI \| Working commands: mpc, add, crop, current, del (ranges are not yet supported), play, next, prev (behaves like cdprev), pause, toggle, cdprev, seek, clear, outputs, enable, disable, playlist, ls, load, volume, repeat, random, single, search, find, list, update (initiates an init-rescan, the path argument is not supported) \|`
[docs] Split docs into multiple files and publish with gh-actions 2022-03-20 07:00:31 -04:00			`\| [ympd](http://www.ympd.org/) \| Web \| Everything except "add stream" should work \|`