<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&noatun;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % German "INCLUDE" 
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title
>Das &noatun;-Handbuch</title>

<authorgroup>
<author
> <firstname
>Charles</firstname
> <surname
>Samuels</surname
> <affiliation
><address
><email
>charles@kde.org</email
></address
></affiliation
> </author>
<othercredit role="translator"
><firstname
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>F.Schuette@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit>
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year>
<holder
>Charles Samuels</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-03-01</date>
<releaseinfo
>2.00.00</releaseinfo
> <!-- Use App version here -->

<abstract>
<para
>&noatun; ist ein vielseitiger und erweiterbarer Medienspieler für &kde;.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Noatun</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>mp3</keyword>
<keyword
>Musik</keyword>
<keyword
>Medien</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Einleitung</title>

<para
>&noatun; ist ein vielseitiger und erweiterbarer Medienspieler für &kde;.</para>

<sect1 id="features">
<title
>Fähigkeiten</title>

<para
>Bei &noatun; handelt es sich um eine umfangreiche Oberfläche zu &arts; &mdash; dem Analogen Real-Time-Syntesizer. Um ein zusätzliches Abspielobjekt hinzuzufügen, kann man unter <ulink url="http://noatun.kde.org/plugins.phtml"
>http://notaun.kde.org/plugins.phtml</ulink
> oder <ulink url="http://mpeglib.sf.net"
>http://mpeglib.sf.net</ulink
> nachschauen. Standardmäßig unterstützt &arts; MP3 und MPEG-1. Vorbis wird unterstützt, falls die Vorbis-Bibliotheken bei der Kompilierung von &kde; verfügbar waren. </para>

</sect1>
</chapter>

<chapter id="using-noatun">
<title
>Benutzung von &noatun;</title>

<para
>&noatun; startet standardmäßig mit dem Excellent-Plugin als Benutzeroberfläche. Diese Oberfläche hat von allen die größte Ähnlichkeit zu anderen &kde;-Anwendungen.</para>

<para
>&noatun; ist insofern einzigartig als keine zwei Installationen identisch sind. Außerdem gibt es keine Hauptoberfläche, auch wenn es eine Standardeinstellung gibt. Man kann beliebige Plugins miteinander kombinieren und so &noatun; an die eigenen Wünsche perfekt anpassen. </para>

<sect1 id="title-format">
<title
>Titelformat</title>
<para
> Der Einrichtungsdialog zu &noatun; hat ein Textfeld zur Einstellung des <guilabel
>Titelformates</guilabel
>. Man kann mit einem Formatierungsstring festlegen, wie Titel erscheinen sollen. </para>

<itemizedlist
> <listitem
><para
>Jeder Text erscheint normal, wenn er nicht innerhalb eines <literal
>$( )</literal
> eingeschlossen ist.</para
></listitem
> <listitem
><para
>Der Text innerhalb von <literal
>$( )</literal
> wird durch &noatun; durch den Inhalt der angegebenen Einstellung ersetzt.</para
></listitem
> <listitem
><para
>Falls sich innerhalb des <literal
>$( )</literal
> Anführungszeichen befinden, wird der Text innerhalb der Anführungszeichen normal dargestellt, falls eine Eigenschaft dieses Namens existiert.</para
></listitem
> <listitem
><para
>Anführungszeichen können entweder am Beginn, am Ende oder am Beginn und Ende von <literal
>$( )</literal
> eingefügt werden.</para
></listitem
> </itemizedlist>

<para
> Zum Beispiel wird <literal
>$(bitrate)</literal
> durch die Bitrate der Datei ersetzt, so wie sie vom Metatag-Plugin gelesen worden ist. Falls man innerhalb des Feldes Anführungszeichen setzt, so wird der Text darin dargestellt: <literal
>$(bitrate"kbps")</literal
> zeigt z.B. die Bitrate der Datei gefolgt von den Buchstaben <literal
>&quot;kbps&quot;</literal
> an. Falls die Eigenschaft <quote
>bitrate</quote
> nicht existiert, wird gar nichts angezeigt. </para
>	
</sect1>

</chapter>

<chapter id="using-noatun-plugins">
<title
>Benutzung von &noatun;-Plugins</title>

