e4ba4b3e5f
Default blacklist set to listall and listallinfo. This change has been done to avoid clients being able to call "bad" MPD commands which are often misused to try and keep a client db. Note that this change will break some MPD clients, but the blacklist can be controlled via config to allow opting out for now.
109 lines
3.4 KiB
ReStructuredText
109 lines
3.4 KiB
ReStructuredText
.. _ext-mpd:
|
|
|
|
**********
|
|
Mopidy-MPD
|
|
**********
|
|
|
|
Mopidy-MPD is an extension that provides a full MPD server implementation to
|
|
make Mopidy available to :ref:`MPD clients <mpd-clients>`. It is bundled with
|
|
Mopidy and enabled by default.
|
|
|
|
.. warning::
|
|
|
|
As a simple security measure, the MPD server is by default only available
|
|
from localhost. To make it available from other computers, change the
|
|
:confval:`mpd/hostname` config value. Before you do so, note that the MPD
|
|
server does not support any form of encryption and only a single clear
|
|
text password (see :confval:`mpd/password`) for weak authentication. Anyone
|
|
able to access the MPD server can control music playback on your computer.
|
|
Thus, you probably only want to make the MPD server available from your
|
|
local network. You have been warned.
|
|
|
|
MPD stands for Music Player Daemon, which is also the name of the `original MPD
|
|
server project <http://mpd.wikia.com/>`_. Mopidy does not depend on the
|
|
original MPD server, but implements the MPD protocol itself, and is thus
|
|
compatible with clients for the original MPD server.
|
|
|
|
For more details on our MPD server implementation, see :mod:`mopidy.mpd`.
|
|
|
|
|
|
Limitations
|
|
===========
|
|
|
|
This is a non exhaustive list of MPD features that Mopidy doesn't support.
|
|
Items on this list will probably not be supported in the near future.
|
|
|
|
- Only a single password is supported. It gives all-or-nothing access.
|
|
- Toggling of audio outputs is not supported
|
|
- Channels for client-to-client communication are not supported
|
|
- Stickers are not supported
|
|
- Crossfade is not supported
|
|
- Replay gain is not supported
|
|
- ``stats`` does not provide any statistics
|
|
- ``decoders`` does not provide information about available decoders
|
|
|
|
The following items are currently not supported, but should be added in the
|
|
near future:
|
|
|
|
- Modifying stored playlists is not supported
|
|
- ``tagtypes`` is not supported
|
|
- Live update of the music database is not supported
|
|
|
|
|
|
Configuration
|
|
=============
|
|
|
|
See :ref:`config` for general help on configuring Mopidy.
|
|
|
|
.. literalinclude:: ../../mopidy/mpd/ext.conf
|
|
:language: ini
|
|
|
|
.. confval:: mpd/enabled
|
|
|
|
If the MPD extension should be enabled or not.
|
|
|
|
.. confval:: mpd/hostname
|
|
|
|
Which address the MPD server should bind to.
|
|
|
|
``127.0.0.1``
|
|
Listens only on the IPv4 loopback interface
|
|
``::1``
|
|
Listens only on the IPv6 loopback interface
|
|
``0.0.0.0``
|
|
Listens on all IPv4 interfaces
|
|
``::``
|
|
Listens on all interfaces, both IPv4 and IPv6
|
|
|
|
.. confval:: mpd/port
|
|
|
|
Which TCP port the MPD server should listen to.
|
|
|
|
.. confval:: mpd/password
|
|
|
|
The password required for connecting to the MPD server. If blank, no
|
|
password is required.
|
|
|
|
.. confval:: mpd/max_connections
|
|
|
|
The maximum number of concurrent connections the MPD server will accept.
|
|
|
|
.. confval:: mpd/connection_timeout
|
|
|
|
Number of seconds an MPD client can stay inactive before the connection is
|
|
closed by the server.
|
|
|
|
.. confval:: mpd/zeroconf
|
|
|
|
Name of the MPD service when published through Zeroconf. The variables
|
|
``$hostname`` and ``$port`` can be used in the name.
|
|
|
|
Set to an empty string to disable Zeroconf for MPD.
|
|
|
|
.. confval:: mpd/command_blacklist
|
|
|
|
List of MPD commands which are disabled by the server. By default this
|
|
setting blacklists `listall` and `listallinfo`. These commands don't fit
|
|
well with many of Mopidy's backends and are better left disabled unless
|
|
you know what you are doing.
|