====== Amarok und Ampache ======
Dank der [[de:dev:XmlApi|XML-API]] können Sie direkt aus [[http://amarok.kde.org|Amarok]] heraus die Dateien Ihrer (Remote) Kataloge durchsuchen und abspielen.

=== Es werden hier die Einstellungen für Ampache 3.5.x. beschrieben ===

==== Voraussetzungen ====
  * [[https://svn.ampache.org/branches/3.5|Ampache 3.5.x (SVN Stable branch)]] ODER [[https://ampache.org/downloads/stable.tar.gz|Ampache 3.5.x (Stable Release Tarball)]]
  * [[http://amarok.kde.org/wiki/Download|Amarok 2.1.x]]


===== Ampache einrichten =====
Um die API zu benutzen müssen Sie die [[Config:Acl|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.

{{config:acl-default.png?240}}

Wenn Sie in Ihrer Ampache Installation diese ACLs nicht vorfinden sollten, finden Sie unter [[de:config::acl|Access Control Lists]] Informationen um diese anzulegen.

==== Erstellen der benötigten ACL Einträge ====
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 [[de:config:Acl|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. 

{{config:acl-rpc.png?240}}

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 [[de:support#logging_aktivieren|Logging]] und schauen Sie in die Logs.

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

==== Service Einstellungen ====
Gehen Sie zu //Settings// -> //Services//. Stellen Sie sicher dass der [[http://amarok.kde.org/blog/uploads/serviceconfig.png|Ampache Service]] aktiviert ist und klicken Sie auf //Settings// im Ampache Plugin. Geben Sie die [[http://amarok.kde.org/blog/uploads/ampacheconfig.png|Details Ihres Servers]] an und klicken Sie auf //add//.

==== Ampache Einstellungen ====

**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