<chapter id="advanced-features">
<title
>&amarok;'s fortgeschrittene Funktionen</title>


<sect1 id="keybd-shortcuts">
<title
>Tastenkürzel</title>

<para
>&amarok; benutzt wie alle anderen Programme Tastenkürzel. Unten finden Sie eine Liste dieser Kürzel und ihre Funktion. Die globalen Tastenkürzel können Sie einrichten, indem Sie mit der rechten Maustaste in das Player-Fenster klicken und <guimenuitem
>Globale Tastenkürzel einrichten...</guimenuitem
> auswählen. Die &amarok;-spezifischen Tastenkürzel können Sie einrichten, indem Sie mit der rechten Maustaste in das Player-Fenster klicken und <guimenuitem
>Kurzbefehle festlegen...</guimenuitem
> auswählen.</para>

<tip
><para
>Sie können eventuell vorhandene Multimedia-Tasten so einrichten, dass sie als &amarok;-Kurzbefehle funktionieren. Dadurch machen Sie Ihre Tastatur zum &amarok;-Kontrollzentrum.</para
></tip>

<para
>Die globalen Tastenkürzel sind:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>X</keycap
></keycombo
></entry>
<entry
>Wiedergabe</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Pause</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>V</keycap
></keycombo
></entry>
<entry
>Stopp</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Nächstes Stück</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Voriges Stück</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Num_Plus</keycap
></keycombo
></entry>
<entry
>Lautstärke erhöhen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Num_Minus</keycap
></keycombo
></entry>
<entry
>Lautstärke senken</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Hinzufügen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Wiedergabeliste anzeigen/ausblenden</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>OSD anzeigen</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>Die &amarok;-spezifischen Kurzbefehle sind:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Kopieren</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Num_Eingabe</keycap
></keycombo
></entry>
<entry
>Zum aktuellen Stück springen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Beenden</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Wiederholen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Wiedergabeliste speichern</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Alles auswählen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>H</keycap
></keycombo
></entry>
<entry
>Zufallsmodus</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Rückgängig</entry>
</row>


</tbody>
</tgroup>
</informaltable>


<para
>Die Kurzbefehle für den Wiedergabelisten-Browser sind:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Leertaste</keycap
></entry>
<entry
>Wiedergabeliste laden</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Wiedergabeliste umbenennen</entry>
</row>

<row>
<entry
><keycap
>Rücktaste</keycap
></entry>
<entry
>Wiedergabeliste entfernen</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="the-dcop-interface">
<title
>Die DCOP-Schnittstelle</title>

<para
>Mit der DCOP-Schnittstelle steht Ihnen ein einfacher Weg zur Verfügung, &amarok; mit eigenen Skripten anzupassen.</para>

<para
>Die DCOP-Schnittstelle hat viele generische Funktionen, die zumeist auch in anderen KDE-Programmen zu finden sind. Dieser Abschnitt beschreibt die DCOP-Funktionen des Players. Ein Beispielaufruf für die DCOP-Funktion <quote
>Pause</quote
> wäre:</para>

<para
><prompt
>&percnt;</prompt
>dcop amarok player pause <command
></command
></para
> 

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>DCOP-Funktion</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>album</entry>
<entry
>Die Funktion <quote
>album</quote
> gibt das Album des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>artist</entry>
<entry
>Die Funktion <quote
>artist</quote
> gibt den Interpret des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>bitrate</entry>
<entry
>Die Funktion <quote
>bitrate</quote
> gibt die Bitrate des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>comment</entry>
<entry
>Die Funktion <quote
>comment</quote
> gibt den Kommentar zum aktuell laufenden Stück zurück.</entry>
</row>

<row>
<entry
>coverImage</entry>
<entry
>Die Funktion <quote
>coverImage</quote
> gibt die URL zu dem Cover-Bild des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>currentTime</entry>
<entry
>Die Funktion <quote
>currentTime</quote
> gibt die Abspiel-Position (mm:ss) des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>encodedURL</entry>
<entry
>Die Funktion <quote
>encodedURL</quote
> gibt die URL des aktuell laufenden Stücks zurück. Leerzeichen werden kodiert.</entry>
</row>

<row>
<entry
>genre</entry>
<entry
>Die Funktion <quote
>genre</quote
> gibt das Genre des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>nowPlaying</entry>
<entry
>Die Funktion <quote
>nowPlaying</quote
> gibt "Interpret - Titel" des aktuell laufenden Stücks zurück. Falls eines der beiden id3-Tags fehlt, wird nur "Interpret" bzw. "Titel" zurückgegeben (ohne den Bindestrich "-").</entry>
</row>

<row>
<entry
>title</entry>
<entry
>Die Funktion <quote
>title</quote
> gibt den Titel des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>totalTime</entry>
<entry
>Die Funktion <quote
>totalTime</quote
> gibt die Länge des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>track</entry>
<entry
>Die Funktion <quote
>track</quote
> gibt die Stücknummer des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>year</entry>
<entry
>Die Funktion <quote
>year</quote
> gibt das Jahr des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>isPlaying</entry>
<entry
>Die Funktion <quote
>isPlaying</quote
> gibt true zurück, wenn die Wiedergabe gerade läuft. Ansonsten wird false zurückgegeben.</entry>
</row>

