[[Vorlage(archiviert, "Die letzte/aktuellste Version von Zeya datiert auf September 2011.")]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:sudo: Root-Rechte]
[:Editor: Einen Editor öffnen]
}}}
[[Inhaltsverzeichnis()]]

[[Bild(Wiki/Icons/Tango/audio-x-generic.png, 48, align=left)]]
[http://web.psung.name/zeya/ Zeya] {en} ist ein [wikipedia:Streaming_Audio:Streaming]-Server für Musik, der ausschließlich HTML 5 verwendet – praktisch wird zur Wiedergabe auf dem Client weder ein Audio-Player noch Flash, Silverlight, Java oder ein anderes Browser-Plugin benötigt. Dafür aber zwangsläufig ein moderner [:Internetanwendungen:Webbrowser], der HTML 5 umsetzen kann, beispielsweise:

 * [:Firefox:]
 * [:Chromium:] bzw. Google Chrome
 * [:Archiv/Midori:]
 * [:Opera:]
 * [:Vivaldi:]

Programmiert ist Zeya in [:Python:] und JavaScript. Alternative Server sind im Artikel [:Musik_verwalten:] zu finden.

= Installation =
[[Bild(Wiki/Icons/synaptic.png, 48, align=right)]]
Zeya ist bis [:Vivid:Ubuntu 15.04] in den offiziellen Paketquellen enthalten. Folgendes Paket muss installiert [1] werden:

{{{#!vorlage Paketinstallation
zeya, universe
}}}

Bei der Installation werden weitere Pakete wie [:mpg123:] zur Dekodierung von MP3 (das bei Bedarf durch '''mpg321''' ersetzt werden kann) sowie die Unterstützung für [:FLAC:] und [wikipedia:MP4:] zusätzlich installiert.

= Verwendung =
== Server ==
Nun wechselt man in den Ordner mit den Musikdateien (z.B. '''~/Musik''') und startet das Programm [2]:

{{{#!vorlage Befehl
cd ~/Musik
zeya
}}}
Der aktuelle Ordner wird rekursiv durchsucht und enthaltene Musikdateien zum Abspielen angeboten. Beendet wird das Programm mit der Tastenkombination [[Vorlage(Tasten, strg+c)]].

Im Musikordner wird die Datei '''zeya.db''' angelegt, die die gefundenen Titel enthält. Werden in diesem Ordner Dateien gelöscht oder hinzugefügt, während Zeya läuft, muss

 1. Zeya beendet
 1. '''zeya.db''' gelöscht und
 1. Zeya neu gestartet werden

damit die Datenbank aktualisiert wird.

== Client ==
[[Bild(./zeya_cropped.png, 250, align=right)]]
Im Webbrowser gibt man nun die Adresse des Servers ein:

 * `http://<Server-IP>:8080/` oder
 * `http://localhost:8080/` (nur direkt auf dem Server selbst möglich)

== Tastenkürzel ==
Zeya kann auch über die Tastatur bedient werden.

[[Bild(./zeya_help.png, 200, align=right)]]

{{{#!vorlage Tabelle
<rowclass="titel"-2> Navigation
+++
<rowclass="kopf"> Taste
Beschreibung
+++
<cellstyle="width:25%"> [[Vorlage(Tasten, leer)]]
Wiedergabe/Pause
+++
[[Vorlage(Tasten, j)]]
nächster Titel
+++
[[Vorlage(Tasten, k)]]
vorheriger Titel
+++
[[Vorlage(Tasten, ?)]]
Kurzhilfe
+++
<rowclass="titel"-2> Suche
+++
<cellstyle="width:25%"> [[Vorlage(Tasten, /)]]
Suchen nach...
+++
`title:`
Titel
+++
`artist:`
Künstler
+++
`album:`
Album
}}}

= Konfiguration =
Die Konfiguration findet über Optionen beim Programmstart statt. Die möglichen Optionen sind der [:man:Manpage] oder folgender Tabelle zu entnehmen. Diese können beliebig miteinander kombiniert werden, aber es kann immer nur ein `--backend=...` verwendet werden.

||<-2 rowclass="titel"> Programmparameter ||
||<rowclass="kopf"> Zweck || Option ||
|| Ort der Musikbibliothek (zählt als `--backend`) || `--path=/Pfad/zum/Musikordner` ||
||<rowclass="highlight"> Bibliothek von [:Rhythmbox:] einbinden || `--backend=rhythmbox` ||
|| [wikipedia:M3U:]-Wiedergabeliste festlegen (auch [wikipedia:PLS_(Dateiformat):PLS] möglich) || `--backend=playlist --path=/Pfad/zur/playlist.m3u` ||
||<rowclass="highlight"> zu verwendende [#Port-Nummer Port-Nummer] (Standard: 8080) || `--port=...` ||
|| [wikipedia:Bitrate:] (Standard: 64 kbps) || `--bitrate=128` ||
||<rowclass="highlight"> nur lokalen Zugriff erlauben || `--bind_address=127.0.0.1` ||
|| [http://httpd.apache.org/docs/2.0/programs/htpasswd.html Passwort] {en} verwenden || `--basic_auth_file=/Pfad/zur/.htpasswd` ||

Beispiel:
{{{#!vorlage Befehl
zeya --path=/Pfad/zum/Musikordner --bitrate=128 --bind_address=127.0.0.1 --port=9999
}}}

== Auto-Start ==
Um Zeya als [:Dienste:Dienst] mit [:Archiv/Upstart:] zu verwenden, kopiert man die Datei '''/etc/zeya.conf''' mit Root-Rechten [3] nach '''/etc/init/zeya.conf'''. Anschließend bearbeitet [4] man die kopierte Datei und passt die Optionen in der letzten Zeile den eigenen Wünschen an:

{{{
exec python /usr/bin/zeya --path=/Pfad/zur/Musik --port=8080
}}}
Nun muss die Upstart-Konfiguration aktualisiert werden:

{{{#!vorlage Befehl
sudo initctl reload-configuration
}}}
Die eigentliche Steuerung erfolgt mit der Befehl:
 
{{{#!vorlage Befehl
sudo initctl [start | stop] zeya
}}}

= Problembehebung =
== Port-Nummer ==
Normalerweise verwendet Zeya den [wikipedia:Port_(Protokoll):Port] `8080`. Ist dieser Port schon von anderen Dienste wie z.B. einem Proxy belegt, kann man den Port ändern:

{{{#!vorlage Befehl
zeya --port=9000
}}}

= Links =
 * [http://web.psung.name/zeya/cookbook/ Zeya Cookbook] {en} - Programmoptionen
  * [launchpad:zeya:Zeya] {en} auf Launchpad
  * [github:psung/zeya:Quellcode] {en}
 * [http://www.linuxjournal.com/content/serve-your-music-zeya Serve Up Your Music with Zeya] {en} - Artikel Linux Journal, 06/2010
 * [:Musik_verwalten:] - Übersichtsartikel

#tag: Netzwerk, Internet, Server, Multimedia, Audio, Python