<para
>Um ein anderes Plugin auszuwählen, rufen Sie im Menü <guimenuitem
>Einstellungen</guimenuitem
> <guimenuitem
>&noatun; einrichten...</guimenuitem
> aus. Auf der Karteikarte <guilabel
>Plugins</guilabel
> können Sie den gewünschten Listeneintrag auswählen. Man aktiviert ein Plugin, indem man das Ankreuzfeld neben dem Namen markiert. Für &noatun; ist mindestens ein User-Interface-Plugin und genau ein Stücklisten-Plugin erforderlich. </para>

<sect1 id="milk-chocolate">
<title
>Vollmilchschokolade (Milk Chocolate)</title>

<para
>Milk Chocolate ist eine kleine, einfache Benutzeroberfläche. Die Knöpfe verhalten sich ähnlich wie bei einem CD-Spieler; der Knopf zum Auswerfen öffnet die Stückliste. Der Knopf mit dem Kreuz daraus entfernt den aktuellen Stücklisteneintrag, nicht jedoch die Datei. Der Knopf mit dem Pfeil schaltet die Endloswiederholung ein. Sie erhalten ein Menü durch klicken auf die <mousebutton
>rechte</mousebutton
> Maustaste im Fenster.</para>

</sect1>

<sect1 id="young-hickory">

<title
>Young Hickory</title>

<para
>Young Hickory ist ein Plugin für den Systembereich in der &kde;-Kontrollleiste. Dieser befindet sich standardmäßig links neben der Uhr.</para>

<para
>Klicken Sie mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol, um ein kleines Menü aufzurufen. Klicken auf die <mousebutton
>linke</mousebutton
> Maustaste schaltet die Sichtbarkeit der &noatun;-Bedienoberfläche ein und aus. Anzumerken ist, dass unter anderem Stücklisten nicht als zur Bedienoberfläche zugehörig betrachtet werden.</para>

</sect1>

<sect1 id="html-exporter">
<title
><acronym
>HTML</acronym
>-Stücklistenexport</title>

<para
>Diese Plugin überträgt Ihre Stückliste in eine <acronym
>HTML</acronym
>-Tabelle. Die Einrichtungsseite erlaubt die Einstellung von Farben, Hintergundbild und die Aktivierung des Überstreich-Modus (Veränderung der Farbe einer Verknüpfung beim Überstreichen mit demMauszeiger).</para>

<para
>Wenn Sie die Einstellungen vorgenommen haben, können Sie im Menü <guimenu
>Aktionen</guimenu
> mit dem Eintrag <guimenuitem
>Stücklistenexport</guimenuitem
> einen Dateidialog öffnen, der die Auswahl der Zieldatei ermöglicht. </para>

</sect1>

<sect1 id="kjofol-skin">
<title
><application
>K-Jöfol</application
>-Oberflächen</title>

<para
>Der &noatun; <application
>K-Jöfol</application
> Oberflächenlader ist eine teilweise Reimplementation des gleichnamigen &Windows;-Programms.</para>

<para
>&noatun;s Implementation hat leider einige Begrenzungen. Die Oberflächen müssen zum Beispiel unkomprimiert sein.</para>

<para
>Um eine Oberfläche (im &Windows;-ZIP-Format) zu installieren, können Sie den Oberflächenlader, den im Fenster &noatun; Einstellungen finden, nutzen.</para>

<para
>Weil einige Oberflächen nicht richtig zusammengestellt werden und der Oberflächenlader nicht Eventualitäten berücksichtigen kann können Sie noch diesen Anweisungen folgen, sollte die Installation einer Oberfläche nicht klappen:</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>cd</command
> <filename class="directory"
>$KDEHOME/share/apps/noatun</filename
></userinput>
<prompt
>%</prompt
> <userinput
><command
>mkdir</command
> <option
>Oberflächen</option
></userinput
> (wenn benötigt)
<prompt
>%</prompt
> <userinput
><command
>cd</command
> <option
>Oberflächen</option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>mkdir</command
> <option
>neue_Oberfläche</option
> ; <command
>cd</command
> <replaceable
>neue_Oberfläche</replaceable
></userinput>
<prompt
>%</prompt
> <userinput
><command
>unzip</command
> <replaceable
>/Pfad/zu/neue_Oberfläche.zip</replaceable
></userinput
></screen>