<row>
<entry
>randomModeStatus</entry>
<entry
>Die Funktion <quote
>randomModeStatus</quote
> gibt den Status desZufallsmodus zurück. Der Rückgabewert ist true oder false.</entry>
</row>

<row>
<entry
>repeatPlaylistStatus</entry>
<entry
>Die Funktion <quote
>repeatPlaylistStatus</quote
> gibt den Status der Funktion Wiedergabeliste wiederholen zurück. Der Wert ist true oder false.</entry>
</row>

<row>
<entry
>repeatTrackStatus</entry>
<entry
>Die Funktion <quote
>repeatTrackStatus</quote
> gibt den Status der Funktion Stück wiederholen zurück. Der Wert ist true oder false.</entry>
</row>

<row>
<entry
>getVolume</entry>
<entry
>Die Funktion <quote
>getVolume</quote
> gibt die aktuelle Lautstärke zurück (ein Wert von 0-100).</entry>
</row>

<row>
<entry
>sampleRate</entry>
<entry
>Die Funktion <quote
>sampleRate</quote
> gibt die Sample-Rate des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>score</entry>
<entry
>Die Funktion <quote
>score</quote
> gibt die Bewertung zu dem aktuellen Stück zurück.</entry>
</row>

<row>
<entry
>status</entry>
<entry
>Die Funktion <quote
>status</quote
> gibt den Status des Treibers zurück. 2 steht für Wiedergabe, 1 für Pause und 0 für Ruhezustand.</entry>
</row>

<row>
<entry
>trackCurrentTime</entry>
<entry
>Die Funktion <quote
>trackCurrentTime</quote
> gibt die bereits abgelaufene Spielzeit des aktuellen Stücks zurück.</entry>
</row>

<row>
<entry
>trackTotalTime</entry>
<entry
>Die Funktion <quote
>trackTotalTime</quote
> gibt die komplette Spielzeit des aktuell laufenden Stücks in Sekunden zurück.</entry>
</row>

<row>
<entry
>addMedia</entry>
<entry
>Die Funktion <quote
>addMedia</quote
> wird benutzt, um der Wiedergabeliste einzelne Dateien hinzuzufügen.</entry>
</row>

<row>
<entry
>addMediaList</entry>
<entry
>Die Funktion <quote
>addMediaList</quote
> wird benutzt, um der Wiedergabeliste mehrere Dateien hinzuzufügen.</entry>
</row>

<row>
<entry
>clearPlaylist</entry>
<entry
>Die Funktion <quote
>clearPlaylist</quote
> wird benutzt, um die gesamte Wiedergabeliste zu leeren.</entry>
</row>

<row>
<entry
>configEqualizer</entry>
<entry
>Die Funktion <quote
>configEqualizer</quote
> öffnet den Einrichtungsdialog des Equalizers.</entry>
</row>

<row>
<entry
>enableOSD</entry>
<entry
>Die Funktion <quote
>enableOSD</quote
> kann zum aktivieren und deaktivieren des On-Screen-Display benutzt werden. Als Argument muss true oder false übergeben werden.</entry>
</row>

<row>
<entry
>enableRandomMode</entry>
<entry
>Die Funktion <quote
>enableRandomMode</quote
> wird benutzt, um den Zufallsmodus ein-/auszuschalten. 0 bedeutet "ausschalten" und 1 bedeutet "einschalten".</entry>
</row>

<row>
<entry
>mute</entry>
<entry
>Die Funktion <quote
>mute</quote
> wird benutzt, um das aktuell laufende Stück Stumm zu schalten bzw. die Stummschaltung wieder aufzuheben.</entry>
</row>

<row>
<entry
>next</entry>
<entry
>Die Funktion <quote
>next</quote
> bewirkt einen Sprung zum nächsten Stück.</entry>
</row>

<row>
<entry
>pause</entry>
<entry
>Die Funktion <quote
>pause</quote
> hält die Wiedergabe des aktuell laufenden Stücks an.</entry>
</row>

<row>
<entry
>play</entry>
<entry
>Die Funktion <quote
>play</quote
> startet die Wiedergabe, wo sie zuletzt gestoppt wurde.</entry>
</row>

<row>
<entry
>playMedia</entry>
<entry
>Die Funktion <quote
>playMedia</quote
> startet die Wiedergabe eines über eine KURL angegebenen Stückes.</entry>
</row>

<row>
<entry
>playPause</entry>
<entry
>Die Funktion <quote
>playPause</quote
> startet die Wiedergabe, falls sie gestoppt ist, oder hält die Wiedergabe an, falls sie gerade läuft.</entry>
</row>

<row>
<entry
>prev</entry>
<entry
>Die Funktion <quote
>prev</quote
> bewirkt einen Sprung zum vorigen Stück.</entry>
</row>

