Amarok/Manual/Organization/Collection/RemoteCollections/Ampache

Ampache

Amarok is able to play music from an Ampache media server. Ampache needs an Apache server to work.

Ampache Client

Activate the Ampache service using Settings -> Configure Amarok... -> Internet Services before Amarok 2.4.1, 2.4.1 on: Settings -> Configure Amarok... -> Plugins.

2.4.1 on: Click on the wrench icon to open the configuration dialog

Configure the service with the data entered on the server:

Now the Ampache service should appear in Media Sources -> Internet.

Ampache Server

On Debian-based distributions like Ubuntu you can install Ampache using

sudo apt-get install ampache

You need to tell the Apache server where it can find the Ampache files. Create the file /etc/apache2/conf.d/ampache with the following content:

Alias /music "/usr/share/ampache/www/"
<directory />
    DirectoryIndex index.php index.html
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
</directory>

Restart Apache with the command

/etc/init.d/apache2 restart

so you can access Ampache's web interface using http://localhost/music/. You get the following page:

Choose your language and click Start configuration to configure Ampache. Enter the configuration of your MySQL database:

Click Insert Database to create the user and database. You will get an error message because there is already a configuration file which is empty. Just enter your MySQL configuration again and click Write Config and you will get a configuration file as download.

Save this file to /usr/share/ampache/www/config/ampache.cfg.php and overwrite the existing (empty) configuration. After you clicked Continue to Step 3 you can create the initial account to manage Ampache.

Log into your newly created account:

And you will get the web interface:

Click on Add a Catalog in the Admin on the left to create a new catalog of music.

Create a new guest account using Admin -> Add User:

Now you need to allow guest access on your server. Open the configuration in /usr/share/ampache/www/config/ampache.cfg.php and remove the ';' character before auto_user = "guest". Restart Apache and the server configuration is finished.