<para
>Sie können mit Hilfe des Tutorials auf <ulink url="http://www.angelfire.com/mo/nequeim/tutorial.html"
>http://www.angelfire.com/mo/nequiem/tutorial.html</ulink
> Oberflächen selbst erstellen. </para>

</sect1>

<sect1 id="splitplaylist">
<title
>Aufgeteilte Abspielliste</title>

<para
> Die aufgeteilte Abspielliste hat ein einfaches Design. Ein Doppelklick auf einen Eintrag startet dessen Wiedergabe (eine andere Möglichkeit ist dessen Auswahl und die <keycap
>Enter</keycap
>-Taste). Außerdem kann man Dateien oder &URL;s auf die Abspielliste ziehen. </para>

<para
> Seit &kde; 3.0 speichert die aufgeteilte Abspielliste (<acronym
>SPL</acronym
>) ihre Daten im &XML;-Format, importiert aber automatisch die <acronym
>m3u</acronym
>-Liste, falls eine &XML;-Datei nicht existiert. Das heißt, man kann zur automatischen Erzeugung von Stücklisten einfach in die m3u-Datei schreiben und die &XML;-Datei löschen. </para>

<para
> Der Name aufgeteilte Abspielliste ist ein bisschen irreführend, da die Liste nicht wirklich geteilt ist. Der Name stammt vom ursprünglichen geteilten Design (aus der Anfangszeit von &noatun;). </para>
</sect1>

<sect1 id="winampskin">
<title
>Winamp-Oberflächen</title>
<para
> Falls man die <trademark
>Winamp</trademark
>-Oberfläche verwendet, erscheint sie vermutlich vertraut. Klicken auf den Timer schaltet zwischen heraufzählen und herunterzählen um. Wählt man den Scope-Bereich aus, so wird zwischen aktiviertem und deaktiviertem Scope umgeschaltet. Durch Doppelklicken auf die Titelleiste kann man den Schattenmodus umschalten. Klicken mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol oben links zeigt die Standard-Werkzeugleiste von &noatun;. </para>
<para
> Man kann eine neue Oberfläche installieren, indem man unter <filename class="directory"
>$KDEHOME/share/apps/noatun/skins/winamp</filename
> ein neues Verzeichnis anlegt und die Oberfläche dort auspackt. <trademark
>Winamp</trademark
>-Dateien mit der Endung <literal role="extension"
>.wsz</literal
> werden wie normale ZIP-Dateien behandelt. Man sollte sie vor dem auspacken allerdings umbenennen. </para>
</sect1>

<sect1 id="metatag">
<title
>Metatag</title>
<para
> Metatag ist ein Plugin, das mit Hilfe von KFile Informationen über eine Datei einliest. Dieser Mechanismus wird auch für die Kurzhilfen von &konqueror; verwendet. Neben der Anzeige von Informationen können diese auch über das Menü <guimenu
>Aktionen</guimenu
> <guimenu
>Notizeditor...</guimenu
> geändert werden. Sowohl <acronym
>ID3</acronym
>- als auch OggVorbis-Tags können bearbeitet werden. Außerdem wird die Bitrate eingelesen. </para>
</sect1>

<sect1 id="keyz">
<title
>Keyz</title>
<para
> Carsten Pfeiffer hat sich gegen die lange Tradition in &noatun; entschieden, Plugins in einer möglichst unorthodoxen Weise zu benennen. Der Grund für die Konvertierung eines S zu einem Z ist nicht bekannt. </para>
<para
> Dieses Plugin ermöglicht die Verknüpfung von &noatun;-Aktionen mit Tastenkombinationen. Diese Tastenkombinationen funktionieren von überall her, nicht bloß innerhalb von &noatun;. Damit kann man <quote
>Multimedia-Tastaturen</quote
> zum Leben erwecken. </para>
</sect1>