<row>
<entry
>scanCollection</entry>
<entry
>Die Funktion <quote
>scanCollection</quote
> führt ein manuelles Erfassen der Sammlung durch.</entry>
</row>

<row>
<entry
>seek</entry>
<entry
>Die Funktin <quote
>seek</quote
> wird zum ansteuern einer bestimmten Position in einem Stück verwendet. Geben Sie die Position in Sekunden an.</entry>
</row>

<row>
<entry
>seekRelative</entry>
<entry
>Die Funktin <quote
>seekRelative</quote
> wird zum ansteuern einer zur aktuellen Spielzeit relativen Position in einem Stück verwendet. Geben Sie die Position in Sekunden an.</entry>
</row>

<row>
<entry
>setEqualizerEnabled</entry>
<entry
>Die Funktion <quote
>setEqualizerEnabled</quote
> kann zum aktivieren und deaktivieren des Equalizer benutzt werden. Als Argument muss true oder false übergeben werden.</entry>
</row>

<row>
<entry
>setVolume</entry>
<entry
>Die Funktion <quote
>setVolume</quote
> stellt die Lautstärke auf den angegebenen Wert ein (0-100).</entry>
</row>

<row>
<entry
>showOSD</entry>
<entry
>Die Funktion <quote
>showOSD</quote
> zeigt das On-Screen-Display mit den Informationen zum aktuellen Stück an.</entry>
</row>

<row>
<entry
>stop</entry>
<entry
>Die Funktion <quote
>stop</quote
> stoppt die Wiedergabe, falls sie gerade läuft.</entry>
</row>

<row>
<entry
>togglePlaylist</entry>
<entry
>Die Funktion <quote
>togglePlaylist</quote
> schaltet die Anzeige des Wiedergabelisten-Fenster ein oder aus.</entry>
</row>

<row>
<entry
>volumeDown</entry>
<entry
>Die Funktion <quote
>volumeDown</quote
> senkt die Lautstärke um einen Schritt.</entry>
</row>

<row>
<entry
>volumeUp</entry>
<entry
>Die Funktion <quote
>volumeUp</quote
> erhöht die Lautstärke um einen Schritt.</entry>
</row>


</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmd-line-options">
<title
>Optionen auf der Kommandozeile</title>

<para
>&amarok; unterstützt die Kommandozeilen-Optionen von Qt und &kde;. Zusätzlich hat &amarok; noch einige eigene Kommandozeilen-Optionen.</para>

<para
>Die Qt- und &kde;-Optionen:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Option</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>--help</entry>
<entry
>Hilfe zu den Optionen anzeigen.</entry>
</row>

<row>
<entry
>--help-qt</entry>
<entry
>Qt-Optionen anzeigen</entry>
</row>

<row>
<entry
>--help-kde</entry>
<entry
>&kde;-Optionen anzeigen.</entry>
</row>

<row>
<entry
>--help-all</entry>
<entry
>Alle Optionen anzeigen.</entry>
</row>

<row>
<entry
>--author</entry>
<entry
>Informationen über den Autor anzeigen.</entry>
</row>

<row>
<entry
>-v, --version</entry>
<entry
>Versionsinformationen anzeigen.</entry>
</row>

<row>
<entry
>--license</entry>
<entry
>Lizenzinformationen anzeigen.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>Die &amarok;-Optionen:</para>

<note
><para
>Die &amarok;-Optionen sollten verwendet werden, während &amarok; läuft.</para
></note>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Option</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>-r, --previous</entry>
<entry
>Zum vorigen Stück in der Wiedergabeliste springen.</entry>
</row>

<row>
<entry
>-p, --play</entry>
<entry
>Die Wiedergabe der aktuellen Wiedergabeliste starten.</entry>
</row>

<row>
<entry
>-s, --stop</entry>
<entry
>Die Wiedergabe stoppen.</entry>
</row>

<row>
<entry
>--pause</entry>
<entry
>Die Wiedergabe anhalten (Pause).</entry>
</row>

<row>
<entry
>-f, --next</entry>
<entry
>Zum nächsten Stück in der Wiedergabeliste springen.</entry>
</row>

<row>
<entry
>-a, --append</entry>
<entry
>Dateien/URLs and die Wiedergabeliste anhängen.</entry>
</row>

<row>
<entry
>-e, --enqueue</entry>
<entry
>Siehe "append", nur für Rückwärtskompatibilität vorhanden.</entry>
</row>

<row>
<entry
>--queue</entry>
<entry
>Dateien/URLs nach dem aktuellen Stück zur Wiedergabe einreihen.</entry>
</row
> 

<row>
<entry
>-m, --toggle-playlist-window</entry>
<entry
>Die Anzeige des Wiedergabelisten-Fensters ein/ausschalten.</entry>
</row>

<row>
<entry
>--wizard</entry>
<entry
>Den Einrichtungsassistent starten.</entry>
</row>

<row>
<entry
>--engine "Name"</entry>
<entry
>Startet &amarok; mit dem Treiber "Name".</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

</chapter>
