<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY myapp "<application>SimpleAudioPlayer</application>">
  <!ENTITY kappname "&myapp;">
  <!ENTITY package "kde-module">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title>The &myapp; Handbook</title>

<authorgroup>
<author>
<firstname>Reinhard</firstname><surname>Tchorz</surname>
<affiliation><address><email>tchorz@t-online.de</email></address></affiliation>
</author>
</authorgroup>

<copyright>
<year>2010</year>
<holder>Reinhard Tchorz</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2010-09-27</date>
<releaseinfo>1.0</releaseinfo>

<abstract>
<para>&myapp; is a simple audio player. His main task is quick playing some music files.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>audio</keyword>
<keyword>player</keyword>
</keywordset>

</bookinfo>

<chapter id="using-splayer"><title>Using &myapp;</title>

<sect1 id="starting"><title>Starting &myapp;</title>
<para>Type <userinput><command>simpleaudioplayer</command></userinput> at a command prompt or select
<guimenuitem>&myapp;</guimenuitem> from the <guisubmenu>Multimedia</guisubmenu> group in the <guimenu>K</guimenu>
menu. The standard &Qt; and &kde; command options are available, and can be listed by entering
<userinput><command>simpleaudioplayer</command><option> --help</option></userinput> at the command prompt.</para>
<para>
Of course you can use &krunner; to.
Or select one or more music files in &dolphin; and choise <command>open with...</command>.
</para>
</sect1>

<sect1 id="task"><title>Choose the media sources</title>

<sect2><title>Files</title>
<simplelist>
<member><emphasis>Drag and drop:</emphasis>
Select one or more files and/or folders in &dolphin; and drop these in the window of &myapp;. New added file are select and the first file will be played.
</member>
<member><emphasis>File commands:</emphasis>
Select <guimenu>File / Open</guimenu> and select one or more files. <guimenu>Open directory..</guimenu> adds all media files in this directory and in
his subdirectories. New files are added in the playlist and marked. The first new file will be played.
</member>
</simplelist></sect2>

<sect2><title>Web radios</title>
<para>Choise <guimenu>File / Add Radiostation...</guimenu> to add a Internet radio station. In the dialogbox type the stream address of the radio stream. You can
find a lot of them at <ulink url="http://www.shoutcast.com/">http://www.shoutcast.com/</ulink> or <ulink url="http://dir.xiph.org/">http://dir.xiph.org/</ulink>.</para>
</sect2>

<sect2><title>Audio cds</title>
<para>Start &myapp; and insert a cd in a cd drive. The first track of the cd will be played automatically.
Or insert a cd and choise <guimenu>Play Audio CD with &myapp;</guimenu> in the device notifier menu.
</para></sect2>

</sect1>

<sect1 id="playlist"><title>Working with the playlist</title>
<para>&myapp; automatically saves the current playlist and restores it at next program startup. </para>

<sect2><title>Play a single song</title>
<para>Simple click on the entry in the playlist.</para></sect2>

<sect2><title>Play a number of songs</title>
<para>Press the control key and click on a entry in the playlist. The shift key will expand the selection.
Or move the mouse around the entries. Short: the same procedure as in &dolphin;.
</para></sect2>

<sect2><title>Save and load playlists</title>
<para><guimenu>Playlist/Save</guimenu> saves the current playlist. <guimenu>Playlist/Open</guimenu> open a
playlist. You can quick open a playlist with <guimenu>File/Open Recent</guimenu>.</para>
<tip><para>You can open a playlist by clicking on a filename.sapl in &dolphin;.</para></tip>
</sect2>

</sect1>

<sect1 id="record"><title>Record internet radio</title>
<para>&myapp; allows you to save the streaming data from internet radios to disk. There are some differnent types of radios.
Some classical FM radio stations streaming their programs as a livestream. This is a continuous data stream. The stream of
a web radio can be split in several streams - song by song.</para>
<para>Software requirements: the programs streamripper and/or mplayer must be installed. Mplayer ist only needed for
Wav-files.</para>

<sect2><title>Playback</title>
<para>After a while &myapp; begins playback the recording stream. This saves some traffic because only one connection to
the radion station is needed.</para></sect2>

</sect1>

<sect1 id="equalizer"><title>The equalizer</title>
<para>As the name lets already assume, the sound can be affected with the sound controller.
  This is particularly useful with loudspeakers without own sound controllers.</para>
<warning><para>For the equalizer the Xine phonon-backend must be used.</para></warning>

<sect2><title>Select a sound scheme.</title>
<para>Select in the selection list the desired pattern.
Please make sure that the radio button <guimenu>Enabled</guimenu> is marked at the right side of the window.
To test the selection, press the <guimenu>Apply</guimenu> button. Only when you press the <guimenu>Ok</guimenu> button,
the selection is accepted.
</para></sect2>

<sect2><title>Deselect a sound scheme</title>
<para>Uncheck the radio button <guimenu>Enabled</guimenu> and press the <guimenu>Ok</guimenu> button.
</para></sect2>

<sect2><title>Edit a sound scheme.</title>
<para>Simply adjusting the slider to change the sound scheme. By the selection list
change the name or enter a new name to change the name of the scheme.
</para></sect2>

<sect2><title>Create a new sound scheme.</title>
<para>When creating a new scheme, the currently selected scheme will be copied.
Be sure to select first the desired scheme, and then press the button <guimenu>New</guimenu>.
The created schema you can then edit at will.
</para></sect2>

</sect1>

</chapter>

<chapter id="credits"><title>Credits and License</title>
<para>&myapp;</para>
<para>Program Copyright &copy; 2010 Reinhard Tchorz</para>
<para>Documentation Copyright &copy; 2010 Reinhard Tchorz</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;

</chapter>

</book>