<sect1 id="ir-control">
<title
>Infrarot-Bedienung</title>
<para
> Falls man über eine Fernbedienung für den Rechner verfügt (TV-Karten mit <trademark class="registered"
>Brooktree</trademark
>-Tuner verfügen über eine solche) und diese Fernbedienung von <ulink url="http://www.lirc.org"
>LIRC</ulink
> unterstützt wird, kann man dieses Plugin verwenden. Wie bei Keyz erlaubt das Plugin die Verbindung von Aktionen und Knopfdrücken. </para>
<para
> Um eine Aktion mit einem Tastendruck zu verbinden, lädt man das Plugin und geht auf die Seite Infrarot-Fernbedienung im Einrichtungsdialog von &noatun;. Dort wählt man den Tastendruck in der Liste und wählt die durchzuführende Aktion im Auswahlfeld darunter. Falls, wie z.B. bei der Lautstärkeregelung, eine Aktion dauernd wiederholt werden soll, markiert man das entsprechende Ankreuzfeld und wählt das Wiederholungsintervall aus. </para>
<para
> Falls man über eine <acronym
>TV</acronym
>-Karte verfügt, ist ein nützlicher Trick, den Knopf <guibutton
>Stumm</guibutton
> mit der Pause-Taste zu verbinden. Dadurch wird gleichzeitig das <acronym
>TV</acronym
>-Programm stumm geschaltet und &noatun; nimmt seine Wiedergabe wieder auf, und umgekehrt. Das ist sehr nützlich für Werbeunterbrechungen. </para>
</sect1>
</chapter>

<chapter id="questions-answers-and-tips">

<title
>Fragen, Antworten und Tipps</title>

<qandaset id="faq">
<title
>Häufig gestellte Fragen</title>
<qandaentry>
<question>
<para
>Die Musik setzt bei der Bewegung von Fenstern häufig aus.</para>
</question>
<answer>
<para
> Man kann die Puffer von &arts; auf folgende Art vergrößern: </para
> 

<itemizedlist
> <listitem
><para
>&kcontrol; starten</para
></listitem
> <listitem
><para
>die Gruppe <guilabel
>Klänge</guilabel
> auswählen</para
></listitem
> <listitem
><para
>den Abschnitt <guilabel
>Sound-Server</guilabel
> auswählen</para
></listitem
> <listitem
><para
>die Antwortzeit vergrößern &mdash; 384ms ist auf den meisten Rechnern ausreichend.</para
></listitem
> </itemizedlist
> 

<para
> Alternativ kann man auch den Sound-Server mit Echtzeit-Priorität starten. Das kann allerdings zum Systemabsturz führen. </para
> 

</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Ich kann eine Stückliste oder eine Benutzeroberfläche nicht entfernen.</para>
</question>
<answer>
<para
> Da &noatun; mindestens eine Benutzeroberfläche und eine Stückliste zur Funktion benötigt, müssen Sie zunächst eine neue Benutzeroberfläche oder eine neue Stückliste laden, bevor Sie die alte löschen können. Eine neue Stückliste ersetzt dabei automatisch die alte. </para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Woher bekomme ich weitere Plugins?</para>
</question>
<answer>
<para
> Entwickler können ihre eigenen Plugins an die <ulink url="http://noatun.kde.org/plugins.phtml"
>&noatun;-Webseite</ulink
> senden. Diese können dann dort von Benutzern wie Ihnen heruntergeladen werden. </para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Wie schreibe ich ein Plugin für &noatun;?</para>
</question>
<answer>
<para
> Dokumentation, eine <acronym
>API</acronym
>-Referenz und Beispielquelltexte sind auf der <ulink url="http://noatun.kde.org"
>&noatun;-Webseite</ulink
> zu finden. Außerdem sind dort (entsprechend dem Geist von "Open Source"-Programmen) die Quelltexte für &noatun; und die Standard-Plugins zu finden. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits-and-licenses">
<title
>Mitwirkende und Lizenz</title>

<para
>Copyright für das Programm 2000-2002 Charles Samuels <email
>charles@kde.org</email
></para>

<para
>Copyright für die Dokumentation 2002 Charles Samuels <email
>charles@kde.org</email
></para>

<para
>&noatun; wurde von den folgenden Personen programmiert:</para>

