Amarok und Ampache

Dank der XML-API können Sie direkt aus Amarok heraus die Dateien Ihrer (Remote) Kataloge durchsuchen und abspielen.

• Ampache 3.5.x (SVN Stable branch) ODER Ampache 3.5.x (Stable Release Tarball)
• Amarok 2.1.x

Um die API zu benutzen müssen Sie die Access Control Lists konfigurieren. Dazu braucht es einen Adminzugang und Zugriff auf die Datei /config/ampache.cfg.php. Ampaches Defaulteinstellungen geben DENY FROM ALL vor, also müssen Sie die ACLs konfigurieren bevor Sie sie im Configfile aktivieren. Im folgenden Beispiel befinden sich alle Computer in Ihrem lokalen Netzwerk (192.168.1.0/24).

Um die Konfiguration einfacher zu machen besitzen neuere Ampache Installationen besitzen bereits 4 ACLs.

Wenn Sie in Ihrer Ampache Installation diese ACLs nicht vorfinden sollten, finden Sie unter Access Control Lists Informationen um diese anzulegen.

Sie müssen den API Zugriff auf Ampache aus Ihrem lokalen Netzwerk heraus erlauben. Gehen Sie dazu in das Admin Menü und klicken sie auf „Show ACLs“ → „Add API / RPC Host“. Für weitere Informationen zum Konfigurieren von ACLs sehen Sie bitte unter Access Control Lists nach.

Vergeben Sie einen Namen, in diesem Beispiel wurde „My Network“ gewählt. Es gibt drei ACL Typen. Die Standardeinstellungen erlauben den Zugriff auf Ampache über Amarok, aber nicht über das Webinterface. Wenn sie den Zugriff über die API, das Webinterface, und Streaming erlauben wollen wählen Sie „RPC + All“ als Typ aus.

Sie werden bemerken dass die ersten zwei ACLs keinen Key besitzen. Keys werden nur für die XML-RPC Kommunikation zwischen Ampache Servern benötigt. Nun müssen Sie die ACLs noch aktivieren. Öffnen Sie dazu die Datei /config/ampache.cfg.php und aktivieren Sie die access_control Direktive wie folgt:

; Use Access List 
; Toggle this on if you want ampache to pay attention to the access list 
; and only allow streaming/downloading/xml-rpc from known hosts by default
; xml-rpc will not work without this on.
; DEFAULT: false
access_control = "true"

Loggen Sie sich aus und erneut ein. Wenn das funktioniert hat versuchen Sie Ihre Musik abzuspielen. Wenn eines dieser Dinge fehlschlägt deaktivieren Sie die ACLs und überprüfen sie Ihre ACL Einträge. Wenn Sie nicht herausfinden können woran es liegt, aktivieren Sie das Logging und schauen Sie in die Logs.

An diesem Punkt nehmen wir an dass Sie Amarok2 bereits installiert haben.

Gehen Sie zu Settings → Services. Stellen Sie sicher dass der Ampache Service aktiviert ist und klicken Sie auf Settings im Ampache Plugin. Geben Sie die Details Ihres Servers an und klicken Sie auf add.

Name Dies ist ein Amarok interner Name, hier können Sie Ihren Ideen freien Lauf lassen.

Server Die ist der FQDN Ihres Ampache Servers inklusive http://. Eine gültige Adresse wäre zum Beispiel http://ampache.org/demo.

Username Der Benutzername des Webinterfaces. Wenn Sie einen Benutzer in der RPC ACL angegeben haben, muss dieser Benutzer der in der ACL entsprechen.

Password Das Passwort für das Ampach Webinterface