Clone this wiki locally
Configuring MPD for Localplay
Ampache has the ability to remote control an MPD instance over the network. MPD or Music Player Daemon is designed for integrating a computer into a stereo system that provides control for music playback over a local network. this document will walk you through the steps on how to setup localplay with MPD. It is assumed that you have Admin rights on your Ampache instance.
Activate MPD module
In all new installs of Ampache the MPD module is, by default, enabled. To verify that it is currently enabled click on Modules and then look under Localplay Modules.
When you activate the MPD module Ampache automatically enables Localplay globally, sets your play type to Localplay, sets your Localplay Access to Admin and sets your Localplay type to MPD. You must do the same for any other user you would like to be able to use MPD.
Adding a localplay instance
Once you have that setup you will need to add an Instance of MPD. Ampache works on the principle of distinct Localplay Instances which each have their own settings, an owner and an access level. This allows a single user to control a very large number of MPD instances with a click of a button.
Creating the localplay instance
Localplay --> Add instance
You will be given several options when creating an instance, such as instance name and hostname and port. Name is how Ampache will represent the instance on the sidebar. The Hostname is the IP or DNS name of your MPD instance. If MPD is non-local make sure that it is listening on the correct IP. Port is by default 6600 only change if you have modified your mpd.conf.
Selecting the instance
Once you created an instance you the name of the instance should show up under Active instance. All that you have to do to start using it is click on its name. It should turn blue to indicate that the change was successful. At any time you can switch back to Streaming by clicking None or start managing a different MPD instance by clicking on its name.
Tips & Tricks
- Ampache can't connect to MPD but I'm sure I've got the host set correctly: If MPD is not on the same box as your ampache instance you need to make sure that MPD is not listening on localhost, instead it will need to listen on all addresses so that it can accept the stream from Ampache.
- I can add songs but I can't stop or start MPD: Most likely your Localplay Access is set to user, change it to Manager or Admin.
Ampache and Mopidy
If you're using Mopidy then you should be aware that it is also possible to browse and play your Ampache library from Mopidy web interface using Subsonic API on Ampache and the Mopidy-Subsonic backend extension.