<itemizedlist
> <listitem
> <para
>Charles Samuels <email
>charles@kde.org</email
></para
> </listitem
> <listitem
> <para
>Neil Stevens <email
>multivac@fcmail.com</email
></para
> </listitem
> <listitem
> <para
>Stefan Westerfeld <email
>stefan@space.twc.de</email
></para
> </listitem
> <listitem
> <para
>Martin Vogt <email
>mvogt@rhrk.uni-kl.de</email
></para
> </listitem
> <listitem
> <para
>Malte Starostik <email
>malte.starostik@t-online.de</email
></para
> </listitem
> <listitem
> <para
>Nikolas Zimmermann <email
>wildfox@kde.org</email
></para
> </listitem
> <listitem
> <para
>Stefan Schimanski <email
>1Stein@gmx.de</email
></para
> </listitem
> </itemizedlist>
<para
>Deutsche Übersetzung: Frank Schütte <email
>F.Schuette@t-online.de</email
></para>

&underFDL;
&underBSDLicense;

</chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="how-to-obtain-Noatun">
<title
>Wie Sie &noatun; erhalten</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title
>Voraussetzungen</title>

<para
>Für &noatun; benötigen Sie mindestens einen Rechner mit einem Pentium Prozessor mit 200 MHz mit &Linux;, einen PowerPC mit &Linux; 2.4.1 oder neuer, oder eines von verschiedenen anderen Systemen. Zusätzliche Systeme werden in späteren Versionen unterstützt.</para>

<para
>&arts; kann leicht auf alle Platformen portiert werden, die pthread-Unterstützung und das <acronym
>OSS</acronym
> Klangausgabesystem verwenden; unter &Linux; wird auch das <acronym
>ALSA</acronym
>-System unterstützt.</para>

</sect1>

<sect1 id="compilation-and-installation">
<title
>Kompilierung und Installation</title>

&install.compile.documentation;

<para
>Falls Probleme auftreten, wenden Sie sich bitte an den Autor <email
>charles@kde.org</email
>.</para>

<para
>Wenn Sie diese Dokumentation lesen, haben Sie &noatun; vermutlich bereits kompiliert.</para>

</sect1>

</appendix>

<glossary id="glossary">
<title
>Glossar</title>

<glossentry id="gloss-mc"
> <glossterm
>Vollmilchschokolade (Milk Chocolate)</glossterm
><glossdef
> <para
> Vollmilchschokolade ist eine einfache, minimalistische Benutzeroberfläche </para
></glossdef
></glossentry>

<glossentry id="gloss-arts"
> <glossterm
>&arts;</glossterm
><glossdef
> <para
> &arts; ist der analoge Echtzeit-Synthesizer. Es handelt sich um ein mächtiges Medienprogramm, das von &noatun; verwendet wird. </para
></glossdef
></glossentry>
<glossentry id="gloss-kj"
> <glossterm
>K-Jöfol</glossterm
><glossdef
> <para
> Dieses Plugin kann Oberflächen laden, die ursprünglich für den &Windows;-Medienspieler gleichen namens entwickelt wurden. </para
></glossdef
></glossentry>

<glossentry id="gloss-keyz"
> <glossterm
>Keyz</glossterm
><glossdef
> <para
> Mit Keyz kann man innerhalb von &noatun; Tastaturkurzbefehlen Aktionen zuordnen. </para
></glossdef
></glossentry>
<glossentry id="gloss-young-hickory"
> <glossterm
>Young Hickory</glossterm
><glossdef
> <para
> Young Hickory ist ein Plugin für das Systemtablett. </para
></glossdef
></glossentry>
<glossentry id="gloss-kaiman"
> <glossterm
>Noatun</glossterm
><glossdef
> <para
> Kaiman ist ein Plugin, das Oberflächen des Medienspielers GQMPEG laden kann. Kaiman ist auch der Vorgänger von &noatun; und wurde in der &kde;-Version 2.0 zusammen mit &kde; ausgeliefert. Seit &noatun; in &kde; 2.1 eingeführt wurde, wurde der Oberflächenlader von Kaiman ein &noatun;-Plugin. </para
></glossdef
></glossentry>

</glossary>

&documentation.index;
</book>

