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.

Client

Activate the Ampache service using Settings -> Configure Amarok... -> Internet Services.

Configure the service with the data entered on the server:

Now the Ampache service should appear in the left pane.

Server

On Debian-based distributions like Ubuntu you can install a Ampache-server 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 the Ampache-webinterface 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 webinterface:

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.