<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>
<book id="amarok" lang="&language;">
<bookinfo>
<title>The Amarok Handbook</title>
<authorgroup>
<author>
<personname>
      <firstname>This documentation was converted from the KDE UserBase <ulink url=" http://userbase.kde.org/Amarok/Manual">Amarok/Manual</ulink> page.</firstname>
<surname></surname>
</personname>
      </author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
      </authorgroup>
<legalnotice>&FDLNotice;</legalnotice>
<date>2018-05-21</date>
      <releaseinfo>2.9.0</releaseinfo>
<abstract>
<para>&amarok; is a free, versatile and powerful music player for &Linux;. The latest 2.x release series, often referred to as <quote>Amarok&nbsp;2</quote>, is cross-platform (can be used on many platforms, including &Linux;, &MacOS; and &Microsoft; &Windows;) and implements a completely reworked code base that will enable it to incorporate exciting new features as the release matures. The current stable release is version 2.4.</para>
      </abstract>
<keywordset>
 <keyword>KDE</keyword>
 <keyword>multimedia</keyword>
 <keyword>player</keyword>
 <keyword>audio</keyword>
 <keyword>ogg</keyword>
 <keyword>mp3</keyword>
 <keyword>wav</keyword>
 <keyword>music</keyword>
 <keyword>sound</keyword>
</keywordset>
</bookinfo>
<!--userbase <timestamp>2018-05-21T14:49:54Z</timestamp>-->

<!--userbase-content-->
<chapter id="amarok--rediscover-your-music"><title>Amarok: Rediscover your music!</title> 
<para>
<informaltable>
  <tgroup cols="1">
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Amarok 2.8 default layout</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>&amarok; is the premier Free, Open Source Music application. More than simply a music player, &amarok; helps you rediscover your music. The innovative interface gives you unprecedented control over your collection, and extends your reach to music everywhere. Use our <link linkend="quick-start-guide">Quick Start Guide</link> to get going quickly, or search out more in-depth information in this handbook.
</para>
</chapter>
<chapter id="quick-start-guide"><title>Quick Start Guide</title> 
<para>Congratulations on installing &amarok;, the most advanced music discovery software available. &amarok; will help you explore your music, and enjoy it as never before. Also, you can tour different sources of music, radio stations and audio books online. In this guide, we'll show you how to let &amarok; find your collection, play it for you, and also how to use &amarok; to find things online. We'll assume that you know nothing about &amarok;, but do know how to use menus, a mouse, and your keyboard.
</para>
<orderedlist>
<listitem><para><link linkend="getting-started">Getting started</link>&nbsp;<orderedlist>
<listitem><para><link linkend="starting-amarok">Starting Amarok</link>&nbsp;</para></listitem>
<listitem><para><link linkend="closing-amarok">Closing Amarok</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="the-amarok-window">The Amarok window</link>&nbsp;<orderedlist>
<listitem><para><link linkend="default-layout-of-the-amarok-window">Default layout of the Amarok window</link>&nbsp;</para></listitem>
<listitem><para><link linkend="using-the-amarok-window-to-manage-and-play-your-music">Using the Amarok window to manage and play your music</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="the-music-collection">The Music Collection</link>&nbsp;<orderedlist>
<listitem><para><link linkend="the-media-sources-pane">The Media Sources Pane</link>&nbsp;</para></listitem>
<listitem><para><link linkend="setting-up-a-collection">Setting up a collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="adding-media-devices-to-the-collection">Adding Media Devices to the Collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="ripping-a-cd-into-the-collection">Ripping a CD into the collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="accessing-other-media-sources">Accessing other media sources</link>&nbsp;</para></listitem>
<listitem><para><link linkend="streams-and-podcasts">Streams and Podcasts</link>&nbsp;</para></listitem>
<listitem><para><link linkend="using-the-content-browser">Using the Content Browser</link>&nbsp;
<orderedlist>
<listitem><para><link linkend="hiding-or-expanding-information">Hiding or expanding information</link>&nbsp;</para></listitem>
<listitem><para><link linkend="changing-the-order-of-tracks-and-albums">Changing the order of tracks and albums</link>&nbsp;</para></listitem>
<listitem><para><link linkend="deleting-items-from-the-collection">Deleting items from the collection</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="playlists">Playlists</link>&nbsp;<orderedlist>
<listitem><para><link linkend="the-playlist-pane">The Playlist pane</link>&nbsp;</para></listitem>
<listitem><para><link linkend="adding-music-to-a-playlist">Adding music to a playlist</link>&nbsp;</para></listitem>
<listitem><para><link linkend="using-the-toolbar">Using the Toolbar</link>&nbsp;</para></listitem>
<listitem><para><link linkend="manipulating-playlists">Manipulating playlists</link>&nbsp;
<orderedlist>
<listitem><para><link linkend="removing-a-track">Removing a track</link>&nbsp;</para></listitem>
<listitem><para><link linkend="using-the-playlist-tools-at-the-bottom">Using the Playlist tools at the bottom</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="saving-and-retrieving-your-favorite-playlists">Saving and retrieving your favorite playlists</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="the-context-view">The Context View</link>&nbsp;<orderedlist>
<listitem><para><link linkend="default-layout">Default layout</link>&nbsp;</para></listitem>
<listitem><para><link linkend="customizing-the-context-pane">Customizing the Context pane</link>&nbsp;</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para><link linkend="how-to-deal-with-problems">How to deal with problems</link>&nbsp;</para></listitem>
<listitem><para><link linkend="glossary">Glossary</link>&nbsp;</para></listitem>
</orderedlist>
<sect1 id="getting-started"><title>Getting started</title> 
<sect2 id="starting-amarok"><title>Starting Amarok</title> 
<para>If you already know your way around your operating system, you probably also know how to start &amarok;, and you can <link linkend="first-time">continue</link>. Else, continue reading.
</para>
<sect3 id="from-plasma"><title>From Plasma</title> 
<para>If you are running the <ulink url="http://userbase.kde.org/Special:mylanguage/Plasma">Plasma Workspace</ulink>, you can start &amarok; by either:
</para>
<itemizedlist>
<listitem><para>pressing on <ulink url="http://userbase.kde.org/Special:mylanguage/Kickoff">Kickoff</ulink> and then <menuchoice><guimenu>Multimedia</guimenu><guimenuitem>Amarok</guimenuitem></menuchoice>.</para></listitem>
<listitem><para>invoking <ulink url="http://userbase.kde.org/Special:mylanguage/KRunner">KRunner</ulink> (<keycombo>&Alt;<keycap>F2</keycap></keycombo> by default), entering <varname>amarok</varname> and then pressing &Enter;.</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="from-the-file-manager"><title>From the file manager</title> 
<para>Open a multimedia file that &amarok; is known to play.
</para>
</sect3>
</sect2>
<sect2 id="first-time"><title>First Time</title> 
<para>The first time you use &amarok;, a dialog box will come up asking you to specify your locale:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_locale_selection.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Next, a First Start dialog box will come up asking you to specify where your music is located.  If you have a music directory already <ulink url="help:/kcontrol/paths">configured in your system</ulink>, &amarok; should detect it and ask you to use it:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="firstruncollection2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If you select <guilabel>No</guilabel> in this dialog, you will be presented with another one which allows you to select your music folder:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialoglocalcollection.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>See <link linkend="setting-up-a-collection">Setting Up a Collection</link>
</para>
<para>Once you have selected the folder where your music is, &amarok; will scan the folder and sub-folders, creating the collection. This can take some time, depending on the number of tracks and the speed of the location.
</para>
</sect2>
<sect2 id="closing-amarok"><title>Closing Amarok</title> 
<para>If you want to close &amarok;:
</para>
<itemizedlist>
<listitem><para>Type <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> when you are in the &amarok; window, or</para></listitem>
<listitem><para>Select the <guilabel>Quit</guilabel> option in the &amarok; menu, or</para></listitem>
<listitem><para>Right-click on the blue wolf icon in the <guilabel>System Tray</guilabel> at the bottom of your screen. You will be presented with the following:</para></listitem>
</itemizedlist>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_systray_window.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If you close the &amarok; window by clicking <guilabel>Close</guilabel> on the window border, &amarok; will continue to run in the background and only show the blue wolf icon in the <guilabel>System Tray</guilabel>:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_systray_2-8_4-11.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If you log out of your session or shut down your computer without quitting &amarok;, some of your settings will not be saved.
</para>
</sect2>
</sect1>
<sect1 id="the-amarok-window"><title>The Amarok window</title> 
<para>The &amarok; window is designed to let you rediscover your music. So, it gives you as much information about your music as possible. While many users will enjoy the default layout, it is fully customizable.
</para>
<sect2 id="default-layout-of-the-amarok-window"><title>Default layout of the Amarok window</title> 
<para>Upon installation, &amarok; will look like this:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amaroknew2-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Amarok 2.8, newly installed</phrase>
    </textobject>
    <caption>
      <para>Amarok 2.8, newly installed</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The &amarok; window has four main parts:
</para>
<orderedlist>
<listitem><para>under the top-level menus is the <emphasis>Toolbar</emphasis> which lies above three panes:</para></listitem>
<listitem><para>your <guilabel>Media Sources</guilabel> (music collection and other media) in the left pane,</para></listitem>
<listitem><para>the <guilabel>Context</guilabel> pane in the center, and</para></listitem>
<listitem><para>the <guilabel>Playlist</guilabel> in the right-hand pane.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="using-the-amarok-window-to-manage-and-play-your-music"><title>Using the Amarok window to manage and play your music</title> 
<para>Playing music using &amarok; usually takes two steps:
</para>
<orderedlist>
<listitem><para>Create a playlist by selecting some of the tracks in your collection, which you will find listed in the <guilabel>Media Sources</guilabel> pane, and send your music to the <guilabel>Playlist</guilabel> pane.</para></listitem>
<listitem><para>Play the music in your playlist, using the <guilabel>Playlist</guilabel> pane and/or the Toolbar.</para></listitem>
</orderedlist>
<para>Also, you may want to transfer some of your music to a mobile music player, such as an iPod. The next sections will explain how.
</para>
</sect2>
</sect1>
<sect1 id="the-music-collection"><title>The Music Collection</title> 
<sect2 id="the-media-sources-pane"><title>The Media Sources pane</title> 
<para>The <guilabel>Media Sources</guilabel> pane is the place where you browse and display your complete collection of music. This includes the tracks on your local hard disk, as well as those on any external devices or media connected to your computer, such as audio CD, USB devices, media players, network disks or Internet sources.
</para>
</sect2>
<sect2 id="setting-up-a-collection"><title>Setting up a collection</title> 
<para>Do you have music tracks in <emphasis>mp3</emphasis>, <emphasis>Ogg</emphasis> or <emphasis>FLAC</emphasis> format on your computer?  Begin by telling &amarok; where to find those files, so it can create your collection. In the top-level menu: <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Local Collection</guimenuitem></menuchoice>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialoglocalcollection.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Configure Collection Dialog, as of version 2.8</phrase>
    </textobject>
    <caption>
      <para>Configure Collection Dialog, as of version 2.8</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>A tree-view of your home directory is shown above.  Click the check box where your music is stored; usually <menuchoice><guimenu>home</guimenu><guimenuitem>Music</guimenuitem></menuchoice>.  Then choose <guilabel>Fully Rescan Entire Collection</guilabel>.  This will take some time, so do not be alarmed if &amarok; seems slow for a while. Once the scan is complete, it is best to quit &amarok; using the top-level &amarok; menu, or <keycombo>&Ctrl;<keycap>Q</keycap></keycombo>, and then restart it. Your newly-added music should show up under the <guilabel>Local Collection</guilabel> section.
</para>
<para>More about configuring your collection <link linkend="collection">here</link>.
</para>
<para><tip><para>The set of multimedia formats recognized by &amarok; is not restricted to those mentioned above; is controlled by the <ulink url="http://userbase.kde.org/Special:Mylanguage/Phonon">Phonon</ulink> back end.</para></tip>
</para>
</sect2>
<sect2 id="adding-media-devices-to-the-collection"><title>Adding Media Devices to the Collection</title> 
<para>Underneath the search bar near the top of the <guilabel>Media Sources</guilabel> pane you see the different devices and/or content categories within the <guilabel>Content Browser</guilabel>. If you insert an Audio CD in the CD drive it will appear in the <guilabel>Media Sources</guilabel> pane, along with media players, thumb drives, and other USB devices. After an external device has been mounted, it will show automatically within the <guilabel>Media Sources</guilabel> pane.
</para>
<para>Below is a screenshot showing three connected sources with music: Audio CD, mp3 player, and the <guilabel>Local Collection</guilabel>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="ripping-a-cd-into-the-collection"><title>Ripping a CD into the collection</title> 
<para>If you don't have any music files on your computer, it's easy to <emphasis>rip</emphasis> them (copy the tracks from your CDs to your collection). Just pop in a CD, and right-click on the banner of the CD device in the <guilabel>Content Browser</guilabel> to play, or copy to your collection, which will rip and <emphasis>tag</emphasis> your tracks (see image below). If you copy music from an audio CD to your <guilabel>Local Collection</guilabel>, the <emphasis>message bar</emphasis> at the bottom of the &amarok; window will indicate that it is busy copying. The ripping may take several minutes. Once the rip is complete, the message in the message bar disappears and the music appears in the content browser of your <guilabel>Local Collection</guilabel>. If the ripped music does not appear in your <guilabel>Media Sources</guilabel> pane it's best to quit &amarok; from the &amarok; top-level menu, or <keycombo>&Ctrl;<keycap>Q</keycap></keycombo>, and then restart it. Now you should see it in your collection. The screenshot below shows how you move tracks from your audio CD, iPod or other device to your collection, using the context (right-click) menu.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokripcd.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>In the above context menu, you can also see the choice to <guilabel>Edit Track Details</guilabel>. Use this option if you have a track that needs a tag edited. This becomes important when you rip music to .WAV format, losing some of the tags. If quite a bit of your collection needs tagging, consider dedicated tagging software, such as
</para>
<itemizedlist>
<listitem><para><ulink url="http://musicbrainz.org/doc/PicardTagger">Picard</ulink></para></listitem>
<listitem><para><ulink url="http://easytag.sourceforge.net">EasyTag</ulink></para></listitem>
<listitem><para><ulink url="http://kid3.sourceforge.net">Kid3</ulink></para></listitem>
</itemizedlist>
<para>Correct tagging is important to help &amarok; show your tracks in the appropriate albums and proper sort order. Learn more about <link linkend="tags">ripping and tagging</link>.
</para>
</sect2>
<sect2 id="accessing-other-media-sources"><title>Accessing other media sources</title> 
<para>You might have wondered why the <guilabel>Media Sources</guilabel> pane is not called the 'Collections' pane. &amarok; gives you access to much more music than just your collection -- Internet shops, audio books, podcasts, music files stored outside your collection, and previously stored playlists. The &amarok; <emphasis>breadcrumb navigation</emphasis> is the key to all of this. The starting icon for the breadcrumb navigation is the home folder icon at the extreme top left of the <guilabel>Media Sources</guilabel> pane. This icon expands and contracts as you browse through the <guilabel>Media Sources</guilabel> pane, allowing you to easily navigate your collection by clicking your desired folder in the breadcrumb bar.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokbreadcrumb.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If you click the &amarok; home folder you see the <guilabel>Media Sources</guilabel> pane on the left below, containing icons to available resources. If you click <guilabel>Files</guilabel> (left image below, second item from the bottom), you will see something similar to the image on the right, below. Notice how the breadcrumb bar expands and how the content of the selected folder is shown in the <guilabel>Media Sources</guilabel> pane (right image below). Clicking the <guilabel>&gt;</guilabel> symbols among the breadcrumbs allows you to view the folders available at that level of the folder structure. The &amarok; file browser gives you access to your entire file system, even outside your <guilabel>Local Collection</guilabel>.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Media Sources pane</entry>
    <entry>Files icon clicked</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokmediasources-home.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokmediasources-files.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>The functions of the icons in the &amarok; Home folder (left above) are:
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <thead>
  <row>
    <entry>Icon</entry>
    <entry>Name</entry>
    <entry>Action</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="action-collection-amarok48.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><guilabel>Local Music</guilabel></para>
    </entry>
    <entry>
    <para>Your &amarok; collection</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="applications-internet.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><guilabel>Internet</guilabel></para>
    </entry>
    <entry>
    <para>Internet shops such as <emphasis>Magnatune</emphasis>, <emphasis>Jamendo</emphasis> and <emphasis>Last.fm</emphasis>. First configure your internet resources in: <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Internet Services</guimenuitem></menuchoice></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="view-media-playlist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><guilabel>Playlists</guilabel></para>
    </entry>
    <entry>
    <para>Saved playlists -- see also <link linkend="playlists">Playlists</link>. Also playlists on media devices</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="folder-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><guilabel>Files</guilabel></para>
    </entry>
    <entry>
    <para>Your file system</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-podcast-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><guilabel>Podcasts</guilabel></para>
    </entry>
    <entry>
    <para>Access to Podcasts via RSS feed</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>Clicking <guilabel>Local Music</guilabel> in the root of <guilabel>Media Sources</guilabel> (image above) or in the breadcrumb bar returns you to your collection, showing you a list of all the available resources, artists, albums and tracks that you have previously defined as part of your collection. The breadcrumb bar indicates that you are viewing <guilabel>Local Music</guilabel>.
</para>
</sect2>
<sect2 id="streams-and-podcasts"><title>Streams and Podcasts</title> 
<para>There are two ways to listen to streams.
</para>
<itemizedlist>
<listitem><para>If you have a favorite station, get the stream URL and add it: <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Add Stream</guimenuitem></menuchoice>. If you then save your playlist, later you can find it again in <guilabel>Playlists</guilabel>, as a <emphasis>Saved Playlist</emphasis>.</para></listitem>
<listitem><para>Browse through the scripts available in our <guilabel>Script Manager</guilabel>, <menuchoice><guimenu>Tools</guimenu><guimenuitem>Script Manager</guimenuitem></menuchoice> up to Amarok 2.4.0, after 2.4.1 <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Scripts</guimenuitem></menuchoice>. There are some excellent collections available, which will show up in the <guilabel>Internet</guilabel> section of your <guilabel>Media</guilabel> pane.</para></listitem>
</itemizedlist>
<para>Podcasts have their own section in the <guilabel>Media</guilabel> pane, above. If you have an RSS or Atom feed URL, click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-list-add.png" format="PNG"/> </imageobject> </inlinemediaobject> and add it there. If you have an OPML file to import, that choice is available also. Use the context (right-click) menus to <guilabel>Add to playlist</guilabel>, <guilabel>Configure</guilabel>, <guilabel>Remove Subscription</guilabel>, <guilabel>Update Channel</guilabel>, or mark an episode as <guilabel>New</guilabel>. If you are interested in browsing through a large collection of podcasts, check out the <guilabel>Podcast Directory</guilabel> available through the <guilabel>Script Manager</guilabel>, referred to above.
</para>
<para>More about configuring <guilabel>Amaroks</guilabel> <guilabel>Internet Services</guilabel> <link linkend="internet-services">here</link>.
</para>
</sect2>
<sect2 id="using-the-content-browser"><title>Using the Content Browser</title> 
<para>The hard disk of your computer, audio CDs, external devices and the Internet are the basic resources for your collection. After your collection has been set up, it is likely that your collection will hold a large number of albums and tracks, much more than can be shown on a single window.
</para>
<para>How to change the display of your collection, below:
</para>
<sect3 id="hiding-or-expanding-information"><title>Hiding or expanding information</title> 
<para>The area of the <guilabel>Media Sources</guilabel> pane below the search bar is called the <guilabel>Content Browser</guilabel>. Three media sources are indicated in the image of a <guilabel>Content Browser</guilabel> below: CD, Local Collection and a Media Player:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="cd_collection_sansa.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Clicking the banner for a device (the blue bar for the Sansa above) shows or hides the content of that device. The direction of the arrow on the right indicates whether the contents for that device is hidden or shown. The content on a particular device can, in turn, be hidden or shown using the same principle, clicking on the appropriate artist or album. An arrow pointing down on the left of an artist or an album indicates that the contents has been expanded. An arrow pointing right indicates that more content for that category is available but currently hidden. In the image above, the information for <emphasis>Mike Oldfield - The Songs of Distant Earth</emphasis> CD has been expanded, showing the individual tracks. On the other hand, the albums and tracks in the <guilabel>Local Collection</guilabel> are hidden. By clicking these arrows you also can expand or hide information.
</para>
</sect3>
<sect3 id="changing-the-order-of-tracks-and-albums"><title>Changing the order of tracks and albums</title> 
<para>The order in which tracks are sorted in the <guilabel>Content Browser</guilabel> can be customised by using the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-preferences-other.png" format="PNG"/> </imageobject> </inlinemediaobject> button at the top of the <guilabel>Media Sources</guilabel> pane:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_collectionsortingmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Collection sort options for version 2.8</phrase>
    </textobject>
    <caption>
      <para>The Collection sort options for version 2.8</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The sort order is indicated on the top left of the <guilabel>Media Sources</guilabel> pane, just below the <guilabel>Search</guilabel> text box. The default order is <guilabel>Artist / Year - Album</guilabel>. The display order of the <guilabel>Content Browser</guilabel> can be temporarily switched between the user-defined sort order (described above) and a <emphasis>Merged view</emphasis> in which artists are listed alphabetically, no matter on which media the music is stored. To toggle the <emphasis>Merged view</emphasis>, click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-view-list-tree.png" format="PNG"/> </imageobject> </inlinemediaobject> icon at the top right-hand of the <guilabel>Media Sources</guilabel> pane:
</para>
<para>To search your collection, type your search term into the <guilabel>Search bar</guilabel> at the top of the <guilabel>Local Music</guilabel> section. Not only can you search by artist, album or track name, but any part. You might create a nice playlist by searching for <replaceable>winter</replaceable>, for instance, or merely find a track when you only remember one word of the title. You can also search by rating, playcount, even filetype. See <link linkend="search-in-collection">Search in Collection</link> for more details.
</para>
</sect3>
<sect3 id="deleting-items-from-the-collection"><title>Deleting items from the collection</title> 
<para>You can delete any item from your collection by right-clicking on it and choosing the bottom item <guilabel>Move Tracks to Trash</guilabel>. A confirmation dialog will appear, preventing the accidental deletion of any tracks. More than one item can be selected with <keycombo>&Ctrl;<keycap>click</keycap></keycombo>.
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="playlists"><title>Playlists</title> 
<sect2 id="the-playlist-pane"><title>The Playlist pane</title> 
<para>Now that &amarok; has scanned your collection of music, you want to listen to it. So use the <guilabel>Playlist</guilabel> pane to create a playlist containing the selection of tracks you want. This is where you play your music, streams, or podcasts.
</para>
<para>You can sort your playlist by title, album, artist, genre and many others. For instance you can sort your tracks by year first, then by artist and so on.
</para>
<para>The search box lets you search or filter your tracks. The <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-up.png" format="PNG"/> </imageobject> </inlinemediaobject> and <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-down.png" format="PNG"/> </imageobject> </inlinemediaobject> icons near the top of the <guilabel>Playlist</guilabel> pane lets you skip to the next or previous track containing the letters you have chosen. The <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> button lets you filter your tracks by artist, album, &etc;
</para>
<para>The layout of the <guilabel>Playlist</guilabel> can be changed through the top-level menu: <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Playlist Layouts</guimenuitem></menuchoice>.
</para>
</sect2>
<sect2 id="adding-music-to-a-playlist"><title>Adding music to a playlist</title> 
<para>There are five ways to add music to the playlist.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_popupdropperadd.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Pop-up Dropper when adding a single track</phrase>
    </textobject>
    <caption>
      <para>Pop-up Dropper when adding a single track</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<orderedlist>
<listitem><para>Choose some of your music in the content browser and drag it to the right. If you drag it over the <guilabel>Context</guilabel> pane you will see the <emphasis>Pop-Up Dropper</emphasis>, also known as <emphasis>PUD</emphasis>. The image above shows PUD in action. PUD provides three options: <guilabel>Add to Playlist</guilabel>, <guilabel>Replace Playlist</guilabel>, and <guilabel>More...</guilabel>. The option highlighted in the gray area (<guilabel>Add to Playlist</guilabel> in this image) is the active one. Dropping the album there adds it to the playlist in the <guilabel>Playlist</guilabel> pane.  Choose one of the other options to do something else with your selection.  Dragging it over <guilabel>More...</guilabel> brings up a new menu of choices in <emphasis>PUD</emphasis>.</para></listitem>
<listitem><para>Drag your selection all the way onto the <guilabel>Playlist</guilabel> pane on the right-hand side of the &amarok; screen.</para></listitem>
<listitem><para><keycap>Double-click</keycap> the album/track to append to the playlist, doesn't start to play.</para></listitem>
<listitem><para><keycap>Middle-click</keycap> the album/track to append it to the playlist and play immediately.</para></listitem>
<listitem><para><keycap>Right-click</keycap> the album or track.  In your right-click menu, you will find similar choices. The image below shows the context menu that appears after an item has been right-clicked. Select <guilabel>Add to Playlist</guilabel>.</para></listitem>
</orderedlist>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_addtoplaylist1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="using-the-toolbar"><title>Using the Toolbar</title> 
<para>The <guilabel>Toolbar</guilabel> at the top of the &amarok; screen provides a simple interface to control the playing of music in the <guilabel>Playlist</guilabel>.
</para>
<para>Click the round icon on the left to start your music playing, and click it again to pause. On the right is the volume and mute control; click on the center of the icon to mute. Use your mouse scroll wheel to control the volume, or drag/click your mouse on the outside ring of the volume icon.
</para>
<para>Once a track or stream begins to play, the <emphasis>Artist / Album / Track title</emphasis> slowly alternates in bold in the center. On the right is the next track, which you can click to start it playing immediately. Once a track has played it will be on the left, so you can click on the title to go back to it. The progress bar in the middle of the <guilabel>Toolbar</guilabel> indicates the time elapsed (left hand) and time remaining (right hand) for the track that is currently playing.
</para>
<para>If you'd rather see a more traditional toolbar, you can select <guilabel>Slim Toolbar</guilabel> from the <guilabel>View</guilabel> menu.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="controlamarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="manipulating-playlists"><title>Manipulating playlists</title> 
<para>You may want to delete albums or tracks from your playlist, rearrange the displayed items for each track or rearrange the display order of tracks.
</para>
<sect3 id="removing-a-track"><title>Removing a track</title> 
<para>You can remove any track or album from your playlist by:
</para>
<orderedlist>
<listitem><para><keycap>Right-click</keycap> on the item in the playlist and choose the option <guilabel>Remove from playlist</guilabel>.</para></listitem>
<listitem><para>Drag the item to be deleted over the <guilabel>Context</guilabel> pane to activate <emphasis>PUD</emphasis>. Several options will appear over the <guilabel>Context</guilabel> pane. Drag the item to the area marked <guilabel>Delete from playlist</guilabel>. See the image below that shows a track being dragged onto the <guilabel>Remove</guilabel> option in <emphasis>PUD</emphasis>.</para></listitem>
<listitem><para>Selecting the track or tracks and use your <keycap>Delete</keycap> key. Multiple tracks can be selected using &Shift; or &Ctrl;.</para></listitem>
</orderedlist>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_popupdropperremove.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Pop-up Dropper when removing a track</phrase>
    </textobject>
    <caption>
      <para>Pop-up Dropper when removing a track</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Undo your delete by pressing <keycombo>&Ctrl;<keycap>Z</keycap></keycombo> or by clicking the arrow in the <guilabel>Playlist Toolbar</guilabel> at the bottom of the <guilabel>Playlist</guilabel> pane (see below).
</para>
</sect3>
<sect3 id="using-the-playlist-tools-at-the-bottom"><title>Using the Playlist tools at the bottom</title> 
<para>At the bottom of the <guilabel>Playlist</guilabel> pane are seven icons:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <tbody>
  <row>
    <entry>
    <para>Icon</para>
    </entry>
    <entry>
    <para>Action</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-clear-playlist-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Clear playlist of all albums and tracks.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="document-save.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Save your playlist. If you do not rename, saves the date as a name.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="edit-undo.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Undo your last edit to playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="edit-redo.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Redo your last undo to playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-music-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Highlight the track currently playing. Useful for long playlists.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-media-standard-track-progression-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Set the play mode: repeat tracks, random order, prefer rarely played, &etc;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-edit-playlist-queue.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Edit the playlist queue; which are tracks played first before the playlist resumes.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>These buttons provide convenient alternatives to several keyboard actions.
</para>
</sect3>
</sect2>
<sect2 id="saving-and-retrieving-your-favorite-playlists"><title>Saving and retrieving your favorite playlists</title> 
<para>The disk icon, in the popup which can be called from the bottom of your <guilabel>Playlist</guilabel> pane, allows you to save the current &amarok; playlist. This enables you to recall a particular selection of music from your collection at any time. Playlists only contain pointers to the music you selected, not the music itself. So if your playlist is pointing to music on an external device, it must be connected and mounted, otherwise the music cannot be played.  There are three places to store playlists:
</para>
<orderedlist>
<listitem><para>outside &amarok; on your computer file system,</para></listitem>
<listitem><para>in your &amarok; playlist database</para></listitem>
<listitem><para>on an portable media device.</para></listitem>
</orderedlist>
<para>Clicking the disk icon at the bottom of the <guilabel>Playlist</guilabel> pane stores your playlist in the &amarok; playlist database. To save to disk, click and hold, then scroll to that choice.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_savecurrentplaylistoptions.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Current playlist saving options</phrase>
    </textobject>
    <caption>
      <para>Current playlist saving options</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>By default, your saved playlist has a name composed of the date and time when you saved it (see image below). Right-click the playlist name to rename it. Right-clicking on a playlist name also allows you to add it to your existing playlist in the <guilabel>Playlist</guilabel> pane, or to replace your existing playlist.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-7renamesavedplaylist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
<sect1 id="the-context-view"><title>The Context View</title> 
<para>The power of &amarok; is in the <emphasis>Context</emphasis> pane (in the center of the default &amarok; window), where you can install various <emphasis>applets</emphasis> to help you enjoy and explore your music. Most of this additional information is obtained from the Internet, so a connection is important to get the most out of your <emphasis>Context</emphasis> pane. By default, three <emphasis>applets</emphasis> are preset: <emphasis>Current Track</emphasis>, <emphasis>Lyrics</emphasis> and <emphasis>Wikipedia</emphasis>.
</para>
<sect2 id="default-layout"><title>Default layout</title> 
<para>The default <emphasis>Context</emphasis> pane shows the following items: CurrentTrack, Analyzer, Wikipedia and Lyrics. Depending on the screen size the Lyrics might not be visible, but clicking on the button at the bottom will make it visible. When nothing is playing, the CurrentTrack applet will show the last played tracks and information about the Local Collection
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_contextview_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The default view as of Amarok 2.8</phrase>
    </textobject>
    <caption>
      <para>The default view as of Amarok 2.8</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="customizing-the-context-pane"><title>Customizing the Context pane</title> 
<para>At the bottom of the <emphasis>Context</emphasis> pane are four buttons for the default applets. On the right of these buttons you see <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject>, clicking on it will show <inlinemediaobject> <imageobject> <imagedata fileref="Icon-application-exit.png" format="PNG"/> </imageobject> </inlinemediaobject> allowing you to remove these applets. Click the applets to add them to the pane. Drag the labeled buttons to re-order the applets you have, and click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> again to save your selections.
</para>
<para>This makes the <emphasis>Context</emphasis> pane extremely flexible, maximizing the possibility of a custom display that fits your preferences. More <link linkend="the-context-pane">here</link>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_appletexplorer_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
<sect1 id="how-to-deal-with-problems"><title>How to deal with problems</title> 
<sect2 id="some-of-the-music-is-being-rapidly-skipped-over"><title>Some of the music is being rapidly skipped over</title> 
<para>You may not have installed the necessary <emphasis>codecs.</emphasis> More about that here:
</para>
<para><link linkend="what-media-types-does-amarok-support">FAQ: What Media Types Does Amarok Support</link>.
</para>
<para>Please refer to your distribution.
</para>
</sect2>
<sect2 id="after-my-ipod-has-been-mounted-it-is-not-shown-in-the-content-browser"><title>After my iPod has been mounted, it is not shown in the Content Browser</title> 
<para>This should not happen. Check that the device has been properly mounted. Simply typing <userinput>mount</userinput> in a console will show you all mounted devices.
</para>
</sect2>
<sect2 id="after-i-have-updated-my-collection-the-additions-are-not-shown-in-the-content-browser"><title>After I have updated my collection, the additions are not shown in the Content Browser</title> 
<para>From the top-level menu <menuchoice><guimenu>Tools</guimenu><guimenuitem>Update Collection</guimenuitem></menuchoice>. If they don't show up, quit &amarok; from the &amarok; menu, or use <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> to quit. Once you restart &amarok;, your collection should show your updates.
</para>
</sect2>
<sect2 id="amarok-cannot-find-the-lyrics-of-the-songs-that-i-play"><title>Amarok cannot find the lyrics of the songs that I play</title> 
<para>Possibilities:
</para>
<orderedlist>
<listitem><para>The lyrics are not available in the sites checked on the Internet. You may wish to add more sites via the script menu.</para></listitem>
<listitem><para>The track numbering system within an album in your collection is not correct.</para></listitem>
<listitem><para>The title of your song contains special characters with a cedille, accent, &etc; that do not show in your track title; therefore the lyrics script applet cannot find a match for your title. Check your tags and track numbering system with a tagger such as <ulink url="http://musicbrainz.org/doc/MusicBrainz_Picard">Picard</ulink>.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="my-question-isnt-answered-here"><title>My question isn't answered here</title> 
<para>More complex issues are covered in this handbook, including <link linkend="troubleshooting-and-common-problems">Troubleshooting and Common Problems</link>, and the <link linkend="frequently-asked-questions">Amarok FAQ</link>.
</para>
</sect2>
</sect1>
<sect1 id="glossary"><title>Glossary</title> 
<sect2 id="breadcrumbs"><title>Breadcrumbs</title> 
<para>This is a way of navigating a hierarchical file structure; on &amarok; near the top of the Media Sources pane. Starting at the Home folder level, it shows how deep one has navigated into the file system. When you have gone to a particular place in the file system, you will see all folders at a higher level. In &amarok; the <guilabel>&gt;</guilabel> links between folder levels allow you to find out what alternative folders are available at a particular level. The breadcrumbs are an efficient mechanism to navigate the whole file system on your computer.
</para>
</sect2>
<sect2 id="collection"><title>Collection</title> 
<para>All the sound files that &amarok; has compiled in the database. Your collection may vary in size and composition of music tracks, depending which external devices (such as audio CDs or portable players with music) are connected and mounted on your computer.
</para>
</sect2>
<sect2 id="collection-browser"><title>Collection Browser</title> 
<para>This is in the <emphasis>Media Sources</emphasis> pane for your <quote>Local Music</quote> section and shows you the list of the music that you have in your collections. The Collection Browser allows you to search and sort your track lists by various id3 tags.
</para>
</sect2>
<sect2 id="playlist"><title>Playlist</title> 
<para>A selection of tracks from your collection that you wish to play. Some portable music players have predefined playlists that are likely to differ from your &amarok; playlists.
</para>
</sect2>
<sect2 id="script"><title>Script</title> 
<para>&amarok; plugin to extend functionality. Scripts are available from <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Scripts</guimenuitem></menuchoice>. Add more lyrics sources, more streaming stations, save covers to your album folders, burn CDs from playlists, &etc;
</para>
</sect2>
<sect2 id="scrobble"><title>Scrobble</title> 
<para>To scrobble a track means that as you listen to it, the title of the track and artist are sent to a Web site such as <emphasis>Last.fm</emphasis>, where the information is added to your profile.
</para>
</sect2>
<sect2 id="stream-streaming"><title>Stream, streaming</title> 
<para>Like 20th-century radio stations, Internet radio stations send out <quote>streams</quote> of content. One can find music, news, commentary and opinion. Many streams can be accessed through &amarok;, either through scripts such as <emphasis>Cool Streams</emphasis>, or individually added by menu, <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Add Stream</guimenuitem></menuchoice>.
</para>
</sect2>
<sect2 id="tags"><title>Tags</title> 
<para>The information about each of the tracks you listen to, &eg; album name, track title, composer, artist, year, &etc; There is a standard called ID3 for including this information on audio CDs. You can edit the tags of individual tracks within &amarok; if the file permissions are correct.
</para>
</sect2>
</sect1>
</chapter>
<chapter id="the-amarok-window0"><title>The Amarok Window</title> 
<para>When you open &amarok;, this is what you will see, once &amarok; has fully loaded:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_startwindowdefault.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Default startup window</phrase>
    </textobject>
    <caption>
      <para>Default startup window</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<sect1 id="window-layout"><title>Window Layout</title> 
<para>&amarok; is organized in four main areas, the toolbar and three panes:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-7thetoolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="main-toolbar">The Main Toolbar</link>&nbsp;</para>    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="slim_toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="slim-toolbar">The Slim Toolbar</link>&nbsp;</para>    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_mediasourcespanedefault.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="the-media-sources-pane">The Media Sources pane</link>&nbsp;</para>    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_contextview_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="the-context-pane">The Context pane</link>&nbsp;</para>    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistpane.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="the-playlist-pane">The Playlist pane</link>&nbsp;</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect1>
<sect1 id="toolbar"><title>Toolbar</title> 
<sect2 id="introduction"><title>Introduction</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6viewconfigmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The <emphasis>Toolbar</emphasis> is used to manage the currently playing song. You can switch between the main  and slim Toolbar using the <guilabel>View</guilabel> menu in the <emphasis>Menubar</emphasis>. The Menubar can optionally be hidden; use <keycombo>&Ctrl;<keycap>M</keycap></keycombo> to hide or re-display.
</para>
<para>The Toolbar can be undocked and moved anywhere on your screen, and even used without the rest of the &amarok; window displayed. To undock the Toolbar you should first make sure that the <menuchoice><guimenu>View</guimenu><guimenuitem>Lock Layout</guimenuitem></menuchoice> menu item is unselected. Now you can grab the toolbar at its left edge and drag it anywhere. To get it back just drag it into its old position while the layout is still unlocked.
</para>
</sect2>
<sect2 id="main-toolbar"><title>Main Toolbar</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbar_main.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>This is the default Toolbar. It has a <inlinemediaobject> <imageobject> <imagedata fileref="Icon-media-playback-start.png" format="PNG"/> </imageobject> </inlinemediaobject> / <inlinemediaobject> <imageobject> <imagedata fileref="Icon-media-playback-pause.png" format="PNG"/> </imageobject> </inlinemediaobject> button on the left and displays the song title, album and artist in the center-top.
</para>
<para>The previous and next track are shown on either side of the song title. Clicking one of them will make &amarok; skip to that track.
</para>
<para>A <emphasis>Progressbar</emphasis> with the already played time on the left and remaining time on the right shows the current position in the song. If you have <emphasis>Moodbars</emphasis> enabled, and .mood files for your tracks, this is where they will be displayed. More about <link linkend="the-moodbar">the Moodbar</link> later.
</para>
<para>By using the slightly transparent <inlinemediaobject> <imageobject> <imagedata fileref="Icon-emblem-favorite.png" format="PNG"/> </imageobject> </inlinemediaobject> and <inlinemediaobject> <imageobject> <imagedata fileref="Icon-flag-green.png" format="PNG"/> </imageobject> </inlinemediaobject> buttons next to the text you can add the current song to your loved tracks on <ulink url="http://www.last.fm/">last.fm</ulink> or add a position marker.
</para>
<para>On the right is the volume-control button. A blue circle around the button shows the current volume. The volume is 0 at the bottom and increases clockwise. Change volume by clicking on the volume circle or by using the scroll wheel while the mouse hovers the button. The sound can also be completely muted by clicking on the speaker in the center.
</para>
</sect2>
<sect2 id="slim-toolbar"><title>Slim Toolbar</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="slim_toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The <emphasis>Slim Toolbar</emphasis> has the same functionality as the <emphasis>Main Toolbar</emphasis>, but is more compact. Additionally the <emphasis>Slim Toolbar</emphasis> has a <inlinemediaobject> <imageobject> <imagedata fileref="Icon-media-playback-stop.png" format="PNG"/> </imageobject> </inlinemediaobject> button to stop playing so the current song will be restarted when you press <inlinemediaobject> <imageobject> <imagedata fileref="Icon-media-playback-start.png" format="PNG"/> </imageobject> </inlinemediaobject> again. All buttons concerning the current track are on the left and only the volume control on the right side. Here the volume is controlled by clicking on the button and dragging the slider or using the scroll wheel while the mouse is hovering the button.
</para>
</sect2>
</sect1>
<sect1 id="the-media-sources-pane1"><title>The Media Sources pane</title> 
<para>The <emphasis>Media Sources</emphasis> pane on the left by default is where you access your local collection as well as other services: <emphasis>Local Music</emphasis> on top, which is the primary interface to your local collection and connected media such as mp3 players and CDs.
</para>
<para>There is a section for all <emphasis>Internet Services</emphasis> that you have enabled. Here, you can browse listings of radio stations and podcasts; listen and/or subscribe to them, interact with your <ulink url="http://www.last.fm">last.fm</ulink> account, purchase music from online stores such as our new Amazon mp3 store, <ulink url="http://www.magnatune.com/">Magnatune</ulink> and download independent artists' music from <ulink url="http://www.jamendo.com/">Jamendo</ulink> and more.
</para>
<para>The <emphasis>Playlists</emphasis> section allows you to create and manage <emphasis>Dynamic Playlists</emphasis>, access your <emphasis>Saved Playlists</emphasis> as well as the <emphasis>Automatic Playlist Generator</emphasis>.
</para>
<para>The <emphasis>Files</emphasis> section displays an integrated file browser and the <emphasis>Podcasts</emphasis> section offers you access to your podcast subscriptions.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="media_sources1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect2 id="navigation-menu"><title>Navigation Menu</title> 
<para>The <emphasis>Navigation menu</emphasis> consists of the <emphasis>Filter bar</emphasis>, <emphasis>Bookmark button</emphasis> and <emphasis>Breadcrumbs navigation bar</emphasis>.
</para>
<sect3 id="the-filter-bar"><title>The Filter Bar</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources8.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The <emphasis>Filter Bar</emphasis> filters the content according to the text in the box.
</para>
</sect3>
<sect3 id="bookmarks"><title>Bookmarks</title> 
<para>To access this feature, click on the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-bookmark-new-list.png" format="PNG"/> </imageobject> </inlinemediaobject> icon above the <emphasis>Filter bar</emphasis>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources10.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Bookmark Media Sources View</guilabel></para>
    </entry>
    <entry>
    <para>Adds the current <emphasis>Media Sources</emphasis> view configuration to the bookmark list.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Copy Current View Bookmark to Clipboard</guilabel></para>
    </entry>
    <entry>
    <para>Copies bookmark to the system clipboard.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Bookmark Manager</guilabel></para>
    </entry>
    <entry>
    <para>Displays a list of all available bookmarks in a new window, with options to edit them.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><emphasis>Bookmark List</emphasis></para>
    </entry>
    <entry>
    <para>Lists all your bookmarks for faster selection.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
</sect2>
<sect2 id="local-music"><title>Local Music</title> 
<para>Displays the music from your default collection folder, sorted as specified. Both the regular (non-merged) view and <emphasis>Merged</emphasis> view of the same collection are shown, with the same sorting. Click the icon <inlinemediaobject> <imageobject> <imagedata fileref="Icon-view-list-tree.png" format="PNG"/> </imageobject> </inlinemediaobject> to toggle between views.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_collectionbrowser_nonmerged.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Regular non-merged view</phrase>
    </textobject>
    <caption>
      <para>Regular non-merged view</para>
    </caption>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_collectionbrowser_merged.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Merged view</phrase>
    </textobject>
    <caption>
      <para>Merged view</para>
    </caption>
  </mediaobject>
</screenshot></para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>Click the icon <inlinemediaobject> <imageobject> <imagedata fileref="Icon-preferences-other.png" format="PNG"/> </imageobject> </inlinemediaobject> to change the sorting criteria, using the following menu:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_collectionsortingmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Artist/Album</guilabel></para>
    </entry>
    <entry>
    <para>Shows the collection sorted by artists and album names. If two entries have the same artist they will be sorted by album.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Album/Artist</guilabel></para>
    </entry>
    <entry>
    <para>Shows the collection sorted by album and artist names.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Genre/Artist</guilabel></para>
    </entry>
    <entry>
    <para>Shows the collection sorted by genre and artist. If two entries have the same genre they will be sorted by artist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Genre/Artist/Album</guilabel></para>
    </entry>
    <entry>
    <para>Shows the collection sorted by genre, artist and album. If two entries have the same artist they will be sorted by album.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Levels</guilabel></para>
    </entry>
    <entry>
    <para>Designate the window cascade order of your elements.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show Years</guilabel></para>
    </entry>
    <entry>
    <para>Check if you want years to be displayed.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show Track Numbers</guilabel></para>
    </entry>
    <entry>
    <para>Check if you want track numbers to be displayed.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show Cover Art</guilabel></para>
    </entry>
    <entry>
    <para>Check if you want cover art to be displayed.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="internet"><title>Internet</title> 
<para>Shows your internet collection, added and configured in <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok...</guisubmenu><guimenuitem>Plugins</guimenuitem></menuchoice>. More <link linkend="internet-services">about configuring Internet Services</link>. There are some scripts which add Internet Services; see <link linkend="scripts">Scripts</link> for more information.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Cool Streams</guilabel></para>
    </entry>
    <entry>
    <para>Lists quality radio streams.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Jamendo</guilabel></para>
    </entry>
    <entry>
    <para>Connects with <guilabel>Jamendo</guilabel>, a growing free music database.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Last.fm</guilabel></para>
    </entry>
    <entry>
    <para>Connects with <guilabel>Last.fm</guilabel>; embedding the site experience in &amarok;.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Librivox.org</guilabel></para>
    </entry>
    <entry>
    <para>Connects with <guilabel>Librivox</guilabel>, an extensive collection of free audio books.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Magnatune.com</guilabel></para>
    </entry>
    <entry>
    <para>Connects with <guilabel>Magnatune</guilabel>, a great online music store.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>MP3 Music Store</guilabel></para>
    </entry>
    <entry>
    <para>Connects with <guilabel>Amazon MP3 Store</guilabel>, an online music store.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Podcast Directory</guilabel></para>
    </entry>
    <entry>
    <para>Shows a large list of podcasts. If you choose to subscribe, the podcast menu will be automatically updated.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="playlist2"><title>Playlist</title> 
<para>Media Sources Playlists menu:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources5.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Dynamic Playlists</guilabel></para>
    </entry>
    <entry>
    <para>Dynamically updating parameter-based playlist; more on this <link linkend="dynamic-playlists">here</link>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Saved Playlists</guilabel></para>
    </entry>
    <entry>
    <para>Saved and imported playlists; more on this <link linkend="saved-playlists">here</link>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Automated Playlist Generator</guilabel></para>
    </entry>
    <entry>
    <para>Creates playlists by specific criteria; more on this <link linkend="automatic-playlist-generator">here</link>.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="files"><title>Files</title> 
<para>The &amarok; <emphasis>file browser</emphasis> helps you add music to your collection, or simply play tracks from your hard drive.
</para>
<para>Navigate through your files using the icon buttons: <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-previous.png" format="PNG"/> </imageobject> </inlinemediaobject> (previous), <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-next.png" format="PNG"/> </imageobject> </inlinemediaobject> (next), <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-up.png" format="PNG"/> </imageobject> </inlinemediaobject> (up), <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-home.png" format="PNG"/> </imageobject> </inlinemediaobject> (home), or <inlinemediaobject> <imageobject> <imagedata fileref="Icon-folder-remote.png" format="PNG"/> </imageobject> </inlinemediaobject> (places), very similar to a web browser menu; or click on anywhere in the <emphasis>breadcrumbs</emphasis> to go directly to that level.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources6.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If you would rather search or filter for something rather than navigating to it, use the <emphasis>filter field</emphasis> to find the desired content. Partially type the name of the file and it will be displayed as in this example.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasourcesex.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="podcasts"><title>Podcasts</title> 
<para>Lists your subscribed podcasts; from here you can listen, organize, add, import or unsubscribe podcasts.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mediasources7.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Add Podcast</guilabel></para>
    </entry>
    <entry>
    <para>Add a podcast URL: <emphasis>RSS 1.0/2.0</emphasis> or <emphasis>Atom feed</emphasis>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-folder-new.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Add a folder to the podcast navigation menu.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Visible Sources</guilabel></para>
    </entry>
    <entry>
    <para>Selects what category of podcasts you can view.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Merged View</guilabel></para>
    </entry>
    <entry>
    <para>Displays the podcasts in a merged or unmerged view.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-view-refresh.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Checks all podcasts for updates and downloads any available.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-import.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Imports an OPML file from your hard drive.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
</sect1>
<sect1 id="the-context-pane"><title>The Context pane</title> 
<para>The <emphasis>Context</emphasis> pane is a panel to which you can add various applets which offer information and media on the current music. A connection to the Internet is required for the most useful use of these little applications, which will fetch lyrics, information, photos, and even guitar or bass tabs, depending on which applets you choose to display.
</para>
<sect2 id="using-the-context-pane"><title>Using the Context pane</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_contextview_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Context pane when not playing</phrase>
    </textobject>
    <caption>
      <para>Context pane when not playing</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Pictured is the <emphasis>Context</emphasis> pane when no track is playing. If it is hidden, use <menuchoice><guimenu>View</guimenu><guimenuitem>Context</guimenuitem></menuchoice> to display it. The pane is divided in two parts:
</para>
<itemizedlist>
<listitem><para>The applet panel itself, where you can interact with some of the applets, such as editing lyrics or changing settings.</para></listitem>
<listitem><para>The lower portion of the panel, where you can expand and collapse applets and manipulate them in various ways once you click the <emphasis>Configure Applets</emphasis> icon <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject>.</para></listitem>
</itemizedlist>
<sect3 id="configuring-applets"><title>Configuring Applets</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_appletexplorer_default.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Once you click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> in the lower portion of the <emphasis>Context</emphasis> pane changes slightly; each applet tab gets an <inlinemediaobject> <imageobject> <imagedata fileref="Icon-application-exit.png" format="PNG"/> </imageobject> </inlinemediaobject> icon that you can click to remove it, and a list of applets appear. To add new applet, simply click on the applet, and it will appear in the pane, ready to be used. To change the applet display order, click the tabs and drag them around the bar.
</para>
</sect3>
</sect2>
<sect2 id="applets"><title>Applets</title> 
<para>There are several applets available to dock in your <emphasis>Context</emphasis> pane; below is a description of each.
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <tbody>
  <row>
    <entry>
    <para><guilabel>Applet</guilabel></para>
    </entry>
    <entry>
    <para><guilabel>Icon</guilabel></para>
    </entry>
    <entry>
    <para><guilabel>Description</guilabel></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Current Track</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-current-track-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Information about the current track. You may rate it by clicking on the stars, add a position marker, or edit track metadata. When not playing, the applet displays collection information and <emphasis>Recently Played Tracks</emphasis>, which allows you to view the tracks and add them to the playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Similar Artists</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-similarartists-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Fetches artists similar to the currently playing one, with a short description and options to find them in your collection, or on <emphasis>Last.fm</emphasis>, and add to your current playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Upcoming Events</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-upcomingevents-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Displays upcoming events that involve the current artist or group. You can set a venue locale to be watched by entering the applet settings and narrowing it down under the Favorites section.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Wikipedia</guilabel></para>
    </entry>
    <entry>
    <para></para>
    </entry>
    <entry>
    <para><emphasis>Wikipedia</emphasis> page for the track or artist. Also browse other <emphasis>Wikipedia</emphasis> links, and use the back button to go back to the starting page.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Labels</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-label-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>View, add and edit Labels for the current song. To add a Label just type it in the text box and press &Enter;. Suggested Labels are user-contributed tags from <emphasis>Last.fm</emphasis>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Tabs</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-filename-genre-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Fetches and displays guitar and bass tabs (if available). Not editable.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Lyrics</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-amarok_lyrics.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Displays the lyrics of the song that is currently playing. Add or change lyrics scripts in the <link linkend="scripts">Script Manager</link>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Albums</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-filename-album-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>View albums from the current artist or band that are available in your local Collection.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Photos</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-image-x-generic.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>This applet queries <emphasis>Flickr.com</emphasis> for pictures of the band you're listening to. Open the settings to add more keywords to your query (&eg;: live in tokyo).&gt;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Analyzer</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-view-media-analyzer-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>This is a new applet in version 2.8. It provides basic audio visualizations. A right click on it allows to configure the applet settings.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Info</guilabel></para>
    </entry>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-info-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Information about the current media source. Allows you to navigate through internet services such as <emphasis>Librivox.org</emphasis>.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
</sect1>
<sect1 id="the-playlist-pane3"><title>The Playlist pane</title> 
<para>&amarok; offers excellent playlist management for all of your songs and other audio files. Here you see a short playlist, sorted by album.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistpane.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>&amarok; Playlist pane</phrase>
    </textobject>
    <caption>
      <para>&amarok; Playlist pane</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<sect2 id="basic-playlist-manipulation"><title>Basic Playlist Manipulation</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2dot8pud.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist Pop Up Dropper menu</phrase>
    </textobject>
    <caption>
      <para>Playlist Pop Up Dropper menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Adding music to your playlist is a simple drag-and-drop, right-click or double-click operation.
</para>
<para>Two playlist-related options will be shown in the <emphasis>Context</emphasis> pane in the center (the <emphasis>Pop-Up Dropper</emphasis>, or <emphasis>PUD</emphasis>) when performing a drag-and-drop operation to add music to your current playlist. You can either use <guilabel>Add to Playlist</guilabel>, which will append the songs you have selected, or <guilabel>Replace Playlist</guilabel>, which will replace all the contents of the playlist with your selection.
</para>
<para>Alternatively, dragging-and-dropping your selection into a position in the <emphasis>Playlist</emphasis> pane also works.
</para>
<para>Right-clicking on a track, album, or selected group will bring up a context menu from which you can <guilabel>Add to Playlist</guilabel>, or <guilabel>Replace Playlist</guilabel>.
</para>
<para>Double-clicking a selection or pressing &Enter; while a track is selected in the <emphasis>Media Sources</emphasis> pane will perform the same as <guilabel>Add to Playlist</guilabel>.
</para>
<para>Middle-clicking an item will append it to the playlist and begin playing from the start of the playlist.
</para>
<para>If you tell the file browser to open a supported multimedia file, &amarok; will append the selected file to the current playlist. Some multimedia files contain playlists themselves or may have playlist files associated by name (&eg; <emphasis>wav</emphasis> with <emphasis>cue</emphasis>).  If &amarok; detects such an association, it may add several items to the playlist.
</para>
</sect2>
<sect2 id="context-menu"><title>Context menu</title> 
<para>Right-clicking on any song or album in the playlist will bring up the <emphasis>Playlist</emphasis> context menu.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6trackcontextmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect3 id="queue-dequeue-track"><title>Queue/Dequeue Track</title> 
<para>Queuing a track will temporarily modify the play order without modifying the actual playlist order by setting the user-selected track as the next track.
</para>
<para>As many tracks as required can be queued, and the order of queuing is indicated by a green circle with the determined order. Choose the tracks by <keycombo>&Shift;<keycap>Click</keycap></keycombo> for a block of tracks, or <keycombo>&Ctrl;<keycap>Click</keycap></keycombo> for individual tracks. The order in which the tracks are selected is the determined order.
</para>
<para>Tracks can be dequeued by opening the context menu and selecting the <guilabel>Dequeue Track</guilabel> option.
</para>
<para>More about the <link linkend="queue-manager">Queue Manager</link>.
</para>
</sect3>
<sect3 id="stop-playing-after-this-track"><title>Stop Playing After This Track</title> 
<para>Choosing this option allows a track to finish, after which &amarok; will stop playing . It will be indicated by the stop icon in place of the track number. Selecting this option on a track already marked will unmark it. Only one track in the playlist may be so marked.
</para>
</sect3>
<sect3 id="remove-from-playlist"><title>Remove From Playlist</title> 
<para>This removes the selected track from the current playlist.
</para>
</sect3>
<sect3 id="add-position-marker"><title>Add Position Marker</title> 
<para>Adding a position marker is only available for the currently playing track. This will add a bookmark in the seek bar at the top of the &amarok; interface.
</para>
</sect3>
<sect3 id="show-in-media-sources"><title>Show in Media Sources</title> 
<para>This displays the track selected in the <link linkend="the-media-sources-pane">Media Sources</link> pane, which is on the left by default.
</para>
</sect3>
<sect3 id="album"><title>Album</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6playlistalbumcontextmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist album menu</phrase>
    </textobject>
    <caption>
      <para>Playlist album menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>These are per-album options which will affect the entire album the track belongs to, rather than the track itself. The options are largely the same as the album menu in the <link linkend="the-media-sources-pane">Media Sources</link> pane.
</para>
</sect3>
<sect3 id="edit-track-details"><title>Edit Track Details</title> 
<para>This option brings up the <link linkend="tag-editor">Edit Track Details</link> dialog for the selected tracks.
</para>
</sect3>
</sect2>
<sect2 id="searching-the-playlist"><title>Searching the Playlist</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistfilteroptions.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist searching options</phrase>
    </textobject>
    <caption>
      <para>Playlist searching options</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>&amarok; offers powerful searching capabilities for playlists. Simply enter your query for a song into the text box labelled <guilabel>Search playlist</guilabel> and it will match your keywords up against the match criteria you specify in the options menu &mdash; for instance, you can choose to search only by <guilabel>Albums</guilabel> and not <guilabel>Artists</guilabel>, or choose to match both of them.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4searchplaylist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist search bar</phrase>
    </textobject>
    <caption>
      <para>Playlist search bar</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Pressing the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-up.png" format="PNG"/> </imageobject> </inlinemediaobject> icon moves the selection to the previous search result, and <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-down.png" format="PNG"/> </imageobject> </inlinemediaobject> moves to the next result, all without losing focus on the search input box.
</para>
<para>The <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-clear-locationbar-rtl.png" format="PNG"/> </imageobject> </inlinemediaobject> icon in the search field will clear your query.
</para>
<para>Enabling <guilabel>Show only matches</guilabel> from the menu will cause your playlist to display only the tracks matching the query.
</para>
<para>More about <link linkend="playlist-filtering">Playlist filtering here</link>.
</para>
</sect2>
<sect2 id="sorting-levels-and-bookmarking"><title>Sorting Levels and Bookmarking</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sorting.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist sorting and bookmarking toolbar</phrase>
    </textobject>
    <caption>
      <para>Playlist sorting and bookmarking toolbar</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<sect3 id="sorting-levels"><title>Sorting Levels</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistsortinglevels.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Menu for adding a sorting level</phrase>
    </textobject>
    <caption>
      <para>Menu for adding a sorting level</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>&amarok;'s robust sorting abilities offer the ability to sort not only by one field of a track, but by many combined in a series of levels.
</para>
<para>There are many different modes by which a sorting level can act. For instance, songs can be sorted by their <guilabel>Genre</guilabel> and then their <guilabel>Album</guilabel>.
</para>
<para>A sorting level can be added by clicking the right-pointing triangle, which will bring up the menu for adding another sorting level.
</para>
<para>Clicking the small triangle on the right of the sorting level's name will cause items in the playlist to switch between ascending and descending order, which is indicated by the direction in which the triangle is pointing &mdash; up or down, respectively.
</para>
<para>To remove a sorting level, click the name of the sorting level that precedes the one you wish to remove. Multiple sorting levels can be removed &mdash; provided that they are all lower in the hierarchy &mdash; by clicking on the ancestor of all of them. If you wish to clear all sorting levels, you can click the playlist icon to the left of the first right-pointing arrow.
</para>
</sect3>
<sect3 id="bookmarking"><title>Bookmarking</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="bookmarking_menu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Bookmarking menu</phrase>
    </textobject>
    <caption>
      <para>Bookmarking menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The bookmarking menu provides options to save your <link linkend="changing-the-playlist-layout">current playlist layout</link>. Clicking <guilabel>Bookmark Playlist Setup</guilabel> will add your playlist layout to the layout bookmarks, which can be viewed in <link linkend="bookmark-manager">Bookmark Manager</link>.
</para>
<para><guilabel>Copy Current View Bookmark to Clipboard</guilabel> copies an &amarok; playlist layout URL to the clipboard, which can be used for backing up your playlist layout.
</para>
</sect3>
</sect2>
<sect2 id="playlist-functions"><title>Playlist Functions</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistbottombar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist bottom bar</phrase>
    </textobject>
    <caption>
      <para>Playlist bottom bar</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The bottom bar of the <emphasis>Playlist</emphasis> pane provides various additional options for manipulation of your playlist.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <tbody>
  <row>
    <entry>
    <para>Icon</para>
    </entry>
    <entry>
    <para>Action</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-clear-playlist-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Empty playlist of all playlists, albums and tracks.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="document-save.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Save your playlist. Right-click to rename it, default is the date as a name. Left-click to bring up the <emphasis>Save Playlist</emphasis> menu, to save your playlist file onto the hard drive instead of the database.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="edit-undo.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Undo your last edit to playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="edit-redo.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Redo your last undo to playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-music-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Scrolls playlist to the track which is currently playing and highlights it &mdash; useful for a large  playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-media-standard-track-progression-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Set the play mode: repeat tracks, random order, prefer rarely played, &etc;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="hi48-action-edit-playlist-queue.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para>Edit the playlist queue; tracks played first before the playlist resumes. More about the <link linkend="queue-manager">Queue Manager</link>.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect3 id="save-playlist-menu"><title>Save Playlist menu</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlist_save.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Save playlist menu</phrase>
    </textobject>
    <caption>
      <para>Save playlist menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Left-click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-save.png" format="PNG"/> </imageobject> </inlinemediaobject> to bring up the <guilabel>Save Playlist</guilabel> menu, to save your playlist file onto the hard drive instead of the database.
</para>
</sect3>
<sect3 id="track-progression"><title>Track Progression</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="track_progression.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Track progression menu</phrase>
    </textobject>
    <caption>
      <para>Track progression menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The <guilabel>Track Progression</guilabel> menu enables you to modify the order in which &amarok; progresses through the tracks in your playlist.
</para>
<para>The top half of the menu specifies repeat options &mdash; whether songs should be repeated by track, by album or by playlist; whereas the bottom half specifies the order in which the tracks play in &mdash; in random order or by favor. Only one type of progression may be selected, &eg; you cannot select both random track and repeat playlist.
</para>
<sect4 id="favor"><title>Favor</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="favor.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist favor menu</phrase>
    </textobject>
    <caption>
      <para>Playlist favor menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Favor is an innovative method to determine the next track to be played when using the random selection mode. The next track to be played can be determined depending on their score (a measure of how often they are played), their user-given rating, or if they have not been recently played.
</para>
</sect4>
</sect3>
</sect2>
</sect1>
</chapter>
<chapter id="configuring-amarok"><title>Configuring Amarok</title> 
<para>On first start, some basic configuration is done; see also <link linkend="getting-started">Quick Start Guide: Getting Started</link>. But there is more under the hood.
</para>
<para>To access the <emphasis>Configuration Menu</emphasis>, go to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Amarok...</guimenuitem></menuchoice> and see the following dialog:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialoggeneral.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>General configuration options</phrase>
    </textobject>
    <caption>
      <para>General configuration options</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<sect1 id="general"><title>General</title> 
<para>In the screenshot above, see some <emphasis>General Options</emphasis> you can set. Depending on the distribution, the default settings can vary. When hovering over the options with the mouse pointer, a tooltip will show to explain the individual settings.
</para>
<para>General options:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Show tray icon</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable the &amarok; system tray icon.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Automatically retrieve cover art</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable the automatic retrieval of cover art from the internet.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Enable context applets collapse animations</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable animations when context applets collapse.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Automatically scroll playlist to current track</guilabel></para>
    </entry>
    <entry>
    <para>Check to make the playlist scroll so the current track is always visible.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show Moodbar in progress slider</guilabel></para>
    </entry>
    <entry>
    <para>The <emphasis>Moodbar</emphasis> makes it possible to navigate in your music visually. Please note that this feature requires the <link linkend="the-moodbar">external Moodbar Generator tool</link>, or a script.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Moodbar style</guilabel></para>
    </entry>
    <entry>
    <para>Choose the mood display style.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>When you enable the <emphasis>Moodbar</emphasis>, be aware of the following requirements: the Moodbar will only display if your tracks have been tagged with moods. For more about the Moodbar, refer to: <link linkend="the-moodbar">Moodbar</link>.
</para>
</sect1>
<sect1 id="local-collection"><title>Local Collection</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialoglocalcollection.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Local Collection configuration</phrase>
    </textobject>
    <caption>
      <para>Local Collection configuration</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>This dialog shows your file system in a tree structure, called <emphasis>Collection Folders</emphasis>. Selecting a folder always includes its subfolders. These folders will be scanned for media to make up your collection. You can right-click on a folder to individually rescan it, if it was previously selected.
</para>
<para>Collection options:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Fully Rescan Entire Collection</guilabel></para>
    </entry>
    <entry>
    <para>Rescan your entire collection. This will <emphasis>not</emphasis> delete any statistics.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Import</guilabel></para>
    </entry>
    <entry>
    <para>Imports ratings and/or statistics from older &amarok; versions, the batch scanner, or media players.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Scan folders recursively (requires full rescan if newly checked)</guilabel></para>
    </entry>
    <entry>
    <para>If selected, &amarok; will read all subfolders.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Watch folders for changes</guilabel></para>
    </entry>
    <entry>
    <para>If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Importing Music: Transcode tracks</guilabel></para>
    </entry>
    <entry>
    <para>Whether &amarok; should transcode tracks when they are copied or moved to <emphasis>Local Collection</emphasis>.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect2 id="import-statistics"><title>Import Statistics</title> 
<para>This option allows you to import statistics, &eg; ratings and scores from either
</para>
<itemizedlist>
<listitem><para>an older &amarok; 1.4.x version (from <guilabel>SQLite</guilabel>, <guilabel>MySQL</guilabel> or <guilabel>PostgreSQL</guilabel> databases)</para></listitem>
<listitem><para>from <guilabel>iTunes</guilabel></para></listitem>
</itemizedlist>
<para>It does <emphasis>not</emphasis> import statistics from an &amarok; 2.x database, so if you want to merge an older 2.x database version, you will need to do this by hand.
</para>
</sect2>
</sect1>
<sect1 id="metadata"><title>Metadata</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="metadatadialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>This dialog will allow you to configure the settings for metadata handling. This is a separate page starting with Amarok 2.7
</para>
<para>Metadata options:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Write statistics to file</guilabel></para>
    </entry>
    <entry>
    <para>Check to write play-changing statistics as tags back to the audio files.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Write covers to file, maximum size...</guilabel></para>
    </entry>
    <entry>
    <para>Check to write changed covers back to the audio files. This will replace existing embedded covers. Select a value from the drop-down list to set the maximum size of the cover.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Enable character set detection in ID3 tags</guilabel></para>
    </entry>
    <entry>
    <para>If checked, Amarok will use Mozilla's Character Set Detector to attempt to automatically guess the character sets used in ID3 tags. If your tags are correct, it is more safe to leave this option turned off.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect2 id="statistics-synchronization"><title>Statistics Synchronization</title> 
<para>This dialog will allow you to <link linkend="statistics-synchronization">keep statistics of your collections synchronized</link>. Make sure to only check collections between which you want to synchronize metadata.
</para>
<para>Statistics Synchronization options:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Synchronize Rating</guilabel></para>
    </entry>
    <entry>
    <para>Check to synchronize ratings between collections.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Synchronize First Played</guilabel></para>
    </entry>
    <entry>
    <para>Check to synchronize first played dates between collections.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Synchronize Last Played</guilabel></para>
    </entry>
    <entry>
    <para>Check to synchronize last played dates between collections.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Synchronize Playcount</guilabel></para>
    </entry>
    <entry>
    <para>Check to synchronize playcounts between collections.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Synchronize Labels</guilabel></para>
    </entry>
    <entry>
    <para>Check to synchronize labels between collections.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
</sect1>
<sect1 id="playback"><title>Playback</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogplayback.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playback configuration dialog</phrase>
    </textobject>
    <caption>
      <para>Playback configuration dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Configure the playback options, as well as the KDE multimedia framework &phonon;.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Fadeout on stop</guilabel></para>
    </entry>
    <entry>
    <para>If checked, &amarok; will slowly fade the volume of the playing track on stop or at the end of the playlist, or stop playback immediately.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Fadeout on pause</guilabel></para>
    </entry>
    <entry>
    <para>If checked, &amarok; will slowly fade the volume of the playing track on pausing the current track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Fadeout duration</guilabel></para>
    </entry>
    <entry>
    <para>The length of the fadeout, in milliseconds.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Inhibit automatic suspend if playing</guilabel></para>
    </entry>
    <entry>
    <para>If checked, &amarok; will prevent the computer from being suspended will a track is playing.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Pause playback on suspend</guilabel></para>
    </entry>
    <entry>
    <para>If checked, &amarok; will pause playing of the current track when the computer is about to suspend.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Resume playback on start</guilabel></para>
    </entry>
    <entry>
    <para>If checked, &amarok; will resume playback where you left it the last session -- just like a tape-player.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect2 id="configuring-phonon"><title>Configuring Phonon</title> 
<para>&phonon; is the multimedia framework used by &amarok;. It was created to allow KDE 4 to be independent of any single multimedia framework such as <guilabel>GStreamer</guilabel> or <guilabel>VLC</guilabel> and to provide a stable API for KDE 4's lifetime. As an added bonus, it simplifies development by providing a simple API that works across different platforms such as <guilabel>Windows</guilabel> and <guilabel>OS X</guilabel>.
</para>
<para>The result of all this for you, the user, is that you can choose the multimedia framework that works best for you. This is usually pre-configured by your distribution.
</para>
<para>Playback problems in &amarok; are typically not &amarok; issues, but rather &phonon; issues, as &amarok; doesn't handle sound directly anymore.
</para>
<sect3 id="device-preference-tab"><title>Device Preference tab</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokconfigurationdialog2-7phonondevice.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Depending on your OS and distribution, you may need to use <guilabel>ALSA</guilabel>, <guilabel>OSS</guilabel>, <guilabel>PulseAudio</guilabel>, or something else as your default playback device. Find one that works for you with the <guilabel>Test</guilabel> button and apply to all types of output. If you would like different types of output to go with different devices, this is possible as well.
</para>
</sect3>
<sect3 id="speaker-setup-tab"><title>Speaker Setup tab</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokconfigurationdialog2-7phononhardware.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Should you wish to change the standard speaker setup, here is the place to do it.
</para>
</sect3>
<sect3 id="backend-tab"><title>Backend tab</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokconfigurationdialog2-7phononbackend.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Depending on your operating system you may see options such as <emphasis>Gstreamer</emphasis>, <emphasis>VLC</emphasis>, or <emphasis>DS9</emphasis> (Windows) here. The recommended phonon-backend for &Linux; users is <emphasis>VLC</emphasis> or <emphasis>Gstreamer</emphasis>.
</para>
<para>If you don't see <emphasis>VLC</emphasis> or <emphasis>Gstreamer</emphasis>, install the package for it. For most distributions the package for <emphasis>VLC</emphasis>, for example, would be <guilabel>phonon-backend-vlc</guilabel>.
</para>
<para>Each backend comes with its own codecs, so depending on the backend you choose you will need to also download the codecs, as most distributions don't ship them for legal reasons.
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="notifications"><title>Notifications</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialognotifications.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Notifications configuration dialog</phrase>
    </textobject>
    <caption>
      <para>Notifications configuration dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Use On-Screen Display</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable the <emphasis>On-Screen Display</emphasis>. The <emphasis>OSD</emphasis> briefly displays track data when a new track is played. Once checked, the OSD will be visible on your screen and you can drag it to the location you prefer.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Duration</guilabel></para>
    </entry>
    <entry>
    <para>The time in milliseconds for which to show the OSD. The value must be between 500 ms and 10000 ms.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Screen</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to choose the screen that should display the OSD if you have a multiscreen setup. Default is 0.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Translucent</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable translucency if supported by your desktop system.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Font scale</guilabel></para>
    </entry>
    <entry>
    <para>(choose the size of the font in the OSD)</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Don't show when a fullscreen application is active</guilabel></para>
    </entry>
    <entry>
    <para>Do not show On-Screen Display if another application is focused and running in fullscreen mode.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Use custom colors</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable custom colors for the <emphasis>On-Screen Display</emphasis> text.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Text color</guilabel></para>
    </entry>
    <entry>
    <para>Click to select the color of the <emphasis>OSD</emphasis> text.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Use system notifications</guilabel></para>
    </entry>
    <entry>
    <para>Check to use the system notification. This can vary depending on your desktop system and/or distribution.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect1>
<sect1 id="database"><title>Database</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogdatabase.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>External Database configuration dialog</phrase>
    </textobject>
    <caption>
      <para>External Database configuration dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>The default database is already set to use embedded <guilabel>MySQL</guilabel>. For most users there is no need to configure an external database, as there is no change in performance. If you want to share your database or use it remotely, you can configure an external <guilabel>MySQL</guilabel> database.
</para>
<para>&amarok; expects the external database and user account to already exist. The user also requires full access to the database. You MUST restart &amarok; after changing these settings.
</para>
<para>If your database is not already set up, you can use the SQL commands in the field at the bottom to do so, after replacing the password with the correct one.
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Option</entry>
    <entry>Tooltip</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Use external MySQL Database</guilabel></para>
    </entry>
    <entry>
    <para>Check to enable the use of an external database.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Server</guilabel></para>
    </entry>
    <entry>
    <para>Enter the name of the existing <guilabel>MySQL</guilabel> server.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Port</guilabel></para>
    </entry>
    <entry>
    <para>Enter the port number to access the server. Default is port 3306.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Username</guilabel></para>
    </entry>
    <entry>
    <para>Enter the username to access the database with full access privileges.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Password</guilabel></para>
    </entry>
    <entry>
    <para>Enter the password for the default user.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Database</guilabel></para>
    </entry>
    <entry>
    <para>Enter the name of the database. Default preset is amarokdb.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>You can find more information about the External Database <link linkend="external-database">here</link>.
</para>
</sect1>
<sect1 id="plugins"><title>Plugins</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogplugins.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Plugins configuration dialog</phrase>
    </textobject>
    <caption>
      <para>Plugins configuration dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Plugins configuration controls <guilabel>Collections</guilabel>, <guilabel>Internet Services</guilabel>, and <guilabel>Local Collection Backends</guilabel>.
</para>
<sect2 id="collections"><title>Collections</title> 
<para>&amarok; offers you access to the following Collections, if they are available:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Collection</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>AudioCD Collection</guilabel></para>
    </entry>
    <entry>
    <para>AudioCD collection plugin for &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>DAAP Collection</guilabel></para>
    </entry>
    <entry>
    <para>DAAP collection plugin for &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>iPod, iPad &amp; iPhone Collection</guilabel></para>
    </entry>
    <entry>
    <para>Plugin to use iPod-like devices as collections in &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>MTP Collection</guilabel></para>
    </entry>
    <entry>
    <para>MTP collection plugin for &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Universal Mass Storage Collection</guilabel></para>
    </entry>
    <entry>
    <para>UMS/USB collection plugin for &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>UPnP Collection</guilabel></para>
    </entry>
    <entry>
    <para>UPnP collection plugin for &amarok;</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="internet-services"><title>Internet Services</title> 
<para>&amarok; offers by default the following Internet services:
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <thead>
  <row>
    <entry>Service</entry>
    <entry>Description</entry>
    <entry>Needs configuration <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject></entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Ampache</guilabel></para>
    </entry>
    <entry>
    <para>Use an external music server</para>
    </entry>
    <entry>
    <para>Yes, <guilabel>Ampache</guilabel> server needed</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>gpodder.net</guilabel></para>
    </entry>
    <entry>
    <para>Podcast service. See also <ulink url="http://www.gpodder.net">gpodder.net</ulink></para>
    </entry>
    <entry>
    <para>No</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Jamendo</guilabel></para>
    </entry>
    <entry>
    <para>Listen to free music published under Creative Common licenses. See also <ulink url="http://www.jamendo.com/en/about">Jamendo.com</ulink></para>
    </entry>
    <entry>
    <para>No</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Last.fm</guilabel></para>
    </entry>
    <entry>
    <para>A popular internet radio service, streaming only for subscribers. See also <ulink url="http://www.last.fm/about">Last.fm</ulink></para>
    </entry>
    <entry>
    <para>Yes, personal information to <link linkend="scrobble">scrobble</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Magnatune Store</guilabel></para>
    </entry>
    <entry>
    <para>Preview and buy music from a non-evil record label. See also <ulink url="http://magnatune.com/info/whynotevil">Magnatunes.com</ulink></para>
    </entry>
    <entry>
    <para>Only for downloads</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>MP3 Music Store</guilabel></para>
    </entry>
    <entry>
    <para>Access the Amazon MP3 Store directly from Amarok</para>
    </entry>
    <entry>
    <para>Yes</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>mp3tunes</guilabel></para>
    </entry>
    <entry>
    <para>A personal mp3 locker. See also <ulink url="http://www.mp3tunes.com/cb/about/">mp3tunes.com</ulink></para>
    </entry>
    <entry>
    <para>Yes</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Podcast Directory</guilabel></para>
    </entry>
    <entry>
    <para>Browse and subscribe to a huge choice of podcasts</para>
    </entry>
    <entry>
    <para>No</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>Other service are available through scripts.
</para>
</sect2>
<sect2 id="local-collection-backends"><title>Local Collection Backends</title> 
<para>&amarok; offers you access to the following Local Collection Backends, if they are available:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Devices</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Local Files &amp; USB Mass Storage Backend</guilabel></para>
    </entry>
    <entry>
    <para>Local Collection folders on local and pluggable disks</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>NFS Share Backend</guilabel></para>
    </entry>
    <entry>
    <para>Local Collection folders on remote NFS shares (Network File System)</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>SMB (Windows) Share Backend</guilabel></para>
    </entry>
    <entry>
    <para>Local Collection folders on remote Samba (Windows) shares</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="ampache-configuration"><title>Ampache configuration</title> 
<para>If you have access to a remote <guilabel>Ampache</guilabel> music server, click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> and enter the necessary information. You can configure access to more than one <guilabel>Ampache</guilabel> server. For more information see the <link linkend="ampache">Ampache</link> section in what follows.
</para>
</sect2>
<sect2 id="last-fm-configuration"><title>Last.fm configuration</title> 
<para>While streaming is free with Last.fm's own online player for residents of the US, the UK and Germany, it only works in &amarok; for paid subscribers. Scrobbling is free, however, provided you enter your Last.fm username and password by clicking <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject>. &amarok; allows you to store the password in the secure <guilabel>KDE Wallet</guilabel>. If you decline the use of <guilabel>Kwallet</guilabel>, your password will be stored in clear text instead.
</para>
</sect2>
<sect2 id="magnatune-store-configuration"><title>Magnatune Store configuration</title> 
<para>Listen to the music offered by Magnatune for free and buy it directly through &amarok;. Click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> to add your membership credentials if you are a member and/or add your email address to re-download music you previously have downloaded from Magnatune.
</para>
<para>To download, you then go to the <emphasis>Media Sources</emphasis> pane, select the Internet section and click on the Magnatune Store. It will then download the catalog where you can search and select the music you want to buy.
</para>
</sect2>
<sect2 id="mpthree-store-configuration"><title>MP3 Store configuration</title> 
<para>Access the Amazon MP3 Store directly from &amarok;.
</para>
<para>The Amazon MP3 Store needs to know what country you are located in because it offers different items depending on your location. The following countries are allowed:
</para>
<itemizedlist>
<listitem><para>France</para></listitem>
<listitem><para>Austria, Germany, Switzerland</para></listitem>
<listitem><para>Japan</para></listitem>
<listitem><para>United Kingdom</para></listitem>
<listitem><para>United States (default)</para></listitem>
</itemizedlist>
<para>NOTE: Changing the country invalidates your shopping cart. If your country is not in the list, you cannot use the Amazon MP3 Store because it is not supported by Amazon.
</para>
</sect2>
<sect2 id="mp3tunes-configuration"><title>mp3tunes configuration</title> 
<para>If you have a personal mp3tunes locker, click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> and enter your username and password. You will then be able to access your online locker.
</para>
</sect2>
</sect1>
<sect1 id="scripts"><title>Scripts</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-7scriptsconfigmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Scripts configuration dialog</phrase>
    </textobject>
    <caption>
      <para>Scripts configuration dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Script Configuration in &amarok; covers <guilabel>Generic</guilabel>, <guilabel>Lyrics</guilabel>, and <guilabel>Scriptable Service</guilabel> scripts. Scripts are added in the <guilabel>Manage Scripts</guilabel> dialog.
</para>
<sect2 id="generic-scripts"><title>Generic scripts</title> 
<para>Generic scripts add functionality to &amarok;. The <emphasis>Amarok Script Console</emphasis> is available by default; other scripts which add CD burning, cover image storage, games, and many other choices are available. If installed, these scripts will show up in the <emphasis>Tools</emphasis> menu.
</para>
</sect2>
<sect2 id="lyrics-scripts"><title>Lyrics scripts</title> 
<para>A variety of lyrics scripts are available; <emphasis>Ultimate Lyrics</emphasis> is provided by default. Your chosen lyrics scripts will provide the lyrics shown in the <emphasis>Lyrics applet</emphasis> in the <emphasis>Context</emphasis> pane.
</para>
</sect2>
<sect2 id="scriptable-services-scripts"><title>Scriptable Services scripts</title> 
<para>Scriptable services, if enabled, will show up in the <emphasis>Internet Services</emphasis> in the <emphasis>Collections</emphasis> pane. Many collections of streams are available, in many languages, and from many sources.
</para>
</sect2>
<sect2 id="manage-scripts"><title>Manage Scripts</title> 
<para>At bottom of the configuration dialog are two options:
</para>
<itemizedlist>
<listitem><para><guilabel>Automatically update built-in scripts</guilabel></para></listitem>
</itemizedlist>
<para> Automatically download and install updates for the built-in scripts from the &amarok; website if available. Enable if you usually have a working Internet connections, and want your scripts automatically updated. This will not update user-supplied scripts from KDE-apps.org.
</para>
<itemizedlist>
<listitem><para><guilabel>Manage Scripts</guilabel> button</para></listitem>
</itemizedlist>
<para> Browse, install and uninstall user-supplied scripts; also search, sort and rate the scripts in the <emphasis>Amarok Add-on Installer</emphasis>.
</para>
<sect3 id="add-on-installer"><title>Add-on Installer</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_add-on_installer.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Amarok Script Manager</phrase>
    </textobject>
    <caption>
      <para>Amarok Script Manager</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Using the <emphasis>Add-on Installer</emphasis>, one can install the latest user-contributed &amarok; scripts. There are also options to search, sort and rate the scripts.
</para>
<para>The <guilabel>Install Scripts</guilabel> and <guilabel>Uninstall</guilabel> buttons can be used to manage scripts. One can install script packages of type amarokscript.tar, amarokscript.tar.bz2, amarokscript.tar.gz
</para>
</sect3>
<sect3 id="script-information"><title>Script Information</title> 
<para>Learn more about a script using the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-dialog-information.png" format="PNG"/> </imageobject> </inlinemediaobject> button.
</para>
<para>A script can also be executed directly in the Amarok Script Console. This is activated by selecting the Script Console and confirm the selection by hitting either the <guilabel>OK</guilabel> or the <guilabel>Apply</guilabel> button. To deactivate the Script Console deselect it and confirm again.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarokconfigurationdialog2-7scriptconsole.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="changing-layouts"><title>Changing Layouts</title> 
<sect2 id="changing-the-amarok-window-layout"><title>Changing the Amarok Window Layout</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6viewconfigmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The visibility of each of the three &amarok; panes is indicated in the <guilabel>View</guilabel> menu (part of the top-level menu). If you unlock the layout, each of the three panes will show two clickable boxes. These two boxes allow you to rearrange or customize the layout of your &amarok; window. Clicking the <guilabel>X</guilabel> closes that particular pane. Having been closed, a pane can be activated again by checking the appropriate box in the <guilabel>View menu</guilabel>. Clicking <guilabel>Reset Layout</guilabel> will of course reset the layout back to the default look.
</para>
<sect3 id="undocking-amarok-panes"><title>Undocking Amarok panes</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6viewundocksymbols.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Clicking the hollow symbol on the left of the cross causes that panel to be undocked, so it will appear as a separate window on your desktop. Repeating this action on the undocked pane will dock it again inside your &amarok; window. You can drag the panes inside your &amarok; window to reorder them. You may stack the panes, or even put one or two of them covering the others, selectable by tabs.
</para>
</sect3>
<sect3 id="lock-and-save-amarok-window-layout"><title>Lock and save Amarok window layout</title> 
<para>If you are satisfied with the layout inside your &amarok; window, you can lock this layout by clicking the appropriate item in the <guilabel>View</guilabel> menu. Be aware that if you want to be sure your layout is preserved when you shut down your session with &amarok; still open, quit &amarok; first by either choosing <menuchoice><guimenu>Amarok</guimenu><guimenuitem>Quit</guimenuitem></menuchoice>, or by typing <keycombo>&Ctrl;<keycap>Q</keycap></keycombo>.
</para>
</sect3>
</sect2>
<sect2 id="changing-the-toolbar"><title>Changing the Toolbar</title> 
<para>You can also choose between two layouts of the Toolbar by clicking the appropriate item in the <guilabel>View</guilabel> menu:
</para>
<para>
<informaltable>
  <tgroup cols="1">
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-maintoolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Main Toolbar</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-slimtoolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Slim Toolbar</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>More about the Toolbar <link linkend="toolbar">here</link>.
</para>
</sect2>
<sect2 id="changing-the-playlist-layout"><title>Changing the Playlist layout</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistlayouteditor.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>To access the <guilabel>Playlist Layout Editor</guilabel>, go to <menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>Configure Playlist Layouts...</guimenuitem></menuchoice> and you will see the above editor window. On the left you can see the preset layouts; clicking on those allows you to see how the configuration is done on the right. Clicking on the <guilabel>Preview</guilabel> button allows you to see the applied layout in the <guilabel>Playlist</guilabel> pane.
</para>
<sect3 id="modifying-a-default-layout"><title>Modifying a default layout</title> 
<para>To modify one of the default layouts, first make a new copy of it: simply click on <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-copy.png" format="PNG"/> </imageobject> </inlinemediaobject> and save it under a new name. To generate a new layout, click on <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-new.png" format="PNG"/> </imageobject> </inlinemediaobject>
</para>
<para>A layout consists of 3 elements: the Album <emphasis>Head</emphasis>, the Album <emphasis>Body</emphasis> (with a special album body for Various Artist tracks) and the <emphasis>Single</emphasis> Tracks configuration, selectable in the tabs in the  middle of the editor. To add an item, simply drag it from the selector on top and drop it in the layout tab elected below. To show the album cover, just check the <guilabel>Cover</guilabel> field.
</para>
<para>In addition, you can also add:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Show inline playback controls</guilabel></para>
    </entry>
    <entry>
    <para>playback controls will appear below the line of the playing track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show tooltips</guilabel></para>
    </entry>
    <entry>
    <para>Tooltips showing ID3 tag information will be shown on hovering over a track.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect4 id="item-layout-configuration"><title>Item layout configuration</title> 
<para>Each of the added items can then have its own layout configured: hovering over the item shows a wrench, clicking on this wrench will let you access a configuration dialog for that item. The example below shows you the configuration dialog for the <guilabel>Album</guilabel> item:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlist-layout-item-configuration-amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>You can then decide of the total width of the item (100% is the total width of the line, so if you use a custom width and have more than one item on a line, you need to reduce that width per item), its alignment, the font weight and whether the tag should be shown with a prefix or suffix.
</para>
</sect4>
<sect4 id="example--single-line-layout"><title>Example: single line layout</title> 
<para><emphasis>Example</emphasis>: to generate a single line layout without grouping you only add items in the <guilabel>Single</guilabel> Track element.
</para>
</sect4>
<sect4 id="playlist-layout-storage"><title>Playlist layout storage</title> 
<para>The playlist layouts will be stored in xml format in <filename>$HOME/.kde/share/apps/amarok/playlist_layouts</filename> (might be <filename>$HOME/.kde4/share/apps/amarok/playlist-layouts</filename> for some distributions).
</para>
</sect4>
</sect3>
</sect2>
</sect1>
</chapter>
<chapter id="organization"><title>Organization</title> 
<para>Organizing your music makes it easier to find what you want. &amarok; offers you several tools to assist.
</para>
<para>First, organize your collection of music, both local and remote:
</para>
<itemizedlist>
<listitem><para><link linkend="collection">Collection</link>&nbsp;<itemizedlist>
<listitem><para><link linkend="collection-scanning">Collection Scanning</link>&nbsp;</para></listitem>
<listitem><para><link linkend="search-in-collection">Search in Collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="organize-collection">Organize Collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="remote-collections">Remote Collections</link>&nbsp;
<itemizedlist>
<listitem><para><link linkend="ampache">Ampache</link>&nbsp;</para></listitem>
<listitem><para><link linkend="digital-audio-access-protocol-daap">DAAP</link>&nbsp;</para></listitem>
<listitem><para><link linkend="samba">Samba</link>&nbsp;</para></listitem>
<listitem><para><link linkend="universal-plug-and-play-upnp---dlna">UPnP</link></para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para><link linkend="external-database">External Database</link>&nbsp;</para></listitem>
<listitem><para><link linkend="working-with-media-devices">Working with Media Devices</link>&nbsp;</para></listitem>
</itemizedlist>
</para></listitem>
</itemizedlist><para>The <guilabel>Cover Manager</guilabel> organizes your album covers, the <emphasis>Tag Editor</emphasis> helps &amarok; categorize your tracks, and transcoding allows you to transfer tracks to your devices in encoding they can play.
</para>
<itemizedlist>
<listitem><para><link linkend="cover-manager">Cover Manager</link>&nbsp;</para></listitem>
<listitem><para><link linkend="tag-editor">Tag Editor</link>&nbsp;</para></listitem>
<listitem><para><link linkend="transcoding">Transcoding</link>&nbsp;</para></listitem>
</itemizedlist>
<sect1 id="collection4"><title>Collection</title> 
<para>&amarok; organizes your music in the <emphasis>Collection</emphasis>.
</para>
<itemizedlist>
<listitem><para><link linkend="collection-scanning">Collection Scanning</link>&nbsp;</para></listitem>
<listitem><para><link linkend="search-in-collection">Search in Collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="organize-collection">Organize Collection</link>&nbsp;</para></listitem>
<listitem><para><link linkend="statistics-synchronization">Statistics Synchronization Between Collections and with Last.fm</link>&nbsp;</para></listitem>
<listitem><para><link linkend="remote-collections">Remote Collections</link>&nbsp;<itemizedlist>
<listitem><para><link linkend="ampache">Ampache</link>&nbsp;</para></listitem>
<listitem><para><link linkend="digital-audio-access-protocol-daap">DAAP</link>&nbsp;</para></listitem>
<listitem><para><link linkend="samba">Samba</link>&nbsp;</para></listitem>
<listitem><para><link linkend="universal-plug-and-play-upnp---dlna">UPnP</link></para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para><link linkend="external-database">External Database</link>&nbsp;</para></listitem>
<listitem><para><link linkend="working-with-media-devices">Working with Media Devices</link>&nbsp;</para></listitem>
</itemizedlist>
<sect2 id="collection-scanning"><title>Collection Scanning</title> 
<para>Every time &amarok; is displaying a collection the information about tracks and albums needs to come from a source.
</para>
<para>The source can be an portable device, an Internet service or a database.
</para>
<para>For tracks that are in <guilabel>Local Collection</guilabel> folders &amarok; is using a database to have fast access to the required meta-information.
</para>
<para>At first this information needs to be loaded into the database which is usually done by scanning the <guilabel>Local Collection</guilabel> directories for audio files.
</para>
<para>This process is called collection scanning.
</para>
<para>It is useful to understand the scanning process in order to work better with &amarok;.
</para>
<sect3 id="incremental-scan---update-collection"><title>Incremental Scan / Update Collection</title> 
<para>The so-called incremental scan will check the collection directories for updates.
</para>
<para>This is done every minute if <guilabel>Watch folders for changes</guilabel> is enabled (on by default) but can also be triggered manually by selecting <guilabel>Update Collection</guilabel> from the menu.
</para>
<para>The incremental scan will just check the modification date of every folder in the collection against the last known modification time.
</para>
<para>This has a couple of implications:
</para>
<itemizedlist>
<listitem><para>You can trigger a rescan of one directory by modifying its time (such as using <varname>touch /path/to/directory</varname> in the console).</para></listitem>
<listitem><para>If files inside a directory are changed the scanner will not notice, because changing a file updates its modification time but not the time of the parent folder. On the other hand most programs that modify the files save them atomically by using a temporary file which is then renamed. Such procedure does update directory modification time and thus triggers directory rescan.</para></listitem>
<listitem><para>If the collection folders are on a very slow partition the process of checking all the modification times can take some time. Usually this information is cached by the operating system but with large collections that might not be possible. In such a case the scanner might appear to scan continuously. With collections above thousands of directories or when collections are stored on a network drive or an NTFS partition it is recommended to switch off the <guilabel>Watch folders for change</guilabel> option.</para></listitem>
</itemizedlist>
<para>If you have problems with deleted tracks still appearing in the collection, or you want to update album covers (which are not updated by a mere <guilabel>Update collection</guilabel>) then you can use the <guilabel>Full rescan</guilabel> option in the settings dialog.
</para>
<para><guilabel>Full rescan</guilabel> will not care about modification dates. It will not delete statistics of existing files; it will, however, delete statistics of tracks that disappeared from the currently mounted collection folders. Because of that it is adviseable to perform the <guilabel>Full rescan</guilabel> only with all <guilabel>Local Collection</guilabel> folders mounted if you move the tracks between mounts. <guilabel>Full rescan</guilabel> also updates play count if the one stored in file tags is greater, rating if the song is unrated and file tags mention rating and score (under the same circumstances).
</para>
</sect3>
<sect3 id="progress-bar---scanning-time"><title>Progress bar / scanning time</title> 
<para>The progress bar will show the progress of the scanning.
</para>
<para>Up to 50% the scanner will scan the file system and just buffer the result.
</para>
<para>Times above 50% indicate that the scanner is committing the results to the database.
</para>
<para>Usually the second step is much faster than the first so don't be surprised if the progress bar seems to jump.
</para>
<para>Up to 50% aborting the scan is possible. After 50%, the committing of the files cannot be stopped.
</para>
<para>The scanning time depends on your disk speed and other factors.
</para>
<para>Usually the first scan is a lot slower than subsequent scans where the files are cached by the operating system.
</para>
<para>A scan of 10000 files should take around three minutes on a modern computer. 50000 files should be around 13 minutes. Of course with an SSD (solid state drive) this will be much faster.
</para>
</sect3>
<sect3 id="backup-of-collection"><title>Backup of collection</title> 
<para>With the default settings &amarok; is storing all the collection information in a directory called <filename>~.kde/share/apps/amarok/mysqle/</filename> . It can be a good idea to make a backup of this directory from time to time, especially when you didn't enable the writing back of statistics information.
</para>
</sect3>
<sect3 id="about-unique-ids"><title>About unique ids</title> 
<para>&amarok; is tracking files by an id that is either stored in the audio track or computed using file metadata, tag metadata and first few kilobytes of the file.
</para>
<para>This id helps &amarok; to identify tracks that are moved to other locations so that statistics information (rating, score, playcount, first &amp; last played) are not lost.
</para>
<para>Currently &amarok; will not import tracks with duplicate unique ids.
</para>
<para>This leads to the surprising behavior that copied tracks still appear only once in &amarok;.
</para>
<para>In some circumstances even different tracks can end up with the same unique id. Such a problem can be seen by the debug output (start &amarok; with the --debug option in a console) while scanning.
</para>
</sect3>
<sect3 id="about-albums"><title>About Albums</title> 
<para>The scanner can only read single tracks but &amarok; will display those sorted by album and compilation (an album without one specific artist). &amarok; can't rely on the directory in which the files are located, since directory organizational schemes vary so widely.
</para>
<para>The scanner is therefore doing the following:
</para>
<itemizedlist>
<listitem><para>Tracks without an album artist or an artist (or a composer in case of a classical track) are placed in a compilation.</para></listitem>
<listitem><para>Tracks that have the compilation flag set or an album artist other than <quote>various artists</quote> will be placed in an album.</para></listitem>
<listitem><para>Tracks that have the compilation flag set to 0 are placed in a compilation.</para></listitem>
<listitem><para>Albums called <quote>Best Of</quote>, <quote>Anthology</quote>, <quote>Hit collection</quote>, <quote>Greatest Hits</quote>, <quote>All Time Greatest Hits</quote> and <quote>Live</quote> are always regarded as an album.</para></listitem>
<listitem><para>If we end up having tracks with several different artists left over they are placed inside a compilation, or else we make one album out of them.</para></listitem>
</itemizedlist>
<para>This process is quite complicated. However usually the outputs of the scanner can help in figuring out why the tracks are sorted as they are.
</para>
<para>In such a case try executing (on a command line) <userinput>amarokcollectionscanner -r <replaceable>~/your/music/directory</replaceable></userinput>
</para>
<para>Look for <quote>compilation</quote> tags and tracks with different <quote>artist</quote> and <quote>albumartist</quote> tags.
</para>
<para>You can remove the <emphasis>compilation</emphasis> tag from mp3 files with the following command: <userinput>id3v2 -r TCMP <replaceable>your filename here</replaceable></userinput>
</para>
</sect3>
</sect2>
<sect2 id="search-in-collection"><title>Search in Collection</title> 
<para><emphasis>Search Collection</emphasis> lets you specify complex filters to search for specific tracks in your collection. Use the edit box in the <emphasis>Media Sources</emphasis> pane or click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-properties.png" format="PNG"/> </imageobject> </inlinemediaobject> button right next to the edit box. Alternatively you can simply press <keycombo>&Ctrl;<keycap>F</keycap></keycombo> to activate the search bar.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_collectionbrowsersearchfield.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect3 id="edit-box"><title>Edit Box</title> 
<para>When you type in the input field, &amarok; will search for the text in all available tags such as artist, album and title. Your view of the collection will update automatically to display only the matches of the search.
</para>
<para>Pressing &Enter; after searching will populate your playlist with all of the found search items and clear the search box. This is a great way to quickly add hundreds or thousands of tracks to a playlist instantly!
</para>
<para>To search in a specific tag, type <varname>tag:value</varname> into the search bar. Operators like <quote>&gt;</quote> and <quote>&lt;</quote> can be used to create more general conditions. Several conditions can be used together by separating them by a space character. For time conditions, use the following abbreviations: d=day, w=week, m=month, y=year.
</para>
</sect3>
<sect3 id="tags5"><title>Tags</title> 
<para>The following tags can be searched:
</para>
<itemizedlist>
<listitem><para>Album</para></listitem>
<listitem><para>Artist</para></listitem>
<listitem><para>Bitrate</para></listitem>
<listitem><para>Composer</para></listitem>
<listitem><para>AlbumArtist</para></listitem>
<listitem><para>Genre</para></listitem>
<listitem><para>Playcount</para></listitem>
<listitem><para>Rating</para></listitem>
<listitem><para>Sample Rate</para></listitem>
<listitem><para>Score</para></listitem>
<listitem><para>Title</para></listitem>
<listitem><para>Track</para></listitem>
<listitem><para>Year</para></listitem>
<listitem><para>BPM</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="additional-searchable-fields"><title>Additional searchable fields</title> 
<para>Along with tags, the following can also be searched:
</para>
<itemizedlist>
<listitem><para>Comment</para></listitem>
<listitem><para>Filename</para></listitem>
<listitem><para>Disc number</para></listitem>
<listitem><para>Length</para></listitem>
<listitem><para>Filesize</para></listitem>
<listitem><para>Format</para></listitem>
<listitem><para>Added (to Collection)</para></listitem>
<listitem><para>First played</para></listitem>
<listitem><para>Label</para></listitem>
<listitem><para>Last modified</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="operators"><title>Operators</title> 
<para>Numerical tags can use the following operators to create a condition:
</para>
<itemizedlist>
<listitem><para>Equal: <quote>:</quote></para></listitem>
<listitem><para>Less than: <quote>&lt;</quote></para></listitem>
<listitem><para>Larger than: <quote>&gt;</quote></para></listitem>
</itemizedlist>
</sect3>
<sect3 id="examples"><title>Examples</title> 
<para>If you search without specifying a tag, &amarok; will search in all important text tags:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="searchincollection_example_editbox.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>More complex patterns can be used to get better results:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="searchincollection_example_editbox2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="edit-filter-dialog"><title>Edit Filter Dialog</title> 
<para>If you prefer to build your searches more programatically, drag down the icons for the search terms you want, and drag to change search-term order. You may search by: <guilabel>Simple text</guilabel>, <guilabel>Title</guilabel>,
</para>
<para><guilabel>Artist name</guilabel>, <guilabel>Album Artist Name</guilabel>, <guilabel>Album Name</guilabel>, <guilabel>Genre</guilabel>, <guilabel>Composer</guilabel>, <guilabel>Comment</guilabel>, <guilabel>Filename</guilabel>,
</para>
<para><guilabel>Year</guilabel>, <guilabel>Track Number</guilabel>, <guilabel>Disc Number</guilabel>, <guilabel>BPM</guilabel>,
</para>
<para><guilabel>Length</guilabel>, <guilabel>Bit Rate</guilabel>, <guilabel>Sample Rate</guilabel>, <guilabel>File Size</guilabel>,
</para>
<para><guilabel>Format</guilabel>, <guilabel>Added to Collection</guilabel>, <guilabel>Score</guilabel>, <guilabel>Rating</guilabel>,
</para>
<para><guilabel>First Played</guilabel>, <guilabel>Playcount</guilabel>, <guilabel>Label</guilabel>, <guilabel>Last Modified</guilabel>.
</para>
<para>You can also add <guilabel>OR</guilabel> and <guilabel>AND</guilabel> here.
</para>
<para>Select a term and check <guilabel>Invert condition</guilabel> to exclude items matching this term from the results. Choose <guilabel>AND</guilabel> or <guilabel>OR</guilabel> for all terms in this search. If you choose <guilabel>AND</guilabel>, all search-terms must be present.
</para>
<para>If <guilabel>OR</guilabel>, any matches will show up.
</para>
<para>Of course, clicking <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-clear-locationbar-rtl.png" format="PNG"/> </imageobject> </inlinemediaobject> removes your selections.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4-1editfilterdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="organize-collection"><title>Organize Collection</title> 
<para>While organizing your collection in &amarok; is a straight-forward task, you will be manipulating the actual files on your hard drive. Please be sure you have a backup of your files before you begin.
</para>
<para>With the <guilabel>Organize Files</guilabel> dialog of &amarok; you can easily manage the media files on your hard drive. When you change the naming scheme of media files, you will organize them, which is very powerful. To access the <guilabel>Organize Files</guilabel> dialog, right-click <menuchoice><guimenu>Local Collection</guimenu><guimenuitem>Organize Files</guimenuitem></menuchoice> in the <guilabel>Media Sources</guilabel> pane and the menu interface will pop-up.
</para>
<para><warning><para>Using this option will move the files to a new location, so you not only need appropriate rights for both the origin and the destination location, but also enough space, usually the double of the total file size to have the action perform smoothly. If you are unsure, do NOT use this option.</para></warning>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="oraganize_menu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Context menu to Organize Collection dialog</phrase>
    </textobject>
    <caption>
      <para>Context menu to Organize Collection dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>If the option <guilabel>Organize Files</guilabel> does not appear, you may have  Merged View on (toggled by <inlinemediaobject> <imageobject> <imagedata fileref="Icon-view-list-tree.png" format="PNG"/> </imageobject> </inlinemediaobject>). In order to safely organize your files, you need to see your collections separated, not merged.
</para>
<sect3 id="organizing-files-interface"><title>Organizing Files Interface</title> 
<para>After selecting the option <guilabel>Organize Files</guilabel> you will first see an additional option that allows you to move the files to a new location, as well as transcode them at the same time. Depending on the codecs you have installed on the system, some format options might not be available and will be grayed out:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_organizefilestranscode.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>First screen when choosing the Organize Files option</phrase>
    </textobject>
    <caption>
      <para>First screen when choosing the Organize Files option</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>For more information about Transcoding, please see the <link linkend="transcoding">Transcoding</link> section.
</para>
<para>After clicking on the <guilabel>Move</guilabel> button on top of the screen, the following interface will show:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_organizetracks.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Organize Tracks dialog</phrase>
    </textobject>
    <caption>
      <para>Organize Tracks dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="contents"><title>Contents</title> 
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Interface Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Collection Folder</guilabel></para>
    </entry>
    <entry>
    <para>The default collection folder. Set multiple folders in <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Amarok</guimenuitem></menuchoice>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Token Bar</guilabel></para>
    </entry>
    <entry>
    <para>Drag and drop multiple tokens here to change the naming scheme of your media files. Only available in <guilabel>Basic</guilabel> view.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Format Presets</guilabel></para>
    </entry>
    <entry>
    <para>When you have created your naming scheme, save it as a preset by clicking <guilabel>Save Preset</guilabel>. Remove presets by clicking <guilabel>Remove Preset</guilabel>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Replace Spaces With Underscores</guilabel></para>
    </entry>
    <entry>
    <para>If checked, converts spaces in filenames to underscores.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Ignore 'The' in Artist names</guilabel></para>
    </entry>
    <entry>
    <para>If checked, artists' names starting with 'The' will instead be styled ', The'.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>VFAT Safe Names</guilabel></para>
    </entry>
    <entry>
    <para>If checked, replaces characters that are incompatible with <emphasis>MS-DOS</emphasis> or <emphasis>VFAT</emphasis> file systems with underscores. Most people can leave this option enabled.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Restrict to ASCII</guilabel></para>
    </entry>
    <entry>
    <para>If checked, all non-ASCII characters will be replaced with underscores. <emphasis>Do not check this option if you have non-English characters in your tags</emphasis>. Most people can leave this option unchecked.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Custom Character Replacement</guilabel></para>
    </entry>
    <entry>
    <para>Replace the tag expressions you write under the <guilabel>Replace</guilabel> box with character strings you write in the <guilabel>With</guilabel> box. Useful if there are mis-spellings in CDDB.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Destination Preview</guilabel></para>
    </entry>
    <entry>
    <para>Shows the original naming scheme of your media files and how they will look after the changes are applied (not available since ver. 2.4.2).</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Overwrite Destination</guilabel></para>
    </entry>
    <entry>
    <para>If checked, overwrites files of the same name without asking for further confirmation (not available since ver. 2.4.2).</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="advanced-contents"><title>Advanced Contents</title> 
<para>The code version of the <guilabel>Token Bar</guilabel>, which allows you to code the name format of media files. Activate it by pressing <guilabel>Advanced...</guilabel> in the interface menu. To change back click <guilabel>Basic...</guilabel>.
</para>
<para>Enclose conditional inclusion arguments such as CD number in braces, like this:
</para>
<para><userinput>%artist%/%album%{/Disc %discnumber%}/%track% %title%</userinput>
</para>
<para>Note: formerly, the coding was <varname>%token</varname>, as of 2.4 it is <varname>%token%</varname>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4organizefilesadvanceddialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="statistics-synchronization-between-collections-and-with-last-fm"><title>Statistics Synchronization Between Collections and with Last.fm</title> 
<para>Beginning with version 2.7, &amarok; allows syncing the play-related metadata and statistics of the tracks (such as rating or play count) between any of your collections which show up in <menuchoice><guimenu>Media Sources</guimenu><guimenuitem>Local Music</guimenuitem></menuchoice> and with the Last.fm web service, if you choose to use Last.fm.
</para>
<sect3 id="manual-syncing"><title>Manual Syncing</title> 
<para>At any time, you can start manual synchronization from <menuchoice><guimenu>Tools</guimenu><guimenuitem>Synchronize Statistics...</guimenuitem></menuchoice>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-statsyncing.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>From here, you can start a synchronization between the collections you select here, which will default to what you have configured in the &amarok; <link linkend="metadata">Metadata</link> configuration.
</para>
<sect4 id="conflicts-and-syncing-statistics-dialog"><title>Conflicts and Syncing Statistics Dialog</title> 
<para>When syncing, &amarok; will show a dialog window which states the conflicts and statistics of the syncing that has recently been in progress. In this window you will be able to see three tabs: <guilabel>Matched Tracks</guilabel>, <guilabel>Unique Tracks</guilabel> and <guilabel>Excluded Tracks</guilabel>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="matchedtrackspage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<variablelist>
  <varlistentry><term><emphasis role="bold">Matched Tracks</emphasis></term>
    <listitem>
    <para>This tab will show all the tracks that &amarok; has found in more than one collection, and reflects conflicts. When tracks are grouped, you can see two types of background: light green, and light red. A light green background indicates the new or updated field, whilst a light red background will indicate the old/overwritten field. You do not need to solve all conflicts listed here; the particular field of the listed tracks are not going to be synced if you do not resolve the conflict.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Unique Tracks</emphasis></term>
    <listitem>
    <para>These are tracks found in only one collection. You can use it as a <emphasis>difference view</emphasis>. Track dragging is supported here.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Excluded Tracks</emphasis></term>
    <listitem>
    <para>These are tracks that are not synced because of different reasons, such as identical metadata, so as not cause to disorder in the database.</para>
     </listitem>
  </varlistentry>
</variablelist>
</sect4>
</sect3>
<sect3 id="synchronizing-with-last-fm"><title>Synchronizing with Last.fm</title> 
<para>If you have the Last.fm plugin enabled and configured correctly with your Last.fm account, you can choose to also synchronize your &amarok; play counts, ratings and labels with your Last.fm Library. The sync takes some time, but you may continue using &amarok; while it is syncing. Please note that Unattended Synchronization (which will be explained later on) is not possible with Last.fm, and synchronization from Last.fm to &amarok; needs to be initiated manually.
</para>
<sect4 id="spelling-auto-correction"><title>Spelling Auto-Correction</title> 
<para>Last.fm enables by default a feature that will auto-correct common misspelling during the sync. It can happen that even if you scrobble many track plays, it does not show up in Matched Tracks as Last.fm knows the track under a slightly different name.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="last-fm-spelling-correction.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>You can disable this feature on the Last.fm site, and changes will be applied also to your past scrobbles. You have two options:
</para>
<variablelist>
  <varlistentry><term><emphasis role="bold">Off</emphasis></term>
    <listitem>
    <para>Tracks are matched properly, but if you change your tags after some time, your play-count will be split in two tracks.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">On</emphasis></term>
    <listitem>
    <para>You can play-count the tracks even if tags are changed after some time, but you will have to use Last.fm preferred spelling.</para>
     </listitem>
  </varlistentry>
</variablelist>
</sect4>
</sect3>
<sect3 id="unattended-syncing"><title>Unattended Syncing</title> 
<para><important><para>Please note the dialog will only appear in the case of iPods.</para></important>
</para>
<para>When you connect a device that is able to sync with your collections, a pop-up like this will appear.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="ipod-connected-dialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>For unattended syncing to start, you only need to click <guilabel>Yes</guilabel> in the pop-up. &amarok; will work  in the background, so the metadata in your device including ratings, first/last played times, play counts and labels will be synced with other collections <link linkend="metadata">configured to participate in the synchronization</link>, and tracks recently played on the device will be scrobbled to Last.fm, if it is enabled. The process will not ask for user interaction unless any conflict is found in the middle.
</para>
</sect3>
</sect2>
<sect2 id="remote-collections"><title>Remote Collections</title> 
<para>Often it is very useful to share your media files across the network, especially if you want to use it on different computers. This can be done in different ways:
</para>
<itemizedlist>
<listitem><para><link linkend="ampache">Ampache</link>&nbsp;</para></listitem>
<listitem><para><link linkend="digital-audio-access-protocol-daap">DAAP</link>&nbsp;</para></listitem>
<listitem><para><link linkend="samba">Samba</link>&nbsp;</para></listitem>
<listitem><para><link linkend="universal-plug-and-play-upnp---dlna">UPnP</link></para></listitem>
</itemizedlist>
<sect3 id="ampache"><title>Ampache</title> 
<para>&amarok; is able to play music from an <guilabel>Ampache</guilabel> media server. If you want to install a server, see <ulink url="https://github.com/ampache/ampache/wiki/Installation">here</ulink> for more information.
</para>
</sect3>
<sect3 id="ampache-client"><title>Ampache Client</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogplugins.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Activate the <guilabel>Ampache</guilabel> service using <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Plugins</guimenuitem></menuchoice>. Click on the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-configure.png" format="PNG"/> </imageobject> </inlinemediaobject> icon to open the configuration dialog.
</para>
<para>Select <guilabel>Add Server</guilabel>:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="remotecollections_ampache_client1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Configure the service with the data entered on the server:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_ampache_client2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Now the <guilabel>Ampache</guilabel> service should appear in <menuchoice><guimenu>Media Sources</guimenu><guimenuitem>Internet</guimenuitem></menuchoice>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="remotecollections_ampache_client2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="digital-audio-access-protocol-daap"><title>Digital Audio Access Protocol (DAAP)</title> 
<para>DAAP is a protocol to share media over a network. It was first used for the <guilabel>iTunes</guilabel> music player, but is used widely now. The current state is that the DAAP-plugin won't work with a recent iTunes, the Firefly media server is known to work.
</para>
</sect3>
<sect3 id="client"><title>Client</title> 
<para>&amarok; will show the tracks from the server in the <menuchoice><guimenu>Media Sources</guimenu><guimenuitem>Local Music</guimenuitem></menuchoice> pane if you enable the DAAP Collection in <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Configure Plugins</guimenuitem><guimenuitem>Collections</guimenuitem></menuchoice>. If the collection is not showing up, click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-view-list-tree.png" format="PNG"/> </imageobject> </inlinemediaobject> icon to be sure you are not in Merged View.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="remotecollections_daap.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="samba"><title>Samba</title> 
<para><guilabel>Samba</guilabel> is a free implementation of the <emphasis>SMB/CIFS</emphasis> protocol which is used to share files and printers in a network. Most modern file managers like &dolphin; and <guilabel>Nautilus</guilabel> support this protocol.
</para>
</sect3>
<sect3 id="client6"><title>Client</title> 
<para>You need to mount the share to use it in &amarok;. To do this, you need to install the package <emphasis>smbfs</emphasis>. Use the command
</para>
<para><userinput>sudo mount -t cifs //<guilabel>host</guilabel>/<guilabel>share</guilabel> <guilabel>/mount-point/</guilabel></userinput>
</para>
<para>to mount the share. After that you can use it like a local folder and add it to your local collection.
</para>
</sect3>
<sect3 id="server"><title>Server</title> 
<para>The easiest way is to use your file manager. On <guilabel>Debian</guilabel>-based distributions like &ubuntu; you can install a &dolphin; extension to manage shares using
</para>
<para><userinput>sudo apt-get install kdenetwork-filesharing</userinput>
</para>
<para>Open the properties of a folder in &dolphin; and switch to the <guilabel>Share</guilabel> tab.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_remotecollections_samba_server.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>To share the folder, just check the <guilabel>Share with Samba (Microsoft Windows)</guilabel> field and set the share name under the <guilabel>Name</guilabel> field. Check the <guilabel>Allow Guests</guilabel> checkbox to allow anonymous users access to the folder.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_remotecollections_samba_server1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The folder should now be accessible to the network. Please see the <link linkend="client">Client section</link> for details on how to use it in &amarok;.
</para>
</sect3>
<sect3 id="universal-plug-and-play-upnp---dlna"><title>Universal Plug and Play (UPnP) / DLNA</title> 
<para><emphasis>UPnP</emphasis> is a set of protocols to share media on the network. It is also supported by a wide range of residential gateways and Network Attached Storage devices. UPnP support is now commonly marketed as <ulink url="http://en.wikipedia.org/wiki/DLNA">DLNA</ulink>.
</para>
<para>&amarok; has a built-in UPnP media share client so it can play tracks shared on the network. To enable it, use <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Plugins</guimenuitem><guimenuitem>Collections</guimenuitem></menuchoice> and check the box by the <guilabel>UPnP Collection</guilabel> plugin.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_upnp_collection_plugin.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>When a media share is discovered it will be shown in <guilabel>Local Music</guilabel>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_upnp_collection.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The UPnP feature depends on <guilabel>KDE's</guilabel> UPnP media server support. As of now (2015) there is no working UPnP kio-slave available.
</para>
</sect3>
</sect2>
<sect2 id="external-database"><title>External Database</title> 
<para>&amarok; 2.2 and above support an external <guilabel>MySQL</guilabel> database as a backend.
</para>

<!-- empty sect3
<sect3 id="configure-server"><title>Configure Server</title> 
</sect3
-->
<sect3 id="install-mysql-server"><title>Install MySQL-Server</title> 
<para>First you need to install an <guilabel>MySQL</guilabel> server. On Debian-based distributions like Ubuntu you can use
</para>
<para><userinput>sudo apt-get install mysql-server mysql-client</userinput>
</para>
<para>to install it. You will be asked to specify a password for the root-account for the database. The <emphasis>mysql-client</emphasis> package is needed in order to execute some of the commands in this document, but it's not fundamental to the use of &amarok;.
</para>
</sect3>
<sect3 id="configure-database"><title>Configure Database</title> 
<para>Connect to the local database using
</para>
<para><userinput>mysql -u root -p</userinput>
</para>
<para>You will be prompted for the password for <guilabel>MySQL's</guilabel> <emphasis>root</emphasis> user. You will get the <screen>mysql&gt;</screen> prompt.
</para>
<para>Create a new user <replaceable>amarokuser</replaceable> with the password <replaceable>amarokpass</replaceable> using the
</para>
<para><userinput>CREATE USER <guilabel>'amarokuser'</guilabel>@<guilabel>'localhost'</guilabel> IDENTIFIED BY <guilabel>'amarokpass'</guilabel>;</userinput>
</para>
<para>command. Amarok needs its own database, which is created with
</para>
<para><userinput>CREATE DATABASE <guilabel>amarokdb</guilabel>;</userinput>
</para>
<para>Give the new user access to the database by entering the
</para>
<para><userinput>GRANT ALL ON <guilabel>amarokdb</guilabel>.* TO <guilabel>'amarokuser'</guilabel>@<guilabel>'%'</guilabel> IDENTIFIED BY <guilabel>'amarokpass'</guilabel>;</userinput>
</para>
<para>command, where <emphasis>%</emphasis> is a wildcard to allow all hosts to connect to the database. Now use the
</para>
<para><userinput>FLUSH PRIVILEGES;</userinput>
</para>
<para>statement to reload various internal caches used by <guilabel>MySQL</guilabel>. Finally
</para>
<para><userinput>exit</userinput>
</para>
<para>closes the <guilabel>MySQL</guilabel> prompt.
</para>
<para>By default the server can only be accessed by the local host. To change this you need to edit the file <filename>/etc/mysql/my.cnf</filename> and adjust the address near <emphasis>bind-address</emphasis> to the one your server listens on the network. <guilabel>0.0.0.0</guilabel> listens on all interfaces. After that you need to restart the server using
</para>
<para><userinput>sudo service mysql restart</userinput>
</para>
</sect3>
<sect3 id="configure-client"><title>Configure Client</title> 
<para>Open the configuration dialog by clicking <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Database</guimenuitem></menuchoice>. Enable the checkbox and enter the user data.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogdatabaseenabled.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>You need to restart &amarok; so that the changes take effect.
</para>
</sect3>
<sect3 id="migrating-from-mysql-embedded-to-mysql-server"><title>Migrating from MySQL Embedded to MySQL Server</title> 
<para>If you want to maintain the statistics, &etc; that you have in the embedded <guilabel>MySQL</guilabel> database from before &amarok; 2.2, you can do the following:
</para>
<para>First, start &amarok; 2.2+ at least once to give the database a chance to update to the latest schema version.
</para>
<para>Next, kill the running <guilabel>MySQL</guilabel> service
</para>
<para><userinput>sudo /etc/init.d/mysql stop</userinput>
</para>
<para>and start a <guilabel>MySQL</guilabel> daemon from your <filename>~/.kde4/share/apps/amarok</filename> directory (--defaults-file MUST be the first option!):
</para>
<para><userinput>/usr/sbin/mysqld --defaults-file=`pwd`/my.cnf --default-storage-engine=MyISAM --datadir=`pwd`/mysqle --socket=`pwd`/sock --skip-grant-tables</userinput>
</para>
<para>The skip-grant-tables means you can use any password or username to connect to it. 'localhost' will not work, the <guilabel>MySQL</guilabel> client will try to use a <guilabel>&UNIX;</guilabel> socket. Using <guilabel>127.0.0.1</guilabel> as the host makes it work. Some systems may restrict this access through apparmor or SE&Linux;. They can be temporarily disabled with
</para>
<para><userinput>sudo /etc/init.d/apparmor stop</userinput>
</para>
<para>Now, run mysqldump, passing in the -S option to specify the local socket.  This will dump your old embedded DB out to a SQL file.
</para>
<para><userinput>mysqldump -S sock amarok &gt; amarok.mysql</userinput>
</para>
<para>You can then restart your <guilabel>MySQL</guilabel> service and load this SQL file into your <guilabel>MySQL</guilabel> server. You'll have needed to already run the GRANT statement above and create an &amarok; database (<quote>CREATE DATABASE amarok;</quote>):
</para>
<para><userinput>sudo /etc/init.d/mysql stop
mysql -u amarokuser -p amarok &lt; amarok.mysql</userinput> 
</para>
<para><note><para>You may need to re-scan your collection in &amarok; after completing this.</para></note>
</para>
</sect3>
</sect2>
<sect2 id="working-with-media-devices"><title>Working with Media Devices</title> 
<para>Use &amarok; to play music from media devices such as MTP devices, iPods, and generic USB devices.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_media_devices.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect3 id="connecting-media-devices"><title>Connecting Media Devices</title> 
<para>Connect your media device using the USB cable. The device notifier applet in &kde; will automatically pop up with a list of all available media devices. Click on the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-emblem-mounted.png" format="PNG"/> </imageobject> </inlinemediaobject> icon to access your device.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_connecting_media_devices.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="play-music-from-the-media-device"><title>Play Music from the Media Device</title> 
<para>Or just wait until your device shows up in &amarok;, which will take anywhere from a few seconds to a minute or more, to scan the device for music tracks. Until then the vfat volume will show 0  tracks.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_loading_media_devices.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>After the scan, &amarok; will display all the music tracks available in the Media Device, which you can then move to the <guilabel>Playlist</guilabel> to play them, or copy or move to your <guilabel>Local Collection</guilabel>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_tracks_media_devices1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="managing-the-media"><title>Managing the Media</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-managing-media.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Add to playlist</guilabel></para>
    </entry>
    <entry>
    <para>Adds all the selected tracks from the media device to the current &amarok; playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Replace the playlist</guilabel></para>
    </entry>
    <entry>
    <para>Clears the current &amarok; playlist and adds instead all the selected tracks from the media device.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Configure Device</guilabel></para>
    </entry>
    <entry>
    <para>Opens a dialog box to edit configuration options for the device.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Disconnect Device</guilabel></para>
    </entry>
    <entry>
    <para>Disconnects the device from the computer.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Copy to collection</guilabel></para>
    </entry>
    <entry>
    <para>Copy all the selected tracks to the Local collection or to any other media devices connected.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Move to collection</guilabel></para>
    </entry>
    <entry>
    <para>Move all the selected tracks to the Local collection or to any other media devices connected.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Move to trash</guilabel></para>
    </entry>
    <entry>
    <para>Moves all the selected tracks from the media device to the trash.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Delete tracks</guilabel></para>
    </entry>
    <entry>
    <para>Deletes all the selected tracks from the media device.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Organize Files</guilabel></para>
    </entry>
    <entry>
    <para>Organizes tracks based on the configuration for the device.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Edit track details</guilabel></para>
    </entry>
    <entry>
    <para>Opens a dialog box to edit details of the selected tracks from the media device.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="troubleshooting-media-device-support"><title>Troubleshooting Media Device support</title> 
<para>As of Amarok 2.8, the following devices should work with Amarok:
</para>
<itemizedlist>
<listitem><para>Generic Media Players connected through the UMS protocol.</para></listitem>
<listitem><para>iPods/iPhones, depending on their support by the libgpod library. The status depends on the version of this library installed on your system, please refer to <ulink url="http://www.gtkpod.org/wiki/Home">the libgpod support listing</ulink> on their homepage.</para></listitem>
<listitem><para>limited support for devices using the MTP protocol, the support for new Android devices is currently implemented for the next Amarok version.</para></listitem>
</itemizedlist>
</sect3>
</sect2>
</sect1>
<sect1 id="cover-manager"><title>Cover Manager</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_cover_manager.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The <guilabel>Cover Manager</guilabel> is a tool to manage the cover art images of your collection. It allows you to change covers easily, fetch all missing covers and browse them. You can find <guilabel>Cover Manager</guilabel> in <menuchoice><guimenu>Tools</guimenu><guimenuitem>Cover Manager</guimenuitem></menuchoice>.
</para>
<para>When scanning the local music library, &amarok; tries to find corresponding covers for albums. At this point, &amarok; only searches them from the file system, not from the Internet. If none are found in your files, &amarok; uses a placeholder image like this for the album cover: 
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="nocover_amarok.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If an album is missing a cover or the current one is incorrect, you can fetch one from the Internet with <guilabel>Cover Manager</guilabel>.
</para>
<sect2 id="browsing-covers"><title>Browsing Covers</title> 
<para>With <guilabel>Cover Manager</guilabel>, browsing covers is easy. You can view covers for any artist by selecting from list on left, or use the search box to find the right album. On the status bar, you can see how many covers are currently listed and how many albums are missing covers. You can also set the <guilabel>Cover Manager</guilabel> to only show albums with or without covers. By right-clicking on cover art and selecting <guilabel>Display Cover</guilabel> you can view the cover image at the original size.
</para>
</sect2>
<sect2 id="fetching-missing-covers"><title>Fetching Missing Covers</title> 
<para>If there are albums with missing covers, you can try to automatically fetch them all from the Internet. Just select <guilabel>Fetch Missing Covers</guilabel> from the top of the window and <emphasis>Cover Manager</emphasis> will try to find covers. If there are many albums missing covers, the process may take some time.
</para>
</sect2>
<sect2 id="changing-cover-art"><title>Changing Cover Art</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_cover_manager_newcover.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If there is an album with an incorrect cover, you can fetch new one from the Internet. Right-click on the cover and select <guilabel>Fetch Cover</guilabel>. A dialog window for finding a new cover will open. &amarok; automatically tries find the correct album art by searching with the artist name and album name. Usually this works very well, as with the example, and you will most likely see a correct cover on results as in the example. If no correct cover is found, you can try to enter a custom search phrase or change the source of images by clicking on <guilabel>Configure...</guilabel> You can select where to search, including Last.fm, Google Images, Yahoo! Image Search or Discogs. After finding a cover for album, just click <guilabel>OK</guilabel> and the changes will be applied.
</para>
<para>You can also use a image from your hard drive as an album cover. If you want to store the image in the Album folder, name it <filename>cover.jpg</filename> or <filename>cover.png</filename> for best results. As before, right-click on the incorrect image and click on <guilabel>Set Custom Cover</guilabel>.
</para>
<para>If you don't like the cover art at all, you can unset it by right-clicking on the image and selecting <guilabel>Unset Cover</guilabel>.
</para>
<para><tip><para>You can find this menu without <guilabel>Cover Manager</guilabel> too. Just right-click on the album or song from your playlist or collection and hover the <guilabel>Album</guilabel> item.</para></tip>
</para>
</sect2>
</sect1>
<sect1 id="tag-editor"><title>Tag Editor</title> 
<para>The built-in <emphasis>Tag Editor</emphasis> allows to show and change meta data of music files. To open the editor just right-click on one or more selected songs, albums, or genres, in either your collection or your playlist, click on <guilabel>Edit Track Details</guilabel> and choose the <guilabel>Tags</guilabel> tab.
</para>
<sect2 id="edit-tags-manually"><title>Edit Tags Manually</title> 
<para>Change the proper line to the required value and click <guilabel>Save &amp; Close</guilabel>. Clicking <guilabel>Cancel</guilabel> discards all unsaved changes.
</para>
<sect3 id="tags7"><title>Tags</title> 
<para>Tags are metadata such as the track number or the artist of the track contained in the file. A very common kind of tag is the <emphasis>ID3 tag</emphasis>.
</para>
<para>Here is a list of tags supported by &amarok;:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Tag</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Title</guilabel></para>
    </entry>
    <entry>
    <para>The title of the track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Artist</guilabel></para>
    </entry>
    <entry>
    <para>The artist or band of the track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Composer</guilabel></para>
    </entry>
    <entry>
    <para>The composer of the track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Album Artist</guilabel></para>
    </entry>
    <entry>
    <para>The artist or band of the album.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Album</guilabel></para>
    </entry>
    <entry>
    <para>The album title.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Disc Number</guilabel></para>
    </entry>
    <entry>
    <para>The disc number of the album; important in a multi-CD album.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Genre</guilabel></para>
    </entry>
    <entry>
    <para>The genre of the track. This can be a custom genre, but usually one of the predefined ones is used.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Beats Per Minute</guilabel></para>
    </entry>
    <entry>
    <para>The tempo of the track.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Track</guilabel></para>
    </entry>
    <entry>
    <para>The number of the track on the album.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Year</guilabel></para>
    </entry>
    <entry>
    <para>The year in which the track or album was published.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Comment</guilabel></para>
    </entry>
    <entry>
    <para>A text comment for the track.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="edit-single-track"><title>Edit Single Track</title> 
<para>In this mode you can change all supported tags of the chosen file.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4-1tageditdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="edit-several-tracks"><title>Edit Several Tracks</title> 
<para>Several tracks can be selected by clicking on the artist, album, or genre in the your collection or by selecting several tracks in the playlist using the &Ctrl; (non-sequential) or &Shift; (sequential) key.
</para>
</sect3>
<sect3 id="all-at-once"><title>All At Once</title> 
<para>More general tags can be set for a group of tags at once. It works just like the single-track-mode, but the title and track number tags are locked.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4-1albumtageditdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="track-by-track"><title>Track By Track</title> 
<para>This mode is pretty similar to the single-track-mode, except for the ability to switch between the selected tracks using the <guilabel>Next</guilabel> and <guilabel>Previous</guilabel> buttons. It is activated by clicking on the checkbox <guilabel>Per Track</guilabel> on the bottom of the window.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4-1albumtageditpertrackdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="get-tags-from-musicbrainz"><title>Get Tags from MusicBrainz</title> 
<para>&amarok; 2.8 has the ability to guess tags from the <guilabel>MusicBrainz</guilabel> database. Click the <guilabel>Get Tags from MusicBrainz</guilabel>, wait a moment for the database to be searched for matches, and then <guilabel>Update Tags</guilabel>, or <guilabel>Cancel</guilabel>.
</para>
<para>If you have the packages <emphasis>libofa</emphasis> and <emphasis>ffmpeg</emphasis> installed, and &amarok; is compiled with them, <guilabel>Musicbrainz</guilabel> will be able to use <quote>fingerprinting</quote> (the <emphasis>MusicDNS</emphasis> service) to search for albums and tracks without good filenames or existing tags.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4musicbrainztagger.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>MusicBrainz Tagger dialog</phrase>
    </textobject>
    <caption>
      <para>MusicBrainz Tagger dialog</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="guess-tags-from-filename"><title>Guess Tags From Filename</title> 
<para>It is also possible to tag tracks using information in the filename. This is a very convenient feature when dealing with lots of files with a consistent naming scheme.
</para>
<para>Some tracks need to be edited manually, because special characters like single quotes are omitted in file names. A preview helps to create the correct pattern.
</para>
<sect3 id="options"><title>Options</title> 
<para>There are also several options to format the result. These are self-explanatory.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4-1filenamelayoutchooseroptions.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="basic"><title>Basic</title> 
<para>In the basic view you get a drag-and-drop menu to create the pattern in the filename.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tagedit_fromfile_basic.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="example"><title>Example</title> 
<para>Filename: 01-The Beatles-Hey Jude.mp3
</para>
<para>Tracknumber: 01
</para>
<para>Artist: The Beatles
</para>
<para>Title: Hey Jude
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tagedit_fromfile_basic_example.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="advanced"><title>Advanced</title> 
<para>In the advanced view you can create a pattern using markers in a string.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tagedit_fromfile_advanced.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="example8"><title>Example</title> 
<para>Filename: 01-The Beatles-Hey Jude.mp3
</para>
<para>Tracknumber: 01
</para>
<para>Artist: The Beatles
</para>
<para>Title: Hey Jude
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tagedit_fromfile_advanced_example.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="transcoding"><title>Transcoding</title> 
<para><guilabel>Transcoding</guilabel> allows you to encode media files to a variety of formats while copying or moving them to a collection (<guilabel>Local Collection</guilabel>, USB <guilabel>Universal Mass Storage Collection</guilabel> and <guilabel>iPod, iPad &amp; iPhone Collection</guilabel> support transcoding as of &amarok; 2.8). A word of warning: be careful when you use this feature, as you are working with actual files on your hard drive. Have a backup!
</para>
<sect2 id="interface"><title>Interface</title> 
<para>The <emphasis>Transcoding</emphasis> dialog will appear whenever you copy or move tracks to one of the collections that support transcoding. You can also transcode tracks within the <emphasis>Local Collection</emphasis> by using the <guilabel>Organize files</guilabel> functionality.
</para>
</sect2>
<sect2 id="transcode-tracks-dialog"><title>Transcode Tracks Dialog</title> 
<para>If you choose to copy or move files to a supported collection, the following dialog will pop up:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_organizefilestranscode.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Copy</guilabel></para>
    </entry>
    <entry>
    <para>Selected media files will be copied to your collection without re-encoding.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Encoder list</para>
    </entry>
    <entry>
    <para>List of all your installed codecs; choose among them to be able to transcode. If this list is empty, you need to install <emphasis>FFmpeg</emphasis>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Transcode all tracks</guilabel></para>
    </entry>
    <entry>
    <para>Transcode every selected track to the chosen codec</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Transcode only when needed for playability</guilabel></para>
    </entry>
    <entry>
    <para>Only transcode tracks which need to be transcoded to play in the destination system</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Transcode only if source and destination formats are different</guilabel></para>
    </entry>
    <entry>
    <para>Transcode only if source and destination file formats are different</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Remember this choice for the next time</guilabel></para>
    </entry>
    <entry>
    <para>Save the preference for the <guilabel>current destination collection</guilabel>. This includes the copy/transcode preference and transcoding parameters.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Cancel</guilabel></para>
    </entry>
    <entry>
    <para>Exits the <guilabel>Transcode Tracks</guilabel> dialog.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="custom-encoding"><title>Custom Encoding</title> 
<para>Whether to save space, to make your files readable by a portable music player or a particular software program, &amarok; can handle it. Choose a codec from the list and a custom setting and click <guilabel>Transcode</guilabel>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6flactranscodemenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Transcode</guilabel></para>
    </entry>
    <entry>
    <para>Begins encoding with the selected codecs and parameters. In case of the <guilabel>Local Collection</guilabel> the <guilabel>Organize tracks</guilabel> dialog will pop up. <link linkend="contents">More about Organize tracks</link>.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Cancel</guilabel></para>
    </entry>
    <entry>
    <para>Exits the <guilabel>Transcode Tracks</guilabel> dialog.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="saving-transcoding-preferences"><title>Saving Transcoding Preferences</title> 
<para>As mentioned in the <guilabel>Remember this choice for the next time</guilabel> description, &amarok; can remember transcoding preference per each of your collections. The preference can be changed any time in the <guilabel>Configure Local Collection</guilabel> <guilabel>Configure Amarok</guilabel> dialog page for the <guilabel>Local Collection</guilabel> and in the configure dialogs of <guilabel>iPod, iPad &amp; iPhone</guilabel> and <guilabel>Universal Mass Storage</guilabel> collections.
</para>
</sect2>
<sect2 id="pro-tip--strip-audio-out-of-video-files"><title>Pro Tip: Strip Audio out of Video Files</title> 
<para>&amarok;'s transcoding capabilities can be used to extract audio from video files while copying or moving them into a collection. Just select video file(s) in Amarok embedded file browser, right-click and choose <guilabel>Copy to Collection</guilabel>. Standard <guilabel>Transcode Tracks</guilabel> dialog will appear. Choose one of the encoders, hit <guilabel>Transcode</guilabel> and transcoding will begin.
</para>
</sect2>
</sect1>
<sect1 id="script-manager"><title>Script Manager</title> 
<para>The <guilabel>Script Manager</guilabel> contains the options required to extend the functionality of &amarok; through custom scripts. It  is reached from the <guilabel>Settings</guilabel> menu, <menuchoice><guimenu>Configure Amarok</guimenu><guimenuitem>Scripts</guimenuitem></menuchoice>. Scripts can be installed from downloaded script packages, or from the <guilabel>Manage Scripts</guilabel> button which can fetch and install the latest user-contributed scripts from the Internet.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_configurationdialogscripts.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Please refer to <link linkend="scripts">Configuring Amarok -&gt; Scripts</link> for more information.
</para>
</sect1>
</chapter>
<chapter id="playlist9"><title>Playlist</title> 
<para>The <emphasis>Playlist</emphasis> is a powerful part of &amarok;. One can drag in some tracks, but there is a lot more available.
</para>
<itemizedlist>
<listitem><para><link linkend="saved-playlists">Saved Playlists</link>&nbsp;</para></listitem>
<listitem><para><link linkend="playlist-filtering">Playlist Filtering</link>&nbsp;</para></listitem>
<listitem><para><link linkend="queue-manager">Queue Manager</link>&nbsp;</para></listitem>
<listitem><para><link linkend="dynamic-playlists">Dynamic Playlists</link>&nbsp;</para></listitem>
<listitem><para><link linkend="automatic-playlist-generator">Automatic Playlist Generator</link>&nbsp;</para></listitem>
</itemizedlist>
<sect1 id="saved-playlists"><title>Saved Playlists</title> 
<para><emphasis>Saved playlist</emphasis> is a traditional type of playlist. Saved playlists work like &amarok;'s current playlist, saved in the &amarok; database or your file system for later use. It can be fun to use them at events when you have specific songs you want played.
</para>
<para>Creating a saved playlist is very easy with the exact songs and order that you want. For every day use, sometimes it is faster to use <link linkend="dynamic-playlists">Dynamic Playlists</link> or the <link linkend="automatic-playlist-generator">Automatic Playlist Generator</link> when you have less specific needs for specific tracks and progression.
</para>
<para>To browse and manage your saved playlists, go to <menuchoice><guimenu>Playlists</guimenu><guimenuitem>Saved Playlists</guimenuitem></menuchoice> on the menubar.
</para>
<sect2 id="managing-saved-playlists"><title>Managing saved playlists</title> 
<sect3 id="saving-a-playlist"><title>Saving a Playlist</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_saved_playlists.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>You can save your current playlist into the &amarok; database by clicking the save icon (<inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-save.png" format="PNG"/> </imageobject> </inlinemediaobject>) at the bottom of the <guilabel>Playlist</guilabel> view. You can browse playlists in the &amarok; database by going to <menuchoice><guimenu>Playlists</guimenu><guimenuitem>Saved Playlists</guimenuitem></menuchoice> in the <guilabel>Media Sources</guilabel> pane and expanding the <guilabel>Amarok database</guilabel> section. You will find them in your filesystem here: <filename>~/.kde(4)/share/apps/amarok/playlists</filename>.
</para>
</sect3>
<sect3 id="exporting-a-playlist"><title>Exporting a Playlist</title> 
<para>You can export your current playlist to your file system by clicking <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Export Playlist As...</guimenuitem></menuchoice> from the top menubar. From the opening save dialog, you can change the name, location and type of the playlist. Then just click on <guilabel>Save</guilabel>. Remember, playlist files don't contain any music data. If you want to listen the content of the playlist on another computer, you'll need to bring your music with you unless that computer already has the tracks.
</para>
</sect3>
<sect3 id="importing-a-playlist"><title>Importing a Playlist</title> 
<para>You can import a playlist file into &amarok; just by copying it to any directory that &amarok; knows as part of your music collection. When &amarok; detects a new playlist on any folder of your collection, it will add it to the <guilabel>Playlist Files on Disk</guilabel> section of <menuchoice><guimenu>Playlists</guimenu><guimenuitem>Saved Playlists</guimenuitem></menuchoice> in the <guilabel>Media Sources</guilabel> pane. If the playlist doesn't appear right away, you can update the collection manually by clicking <menuchoice><guimenu>Tools</guimenu><guimenuitem>Update Collection</guimenuitem></menuchoice>. If instead of importing the playlist, you want to just listen it, open it with <menuchoice><guimenu>Amarok</guimenu><guimenuitem>Play Media...</guimenuitem></menuchoice> from menubar. Selected playlist will be added to the current playlist.
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="playlist-filtering"><title>Playlist Filtering</title> 
<para>The <emphasis>Search playlist</emphasis> function in &amarok; is very powerful, as it allows you to search for different tracks by various constraints. The search results limits what you can actually see, which makes it easy to queue up wanted tracks, or remove them from the playlist.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4searchplaylist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect2 id="edit-box10"><title>Edit Box</title> 
<para>When you type something in the <guilabel>Search playlist</guilabel> field, &amarok; will search in your playlist and mark matching tracks, artists and so forth.
</para>
<sect3 id="examples11"><title>Examples</title> 
<para>The first track that matches the current search will be highlighted as in this example:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_search_ex.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="search-preferences"><title>Search Preferences</title> 
<para>This is a small drop down menu with options for the search field, if you need more than simple search. You can choose which types of searching you want to use in your <guilabel>Search playlist</guilabel>. Check the boxes according to what you need for your search.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_playlistfilteroptions.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect3 id="check-boxes"><title>Check boxes</title> 
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Name</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Tracks</guilabel></para>
    </entry>
    <entry>
    <para>&amarok; will search for text from tag: Track Titles</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Albums</guilabel></para>
    </entry>
    <entry>
    <para>Search for text from tag: Album titles</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Artists</guilabel></para>
    </entry>
    <entry>
    <para>Search for text from tag: Artist</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Genre</guilabel></para>
    </entry>
    <entry>
    <para>Search for text from tag: Genre</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Composers</guilabel></para>
    </entry>
    <entry>
    <para>Search for text from tag: Composer</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Rating</guilabel></para>
    </entry>
    <entry>
    <para>Search the rating of all songs in your playlist</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Years</guilabel></para>
    </entry>
    <entry>
    <para>Search for year of publication</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show only matches</guilabel></para>
    </entry>
    <entry>
    <para>When this box is marked &amarok; will display only the tracks that match the current search</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="show-only-matches---example"><title>Show only matches - example</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_show_only_matches.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="queue-manager"><title>Queue Manager</title> 
<para>Tracks are loaded in the <guilabel>Playlist</guilabel>. In normal track progression, when a song is over, the next one played is the one below the just-played one. The <emphasis>Queue</emphasis> is one way to change the order in which the songs are played.
</para>
<sect2 id="how-to-create-a-queue"><title>How to Create a Queue</title> 
<para>It is very easy to make a Queue; just select one or more tracks and move in the center of &amarok;, to the <emphasis>Pop-Up Dropper</emphasis> (PUD), or right-click and scroll to <guilabel>Queue Track</guilabel>.
</para>
<para>As you select or add songs to the Queue each of them takes a number. The number indicates the order in which songs will play.
</para>
<sect3 id="example12"><title>Example</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistpic.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>First, select the track</phrase>
    </textobject>
    <caption>
      <para>First, select the track</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistqueue.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Then right-click for context menu</phrase>
    </textobject>
    <caption>
      <para>Then right-click for context menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="queue.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Or queue track by dragging to the PUD</phrase>
    </textobject>
    <caption>
      <para>Or queue track by dragging to the PUD</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="queueend.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Queued tracks in playlist</phrase>
    </textobject>
    <caption>
      <para>Queued tracks in playlist</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="how-to-edit-the-queue"><title>How to Edit the Queue</title> 
<para>If you want to make any changes in the <emphasis>Queue</emphasis> you can use the <guilabel>Queue Editor</guilabel>. Start the <guilabel>Queue Editor</guilabel> from the menu in <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Edit Queue</guimenuitem></menuchoice>.
</para>
<sect3 id="queue-editor"><title>Queue Editor</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-4queueeditor.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Button</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-up.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Move selected track ahead in the list.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-down.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Move selected track below in the list.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-list-remove.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Remove selected song from the Queue.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-clear-list.png" format="PNG"/> </imageobject> </inlinemediaobject></para>
    </entry>
    <entry>
    <para>Remove all songs from the Queue.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="dynamic-playlists"><title>Dynamic Playlists</title> 
<para>Some media players are designed to load the entire collection of music in a single playlist, then play it in random order, or search/ sorted, then queued. With a larger collection, this way of managing your playlist isn't efficient. &amarok;'s <guilabel>Dynamic Playlist</guilabel> is a better way to explore your music.
</para>
<para>The <guilabel>Dynamic Playlist</guilabel> is reached from <menuchoice><guimenu>Playlists</guimenu><guimenuitem>Dynamic Playlists</guimenuitem></menuchoice> in the <guilabel>Media Sources</guilabel> pane.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-newdynamic-detail.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<sect2 id="how-the-dynamic-playlist-works"><title>How the Dynamic Playlist works</title> 
<para>The dynamic playlist is a list that grows while you listen to your music.
</para>
<para>It will keep a certain number of songs in front of the currently played song and it will clean up the playlist by removing old songs.
</para>
<para>The songs that will be added to the front of the playlist are determined by the currently selected dynamic playlist.
</para>
</sect2>
<sect2 id="using-a-dynamic-playlist"><title>Using a Dynamic Playlist</title> 
<para>To enable dynamic playlists, click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-action-dynamic-amarok.png" format="PNG"/> </imageobject> </inlinemediaobject> button in the <guilabel>Dynamic Playlist</guilabel> pane. A bar will be displayed at the top of the <guilabel>Playlist</guilabel> pane announcing that it is enabled. Select which dynamic playlist to use from the list of options by double clicking it. The currently selected dynamic playlist is bolded.
</para>
<para>You can adjust the number of songs before and after the currently playing song to be displayed in the playlist with the <guilabel>Previous</guilabel> and <guilabel>Upcoming</guilabel> fields. You can prevent the same track appearing in the current playlist more than once using the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-copy.png" format="PNG"/> </imageobject> </inlinemediaobject> button. The <guilabel>Repopulate</guilabel> button allows you to generate a new set of tracks. This can be used together with a high <guilabel>Upcoming</guilabel> setting to generate fixed playlists for export.
</para>
</sect2>
<sect2 id="defining-dynamic-playlists"><title>Defining Dynamic Playlists</title> 
<para>Each dynamic playlist is built of biases. A bias defines a particular constraint on the behaviour of the dynamic playlist, and new items to be added to the playlist are selected at random from a list of all songs which match the biases. Biases may either be a single bias (&eg; the <emphasis>Search</emphasis> bias) or a grouping of other biases (&eg; the <emphasis>Match All</emphasis> bias). Some examples playlists are included, and you can define a new playlist with the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-new.png" format="PNG"/> </imageobject> </inlinemediaobject> button.
</para>
<para>To change the name of a playlist, either use the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-properties.png" format="PNG"/> </imageobject> </inlinemediaobject> button or right click on it and select <guilabel>Rename playlist</guilabel>. A bias can be edited with the same button or by right-clicking and selecting <guilabel>Edit bias</guilabel>, and for biases which have sub-biases, a new sub-bias can be added by right clicking and selecting <guilabel>Add new bias</guilabel>.
</para>
<sect3 id="biases"><title>Biases</title> 
<para>Because multiple biases may be defined, &amarok; may at times return an empty playlist. This occurs if it is given a set of impossible-to-fulfill conditions. To avoid this and to better understand each available bias, along with any options it takes, please see below:
</para>
<variablelist>
  <varlistentry><term><emphasis role="bold">Search</emphasis></term>
    <listitem>
    <para>This bias matches tracks found by a given search query. It uses the same search string used in the collection browser. You may also use the <guilabel>Match meta tag</guilabel> bias to match tags in the same way as the collection search editor.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Random</emphasis></term>
    <listitem>
    <para>This bias matches any track, entirely at random.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">And</emphasis></term>
    <listitem>
    <para>This group bias matches tracks which match <emphasis>all</emphasis> sub-biases.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Or</emphasis></term>
    <listitem>
    <para>This group bias matches tracks which match <emphasis>any</emphasis> sub-biases.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Partition</emphasis></term>
    <listitem>
    <para>This group bias matches tracks from the sub-biases in proportion. The edit window for this bias has sliders for each sub-bias to adjust the proportions. For example, with two sub-biases with their proportion sliders set equal, half of the playlist will match one bias and half the other.</para>
    <para>Note: The dynamic playlist is internally working with more tracks than you can see, so after clicking <quote>Repopulate</quote> the list might not contain a 50:50 distribution of songs. However as you continue listening to music you will see that in the end it actually matches.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">If Else</emphasis></term>
    <listitem>
    <para>This group bias matches tracks from the first sub bias <emphasis>unless</emphasis> there are no matching tracks found, in which case it matches tracks from the second sub-bias. See the example <guilabel>Album Play</guilabel> playlist for an example of this in use.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Match Meta Tag</emphasis></term>
    <listitem>
    <para>This bias matches tracks which meet certain conditions on a tag. The selection interface is the same as the search filter editor in the collection browser. Select a tag type from the drop-down and fill in the constraint. (Hint: You can use a number of these in an <guilabel>And</guilabel> bias.)</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Album Play</emphasis></term>
    <listitem>
    <para>This bias matches tracks related to the previous item in the playlist by album. You can select the details of the bias from the drop-down menu. For example, <guilabel>Track directly follows previous track in album</guilabel> is used in the example <guilabel>Album Play</guilabel> playlist to ensure full albums are played in order.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Quiz Play</emphasis></term>
    <listitem>
    <para>This bias matches tracks for which the first character of a given tag (title, artist or album) is the same as the last character of the same tag for the previous tag. For example, with artist selected, you could have the following series: Led Zeppeli<guilabel>n</guilabel> -&gt; <guilabel>N</guilabel>ine Inch Nail<guilabel>s</guilabel> -&gt; <guilabel>S</guilabel>antana, &etc;</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">EchoNest similar artist</emphasis></term>
    <listitem>
    <para>This bias matches tracks which are similar according to EchoNest, either to the previous track or to any track in the playlist. This allows you to play a set of consistent tracks simply by adding a single track to the playlist and turning on the dynamic playlist, rather than defining all the match rules yourself.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Last.fm similar</emphasis></term>
    <listitem>
    <para>This bias performs the same function as the EchoNest bias, but uses Last.fm to determine similarity. You can also choose similarity to the previous track or to the previous artist.</para>
     </listitem>
  </varlistentry>
  <varlistentry><term><emphasis role="bold">Last.fm weekly top artist</emphasis></term>
    <listitem>
    <para>This bias matches tracks which are on the weekly charts from Last.fm for a given time period.</para>
     </listitem>
  </varlistentry>
</variablelist>
</sect3>
</sect2>
<sect2 id="a-dynamic-playlist-in-use"><title>A dynamic playlist in use</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-newdynamic.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="using-your-dynamic-playlist"><title>Using your Dynamic Playlist</title> 
<para>To enable the dynamic playlist you have created simply check the <guilabel>On</guilabel> box in the upper-left corner of the pane. To regenerate the entire playlist at any time, click <guilabel>Repopulate</guilabel>, to the right of <guilabel>On</guilabel>.
</para>
<para>The default number of items in the playlist is your 5 previous plays plus 10 upcoming items. With the currently playing track, this makes 16 items in the playlist at any given time. The number of tracks can be changed right below the <guilabel>On</guilabel> checkbox.
</para>
<para>Below that is the dropdown menu for loading saved playlists, the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-save.png" format="PNG"/> </imageobject> </inlinemediaobject> button to save playlists, and the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-delete.png" format="PNG"/> </imageobject> </inlinemediaobject> button to delete them.
</para>
</sect2>
<sect2 id="a-dynamic-playlist-in-use13"><title>A dynamic playlist in use</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_dynamic_playlist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
<sect1 id="automatic-playlist-generator"><title>Automatic Playlist Generator</title> 
<para>The <guilabel>Automated Playlist Generator (APG)</guilabel> automatically generates playlists based on constraints you set. These constraints can be set based on song data (artist, genre, year) or access time (last played). There are also special constraints to determine how &amarok; is going to look for songs. You will find the <emphasis>APG</emphasis> in your <guilabel>Media Sources</guilabel> pane, <menuchoice><guimenu>Playlists</guimenu><guimenuitem>Automated Playlist Generator</guimenuitem></menuchoice>.
</para>
<sect2 id="apg-presets-toolbar"><title>APG Presets Toolbar</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-apg-presets-toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>This is the <guilabel>APG Presets</guilabel> toolbar. From left to right we have the following buttons:
</para>
<itemizedlist>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-list-add.png" format="PNG"/> </imageobject> </inlinemediaobject> Adds a blank preset that can be modified.</para></listitem>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-properties.png" format="PNG"/> </imageobject> </inlinemediaobject> Opens up the <guilabel>APG Preset Editor</guilabel> window to edit the currently selected preset constraints.</para></listitem>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-list-remove.png" format="PNG"/> </imageobject> </inlinemediaobject> Removes the selected preset from the list; can <emphasis>not</emphasis> be undone.</para></listitem>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-import.png" format="PNG"/> </imageobject> </inlinemediaobject> Import a preset from a .xml file. Has the potential to be malformed if edited outside &amarok;; use the constraint tester.</para></listitem>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-export.png" format="PNG"/> </imageobject> </inlinemediaobject> Export the selected preset to a .xml file that can be imported.</para></listitem>
<listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-next.png" format="PNG"/> </imageobject> </inlinemediaobject> Loads <guilabel>APG</guilabel> with the selected preset and automatically generates a playlist.</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="working-with-presets"><title>Working with Presets</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="apgpresetsmatchallgroup.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>APG Preset Editor window</phrase>
    </textobject>
    <caption>
      <para>APG Preset Editor window</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Presets are sets of rules that &amarok; <guilabel>APG</guilabel> will use when generating playlists. These rules are going to be referred to as <emphasis>constraints</emphasis> from now on; every preset is determined by the constraints which create it. Groups of constraints hierarchically and logically organized are called constraint trees.
</para>
<sect3 id="constraints"><title>Constraints</title> 
<para>Constraints are the building blocks of constraint trees. They are simple statements that the <guilabel>APG</guilabel> will use to add songs to the playlist it generates. To add a constraint to the currently selected preset constraint tree click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-properties.png" format="PNG"/> </imageobject> </inlinemediaobject> button in the <guilabel>APG Preset toolbar</guilabel> and click the <guilabel>Add new</guilabel> option on the <guilabel>APG Preset Editor</guilabel> window. Note that this will add the constraint under the selected item (constraint or constraint group).
</para>
<para>Many different kinds of constraints can be added; each works in a different way inside the tree.
</para>
</sect3>
<sect3 id="constraint-types"><title>Constraint Types</title> 
<para>&amarok; <guilabel>APG</guilabel> supports several types of constraints:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Constraint</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Match Tags</guilabel></para>
    </entry>
    <entry>
    <para>The most important constraints, because they can be set to virtually any information regarding the file, including: artist name, album name, genre, year, last played, and score.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Playlist Duration</guilabel></para>
    </entry>
    <entry>
    <para>Set the running time (in HH:MM:SS format) that the playlist should have</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Playlist Length</guilabel></para>
    </entry>
    <entry>
    <para>Determine how many songs should be in the playlist</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Checkpoint</guilabel></para>
    </entry>
    <entry>
    <para>Tell &amarok; where to start and stop looking for tracks</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Prevent Duplicates</guilabel></para>
    </entry>
    <entry>
    <para>Prevent &amarok; from selecting the same tracks, songs from the same artist, or the same album</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>Note that you can change how constraints work in various manners, such as setting the fuzzy-exact slider, which determines how closely the constraint is going to be followed.
</para>
<para>Another way to modify constraints that is present on <guilabel>Match Tags</guilabel> with a textbased tag is found in the line below the <guilabel>Field</guilabel> option box. In the text field to the right you write the text to be matched and in the option box at the left of the value you can select <guilabel>contains</guilabel> (which will consider any songs that have the according text in their tag), <guilabel>matches</guilabel> (which will consider songs whose corresponding tag match exactly the one in the text box), <guilabel>starts with</guilabel> and <guilabel>ends with</guilabel>.
</para>
<para>Similarly, you can also edit the way value-based constraints (such as the <guilabel>Playlist Length</guilabel> constraints and the playcount <guilabel>Match Tag</guilabel> constraint) behave by changing the option close to the text to settings such as <guilabel>fewer than</guilabel>, <guilabel>equals</guilabel> and <guilabel>more than</guilabel>.
</para>
<para>Another way to change constraint behavior is to check the <guilabel>invert</guilabel> checkbox on them, this makes them behave the opposite way, a <quote>Match Tag: artist contains <replaceable>name</replaceable></quote> becomes <quote>Match Tag: artist not contains <replaceable>name</replaceable></quote>.
</para>
</sect3>
<sect3 id="constraint-groups"><title>Constraint Groups</title> 
<para>Constraint groups can be added from the <guilabel>Add new</guilabel> option from the <guilabel>APG Preset Editor</guilabel> window, constraints under a group are logically linked, the same applies to groups under groups.
</para>
<para>There are currently two kinds of constraint groups: <quote>Match all</quote> groups and <quote>Match any</quote> groups. <quote>Match all</quote> groups require that all the constraints under them are met by the song. <quote>Match any</quote> groups require that at least one of the constraints under them are met by the song. To add a constraint under a specific group highlight it on the preset editor and use the <guilabel>Add new</guilabel> option.
</para>
</sect3>
</sect2>
<sect2 id="using-your-presets"><title>Using your Presets</title> 
<para>Once you set up a preset, you just have to select it on the <guilabel>APG Presets</guilabel> panel in the <guilabel>Automated Playlist Generator (APG)</guilabel> and click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-next.png" format="PNG"/> </imageobject> </inlinemediaobject> the toolbar to run <guilabel>APG</guilabel> with the selected preset. You will then have a playlist matching your criteria, like this:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="generatedlist.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Playlist generated by the constraint tree below.</phrase>
    </textobject>
    <caption>
      <para>Playlist generated by the constraint tree below.</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="generatingtree.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
</chapter>
<chapter id="various"><title>Various</title> 
<para>Topics which didn't fit elsewhere, such a Moodbar, Amarok on other platforms, troubleshooting, common problems, and the FAQ:
</para>
<itemizedlist>
<listitem><para><link linkend="the-moodbar">Moodbar</link>&nbsp;</para></listitem>
<listitem><para><link linkend="replay-gain">ReplayGain</link>&nbsp;</para></listitem>
<listitem><para><link linkend="amarok-on-other-platforms">Amarok on other Desktops and Operating Systems</link>&nbsp;<itemizedlist>
<listitem><para><link linkend="amarok-on-non-kde-desktops">Non-KDE Desktops</link>&nbsp;</para></listitem>
<listitem><para><link linkend="amarok-on-windows">Amarok on Windows</link>&nbsp;</para></listitem>
<listitem><para><link linkend="amarok-on-mac-os-x">Amarok on OS X</link>&nbsp;</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para><link linkend="troubleshooting-and-common-problems">Troubleshooting and Common Problems</link>&nbsp;</para></listitem>
<listitem><para><link linkend="frequently-asked-questions">FAQ</link>&nbsp;</para></listitem>
</itemizedlist>
<sect1 id="the-moodbar"><title>The Moodbar</title> 
<para>The <emphasis>Moodbar</emphasis> shows you the <quote>mood</quote> of a track, which you can then use to figure out when something interesting happens in the song.
</para>
<para>In order for &amarok; to display moodbars for your music, you will need the <guilabel>Moodbar</guilabel> program (see below for <link linkend="source-downloads">downloads</link> and binary packages).
</para>
<para>The <guilabel>Moodbar</guilabel> package requires <guilabel>GStreamer</guilabel> and various plugins depending on the filetypes you use (see <link linkend="supported-filetypes">Supported filetypes</link>).  You will <emphasis>not</emphasis> need the phonon-backend-gstreamer package to create .mood files.
</para>
<para>There are two parts to the new <guilabel>Moodbar</guilabel> implementation: the <guilabel>Moodbar</guilabel> package, which contains a program that takes a music file and generates a .mood file, and support code in the &amarok; source, which runs the binary and displays the Moodbar.  The <guilabel>Moodbar</guilabel> package depends on the <emphasis>GStreamer</emphasis> libraries.  Without the <guilabel>Moodbar</guilabel> package, &amarok; cannot generate the moodbars for your music.
</para>
<para>As an alternative, there is a new script which will create moodbar files for tracks in an &amarok; playlist; this is an exception to the above. The script needs nothing but &amarok; to work, but it only creates the .mood files as they are played in the <guilabel>Playlist</guilabel>.
</para>
<para>The <guilabel>Moodbar</guilabel> is due to the work of Gavin Wood and Simon O'Keefe, who designed the algorithms; their original paper is <ulink url="http://cratoo.de/amarok/ismir-crc.pdf">here</ulink>.
</para>
<sect2 id="summary-of-requirements"><title>Summary of Requirements</title> 
<itemizedlist>
<listitem><para>The <guilabel>Moodbar</guilabel> binary, in your PATH (it should be listed upon running <userinput>which moodbar</userinput> from a console) &mdash; Remember to configure the <guilabel>Moodbar</guilabel> package with proper path, &eg; build and install with commands <userinput>./autogen.sh --prefix=`pkg-config --variable=prefix gstreamer-1.0` &amp;&amp; make &amp;&amp; sudo make install</userinput></para></listitem>
<listitem><para>The GStreamer 1.0 library and <link linkend="supported-filetypes">plugins</link> for the formats you want <guilabel>Moodbar</guilabel> to be able to analyse. (An earlier GStreamer 0.10 based version is also still available for some distributions)</para></listitem>
<listitem><para>The <emphasis>Fastest Fourier Transform In The West</emphasis> (<ulink url="http://www.fftw.org">fftw.org</ulink>)  FFTW library version 3.0 or above (at least single-precision floating point version - libfftw3f) &mdash; If your platform does not provide this for you or you need to compile your own version, remember to configure the  FFTW package with <userinput>./configure --enable-single</userinput></para></listitem>
<listitem><para>A version of &amarok; with a <guilabel>Use moods</guilabel> option in the <guilabel>General</guilabel> section of the configuration screen. This means 1.4.4 or higher in the 1.4 series or 2.2.2 or higher in the 2.x series.</para></listitem>
</itemizedlist>
<para><note><para>Systems with package managers should automatically install the GStreamer plugins and FFTW along with the Moodbar package if available; this information is provided mostly for people who want or need to compile from source or manually install packages, or where the distribution specific instructions are outdated and no updated moodbar package is yet available.</para></note>
</para>
</sect2>
<sect2 id="usage"><title>Usage</title> 
<para>Currently .mood files <emphasis>must</emphasis> be generated manually. &amarok; cannot do it for you. To do this for your entire collection, use the <link linkend="moodbar-file-generation-script">Moodbar File Generation Script</link> described below.
</para>
<para>To enable the display of moodbars in &amarok;, activate it in the configuration: <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>General</guimenuitem><guimenuitem>Show Moodbar in Progress Slider</guimenuitem></menuchoice>. Moodbars should now appear in the track sliders in the player window and <guilabel>Playlist</guilabel>; there will also be a mood field that you may add to your playlist layouts.
</para>
</sect2>
<sect2 id="installation"><title>Installation</title> 
<sect3 id="source-downloads"><title>Source Downloads</title> 
<para>Latest release: <ulink url="https://github.com/Mazhoon/moodbar/archive/v0.1.4.tar.gz">moodbar-0.1.4.tar.gz</ulink> &mdash; this is the Moodbar source package, which contains the <guilabel>Moodbar</guilabel> program (which generates .mood files from music files), and a GStreamer plugin that does the work. The Moodbar package  needs GStreamer 1.0.* installed, plus the 1.0.* version of <link linkend="supported-filetypes">various plugins</link>. Be sure to install the Moodbar package into the <emphasis>same prefix</emphasis> as GStreamer &mdash; follow the instructions in <link linkend="summary-of-requirements"> the summary of requirements chapter</link>. The 0.1.4 is a a fork of original 0.1.2 sources, updated to use GStreamer 1.0. The old 0.1.2 sources are not reliably available online any more, but packages might be still available for some distributions.
</para>
<para>If you find any bugs, please submit a bug report at <ulink url="http://bugs.kde.org">bugs.kde.org</ulink>.
</para>
</sect3>
<sect3 id="debian-packages"><title>Debian packages</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>A package for Moodbar is now available in Debian unstable. Simply run <userinput>apt-get install moodbar</userinput> . You will likely also want to install gstreamer0.10-plugins-ugly, gstreamer0.10-plugins-good, and gstreamer0.10-plugins-bad for format support.
</para>
</sect3>
<sect3 id="kubuntu-and-ubuntu-packages"><title>Kubuntu and Ubuntu packages</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>A package for Moodbar is available in the official package repository; just ensure the universe section is activated (which should be default anyway). Just install the package moodbar with your preferred package manager (<guilabel>Kpackagekit</guilabel>, <guilabel>Aptitude</guilabel>, <guilabel>Adept</guilabel>, <guilabel>Synaptic</guilabel>). You will likely also want to install gstreamer0.10-plugins-ugly, gstreamer0.10-plugins-good, and gstreamer0.10-plugins-bad for format support.
</para>
<para>Or, to install, paste this into <guilabel>Firefox</guilabel> or &konqueror; and hit &Enter;.
</para>
<para><userinput>apt://moodbar,gstreamer0.10-plugins-ugly,gstreamer0.10-plugins-good,gstreamer0.10-plugins-bad?section=universe?refresh=yep</userinput>
</para>
</sect3>
<sect3 id="gentoo-ebuilds"><title>Gentoo ebuilds</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>Moodbar is available in Portage, simply <userinput>emerge moodbar</userinput>  Unofficial ebuilds are no longer required.
</para>
</sect3>
<sect3 id="rpm-builds"><title>RPM builds</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated</para></note>
</para>
<para>If you are a rpm-based distro user, you can build a .rpm using rpmbuild with latest
</para>
<para><ulink url="http://cvs.pld-linux.org/cgi-bin/cvsweb/SPECS/gstreamer-plugins-moodbar.spec">gstreamer-plugins-moodbar.spec</ulink>. The binary package will be soon available for <ulink url="http://pld-linux.org">PLD-linux</ulink> distro.
</para>
</sect3>
<sect3 id="fedora"><title>Fedora</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>In Fedora 7 and higher (up to 16 as of this writing) Moodbar is available in the default repositories. Simply install it with your PackageKit GUI or with the following yum command:
</para>
<para><userinput>yum install moodbar</userinput>
</para>
</sect3>
<sect3 id="opensuse-packages"><title>openSUSE packages</title> 
<para>GStreamer 1.0 based version 0.1.4 is available in KDE:Extra repository for openSUSE Leap 42.3 and later. An earlier GStreamer 0.10 based version 0.1.2 is also still available in the main repository for some openSUSE versions.
</para>
<para>For details on how to add repositories, see the <ulink url="http://en.opensuse.org/SDB:Add_package_repositories">openSUSE wiki</ulink>.
</para>
<para>1-Click Install for openSUSE - just choose your version and installation procedure will do the rest:
</para>
<itemizedlist>
<listitem><para><ulink url="https://software.opensuse.org/ymp/KDE:Extra/KDE_Frameworks5_openSUSE_Tumbleweed/moodbar.ymp">openSUSE Tumbleweed</ulink></para></listitem>
<listitem><para><ulink url="https://software.opensuse.org/ymp/KDE:Extra/openSUSE_Leap_15.0/moodbar.ymp">openSUSE Leap 15.0</ulink></para></listitem>
<listitem><para><ulink url="https://software.opensuse.org/ymp/KDE:Extra/openSUSE_Leap_42.3/moodbar.ymp">openSUSE Leap 42.3</ulink></para></listitem>
</itemizedlist>
</sect3>
<sect3 id="mandriva-packages"><title>Mandriva packages</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>First of all, you need to add PLF repositories, so visit <ulink url="http://easyurpmi.zarb.org">easyurpmi.zarb.org</ulink> and add them to your repositories list.
</para>
<para>Then simply install the following packages:
</para>
<itemizedlist>
<listitem><para>gstreamer0.10-moodbar</para></listitem>
<listitem><para>gstreamer0.10-plugins-ugly</para></listitem>
<listitem><para>gstreamer0.10-plugins-good</para></listitem>
<listitem><para>gstreamer0.10-plugins-bad</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="arch-linux"><title>Arch &Linux;</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>There is a PKGBUILD for Moodbar in the <ulink url="http://aur.archlinux.org">Arch User Repository (AUR)</ulink> available <ulink url="http://aur.archlinux.org/packages.php?ID=6552">here</ulink>.
</para>
<para>For more information about the AUR and working with PKGBUILDs, see the <ulink url="http://wiki.archlinux.org/index.php/AUR_User_Guidelines">AUR User Guidelines</ulink>.
</para>
</sect3>
<sect3 id="freebsd"><title>FreeBSD</title> 
<para><note><para>This section contains old instructions for the GStreamer 0.10 based moodbar version 0.1.2, they might be outdated.</para></note>
</para>
<para>There is a port: <ulink url="http://www.freshports.org/audio/gstreamer-plugins-moodbar">audio/gstreamer-plugins-moodbar here</ulink>.
</para>
<para>To install the port: <userinput>cd /usr/ports/audio/gstreamer-plugins-moodbar/ &amp;&amp; make install clean</userinput>
</para>
<para>To add the package: <userinput>pkg_add -r gstreamer-plugins-moodbar</userinput>
</para>
</sect3>
</sect2>
<sect2 id="moodbar-file-generation-script"><title>Moodbar File Generation Script</title> 
<para>Here is a simple bash script that will add .mood files to your entire collection. It adds mood files for all files matching the extensions in the current directory and all subdirectories, so it's best run from the base of your music directory.
</para>
<para><programlisting>
 #!/bin/bash
 DIR=${1:-.}
 LAST=~/.moodbar-lastreadsong
 C_RET=0
 control_c()        # run if user hits control-c
 {
   echo "" &gt; "$LAST"
   echo "Exiting..."
   exit
 }
 if [ -e "$LAST" ]; then
   read filetodelete &lt; "$LAST"
   rm "$filetodelete" "$LAST"
 fi
 exec 9&lt; &lt;(find "$DIR" -type f -regextype posix-awk -iregex '.*\.(mp3|ogg|flac|wma)') # you may need to add m4a and mp4
 while read i
 do
   TEMP="${i%.*}.mood"
   OUTF=`echo "$TEMP" | sed 's#\(.*\)/\([^,]*\)#\1/.\2#'`
   trap 'control_c "$OUTF"' INT
   if [ ! -e "$OUTF" ]
     moodbar -o "$OUTF" "$i"
   fi
 done &lt;&amp;9
 exec 9&lt;&amp;-
 exit $C_RET</programlisting> 
</para>
<para>Copy and paste the above into a text file named moodbar.sh in your music directory and run the following commands:
</para>
<para><userinput>
 cd /path/to/music
 bash moodbar.sh
</userinput> 
</para>
<para>Alternatively if the above does not work, you may try:
</para>
<para><userinput>
 chmod +x moodbar.sh
 ./moodbar.sh
</userinput> 
</para>
<para>This may take a very long time for large collections! Note that the moodbars will not appear in &amarok; until &amarok; rescans the collection. The generated <filename>mood</filename> files will be dotfiles (&ie;, prefixed with a full stop), or hidden files - so keep this in mind if you can't find any generated mood files.
</para>
<para>Based on the above script, an alternative for multicore CPUs:
</para>
<para><programlisting>
 #!/bin/bash
 NUMCPU="$(grep ^processor /proc/cpuinfo | wc -l)"
 find . -type f -regextype posix-awk -iregex '.*\.(mp3|ogg|flac|wma)' | while read i ; do
        while [ `jobs -p | wc -l` -ge $NUMCPU ] ; do
                sleep 0.1
        done
        TEMP="${i%.*}.mood"
        OUTF=`echo "$TEMP" | sed 's#\(.*\)/\([^,]*\)#\1/.\2#'`
        if [ ! -e "$OUTF" ] ; then
                moodbar -o "$OUTF" "$i" &amp;
        fi
 done</programlisting> 
</para>
</sect2>
<sect2 id="troubleshooting"><title>Troubleshooting</title> 
<itemizedlist>
<listitem><para>If the <guilabel>Moodbar</guilabel> executable gives you a <emphasis>bus error</emphasis>, that almost always means it can't decode (or can't find) your file.  Take a look at the <link linkend="supported-filetypes">supported file types</link> below for ideas on which GStreamer plugins to install.  You can also try the command below to test whether GStreamer can decode your file:<userinput>gst-launch-1.0 filesrc location=[file] ! decodebin ! fakesink</userinput></para></listitem>
<listitem><para>If you are using the ffmpeg plugin to decode mp3s, you may also receive mysterious bus errors. The solution is to stop using the ffmpeg plugin, as it is extremely buggy &mdash; use mad instead.</para></listitem>
<listitem><para>If the <guilabel>Moodbar</guilabel> executable tells you that it can't find an element &mdash; &ie;, it gives an error message like <screen>Could not create element of type fftwspectrum, please install it.</screen>&mdash; that usually means that you either don't have the required plugins installed (see the plugin list <link linkend="supported-filetypes">here</link>), or that you didn't install the Moodbar package in the same prefix as GStreamer. If libmoodbar.so and libgstdecodebin.so are not in the same directory, then Moodbar is not installed in the same prefix as GStreamer.  Please read the INSTALL file for instructions on how to configure the moodbar package correctly. Alternatively, <emphasis>if you know what you're doing,</emphasis> it may be easier for you to take a look at the <filename>GST_PLUGIN_PATH</filename> environment variable.</para></listitem>
<listitem><para>If you're wondering why the <guilabel>Moodbar</guilabel> isn't working, either not working at all or not working for a particular file, run the command below, where [file] is a music file:<userinput>moodbar -o test.mood [file]</userinput>  To generate a test image preview, one can use the commandː<userinput>gst-launch-1.0 filesrc location=[file] ! decodebin ! audioconvert ! fftwspectrum ! moodbar height=50 max-width=300 ! pngenc ! filesink location=mood.png</userinput></para></listitem>
<listitem><para>If you have multiple versions of GStreamer installed, make sure all of the required plugins are installed <emphasis>for version 1.0.*</emphasis> -- different versions <emphasis>cannot</emphasis> use each other's plugins.</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="supported-filetypes"><title>Supported Filetypes</title> 
<para>You will need various Gstreamer plugins to enable <guilabel>Moodbar</guilabel> to analyze your files. Here is a list of the plugins you will need; make sure to install the <emphasis>1.0.* version</emphasis> of each plugin:
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <thead>
  <row>
    <entry>Filetype</entry>
    <entry>Required Plugin</entry>
    <entry>Note</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>All</para>
    </entry>
    <entry>
    <para>gstreamer-1.0.*, gst-plugins-base, gst-plugins-good</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>mp3</para>
    </entry>
    <entry>
    <para>gst-plugins-mad (in gst-plugins-ugly)</para>
    </entry>
    <entry>
    <para>ffmpeg plugin has problems; <emphasis>do not use</emphasis> for mp3</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>ogg</para>
    </entry>
    <entry>
    <para>gst-plugins-vorbis, gst-plugins-ogg</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>flac</para>
    </entry>
    <entry>
    <para>gst-plugins-flac</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>mp4</para>
    </entry>
    <entry>
    <para>gst-plugins-faad, gst-plugins-bad</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>musepack</para>
    </entry>
    <entry>
    <para>gst-plugins-musepack</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>wma</para>
    </entry>
    <entry>
    <para>gst-plugins-ffmpeg</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="screenshots"><title>Screenshots</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2_moodbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Moodbar in progress slider in Amarok 2</phrase>
    </textobject>
    <caption>
      <para>Moodbar in progress slider in Amarok 2</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
<sect1 id="replay-gain"><title>Replay Gain</title> 
<para><ulink url="https://en.wikipedia.org/wiki/ReplayGain">Replay gain</ulink> will automatically adjust the volume of the currently played song, relative to other songs, as determined by the person who encoded the audio file. To enable replay gain, see <link linkend="settings-menu">Settings menu</link>.
</para>
<para>To handle this, &amarok; relies on metadata embedded in the audio file:
</para>
<orderedlist>
<listitem><para>If no replay gain information is embedded, &amarok; will not adjust the volume</para></listitem>
<listitem><para>If replay gain information is found, it will be written into &amarok;'s database</para></listitem>
</orderedlist>
<para>During playback, &amarok; will only look into its own database for this information. Updates to the metadata of the file will not always get written into the database during a collection update (&eg; replay gain is deleted from file).
</para>
<para>This can lead to unexpected behavior: Songs from the same artist play at different volume levels &etc;
</para>
<sect2 id="is-replay-gain-being-used"><title>Is replay gain being used?</title> 
<para>To figure out if the volume problem is caused by replay gain or bad encoding:
</para>
<itemizedlist>
<listitem><para>Disable replay gain processing (see above)</para></listitem>
<listitem><para>Start &amarok; in debug mode and search for gain- related output:</para></listitem>
</itemizedlist>
<para><userinput><command>amarok -d --nofork | grep gain</command></userinput>
</para>
<para>If replay gain is active for the played song, the output will be
</para>
<para> Using gain of -10.28 with relative peak of -1
</para>
</sect2>
<sect2 id="view-replay-gain-information"><title>View replay gain information</title> 
<para>For .flac files, <quote>metaflac</quote> can be used to view embedded replay gain data:
</para>
<para><userinput><command>metaflac --list Millencolin\ -\ Balanced\ Boy.flac</command></userinput>
</para>
<para>Among other things, this will show something like this:
</para>
<para> METADATA block #2
</para>
<para>  type: 4 (VORBIS_COMMENT)
</para>
<para>  is last: false
</para>
<para>  length: 390
</para>
<para>  vendor string: reference libFLAC 1.2.1 20070917
</para>
<para>  comments: 14
</para>
<para>    comment[9]: REPLAYGAIN_REFERENCE_LOUDNESS=89.0 dB
</para>
<para>    comment[10]: REPLAYGAIN_TRACK_GAIN=-1.55 dB
</para>
<para>    comment[11]: REPLAYGAIN_TRACK_PEAK=0.75894165
</para>
<para>    comment[12]: REPLAYGAIN_ALBUM_GAIN=-4.19 dB
</para>
<para>    comment[13]: REPLAYGAIN_ALBUM_PEAK=0.98712158
</para>
<para>To view this tracks information within the &amarok; database:
</para>
<para><userinput><command>select id, title, albumgain, albumpeakgain, trackgain, trackpeakgain from tracks where title like &quot;Balanced%&quot;;</command></userinput>
</para>
<para>Will show:
</para>
<para> +-------+------------------+-----------+---------------+-----------+---------------+
</para>
<para> | id    | title            | albumgain | albumpeakgain | trackgain | trackpeakgain |
</para>
<para> +-------+------------------+-----------+---------------+-----------+---------------+
</para>
<para> | 10459 | Balanced Boy     |      0.53 |      -5.60297 |      0.44 |      -5.60297 |
</para>
<para>Note the difference in loudness levels
</para>
</sect2>
<sect2 id="delete-replay-gain-information"><title>Delete replay gain information</title> 
<para>First, delete the metadata from the file:
</para>
<para><userinput><command>metaflac --remove-replay-gain Millencolin\ -\ Balanced\ Boy.flac</command></userinput>
</para>
<para>After that, update your &amarok; collection. If it is still using replay gain, update the database entry:
</para>
<para><userinput><command>update tracks set albumgain=-1,albumpeakgain=-1,trackgain=-1,trackpeakgain=-1 where id=10459</command></userinput>
</para>
<para>Restart &amarok; and the log output should now show the updated values being used.
</para>
<para>Feel free to try and mess with the values manually to improve volume levels.
</para>
</sect2>
</sect1>
<sect1 id="amarok-on-other-platforms"><title>Amarok on other platforms</title> 
<para>&amarok; is intended for the KDE desktop, but it works on other platforms as well. Although it takes some effort, Amarok can run on these configurations:
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <tbody>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="otherplatforms_nonkde.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="amarok-on-non-kde-desktops">Non-KDE Desktops</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="otherplatforms_windows.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="amarok-on-windows">Windows</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="otherplatforms_osx.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot></para>
    </entry>
    <entry>
    <para><link linkend="amarok-on-mac-os-x">OS X</link>&nbsp;</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect2 id="amarok-on-non-kde-desktops"><title>Amarok on Non-KDE Desktops</title> 
<para>Although &amarok; is one the most well-known KDE applications, it can run on other desktop environments too.
</para>
<para>This section shows how &amarok; can be used on non-KDE &Linux; desktops. These are examples; there may be more.
</para>
<sect3 id="gnome"><title>GNOME</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-gnome.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>To configure the proxy for &amarok; on GNOME, modify and add this to <filename>~/.kde/share/config/kioslaverc</filename>
</para>
<para><screen>
[Proxy Settings][$i]
ProxyType=1
httpProxy=http://username:password@proxyserver:port/
httpsProxy=http://username:password@proxyserver:port/
ftpProxy=http://username:password@proxyserver:port/
</screen>
</para>
</sect3>
<sect3 id="enlightenment"><title>Enlightenment</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-e17.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The &amarok; systray icon does not work by default with E17. So, one should disable the <guilabel>Show tray icon</guilabel> from <guilabel>General Options</guilabel> in &amarok;'s preferences.
</para>
</sect3>
<sect3 id="xfce"><title>XFCE</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-xfce.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>To launch &amarok; faster, enable <guilabel>Launch KDE services on startup</guilabel> by going into <menuchoice><guimenu>Settings</guimenu><guisubmenu>Sessions and Startup</guisubmenu><guimenuitem>Advanced</guimenuitem></menuchoice> and checking the option.
</para>
</sect3>
<sect3 id="fluxbox"><title>Fluxbox</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-fluxbox.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>If &amarok; is taking to long to load, add <userinput>exec kdeinit</userinput>  to <filename>~/.fluxbox/startup</filename>.
</para>
</sect3>
<sect3 id="lxde"><title>LXDE</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-lxde.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>In case &amarok; starts slowly in LXDE, you can add <guilabel>kdeinit</guilabel> to the startup applications using the <guilabel>lxsession-edit</guilabel> command.
</para>
</sect3>
</sect2>
<sect2 id="amarok-on-windows"><title>Amarok on Windows</title> 
<para><warning><para>This pages needs screenshots for the Amarok 2.8 version</para></warning>
</para>
<para>As you already know, a normal Windows install doesn't use KDE, so if you want to install &amarok;, you can't just download the &amarok; package. You must install a compatible compiler first. Here is described how to download, install and run &amarok; in the Windows operating system.
</para>
<sect3 id="how-to-download"><title>How to download</title> 
<para>If you run into any difficulties, please visit the <ulink url="http://community.kde.org/Amarok/GettingStarted/Download/Windows">Amarok on Windows wiki page</ulink> where the latest links will be kept updated. Otherwise, use the latest at the following links:
</para>
</sect3>
<sect3 id="how-to-install"><title>How to install</title> 
<para>The installation is very simple, just run the downloaded .exe file.
</para>
<para><warning><para>If you want to update be sure to remove your current install.</para></warning>
</para>
<sect4 id="step-1"><title>Step 1</title> 
<para>First, review on the license terms.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="installation1-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="step-2"><title>Step 2</title> 
<para>Second, choose the install location.
</para>
<para>If you want to change the default location, select  <guilabel>Browse...</guilabel> and choose a new location.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="installation2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="step-3"><title>Step 3</title> 
<para>Wait a few minutes while the installation finishes.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="installation3.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="step-4"><title>Step 4</title>  
<para>When the installation is done, dismiss the window with <guilabel>Close</guilabel>. Your &amarok; installation has finished.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="installation4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
</sect3>
<sect3 id="running-amarok"><title>Running Amarok</title> 
<para>When the installation finishes,  you'll find an &amarok; shortcut on your desktop. To run &amarok;, just click the shortcut.
</para>
</sect3>
</sect2>
<sect2 id="amarok-on-mac-os-x"><title>Amarok on &MacOS; X</title> 
<para><warning><para>Current Macports 2.1.3 only ships an outdated Amarok 2.6.0 version</para></warning>
</para>
<para>&amarok; can be installed and used on the &MacOS; X.
</para>
<sect3 id="installation-using-macports"><title>Installation using MacPorts</title> 
<para>To install &amarok; on &MacOS; X, first one needs to install MacPorts from <ulink url="http://www.macports.org/install.php">here</ulink>. Once MacPorts is installed one needs to run the following command in the terminal:
</para>
<para><userinput>sudo port install amarok</userinput>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-mac-port-install.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>The <varname>port</varname> command will fetch all the dependencies, compile, build and install them. This process may take quite some time, four to five hours in a recent install.
</para>
</sect3>
<sect3 id="screenshots14"><title>Screenshots</title> 
<para>The following screenshot shows &amarok; running on the &MacOS; X:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_on_mac.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="other-resources"><title>Other resources</title> 
<para>If you run into difficulties, there is a <ulink url="http://community.kde.org/Amarok/Development/OS_X">troubleshooting page here</ulink>.
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="troubleshooting-and-common-problems"><title>Troubleshooting and Common Problems</title> 
<para>If you work through the procedures here, but don't have success, please come into IRC (irc://irc.libera.chat/amarok), post on the KDE Forum <ulink url="http://forum.kde.org/viewforum.php?f=127">Amarok section</ulink>, or write to the <ulink url="https://mail.kde.org/mailman/listinfo/amarok">Amarok list</ulink>.
</para>
<sect2 id="problems-installing"><title>Problems installing</title> 
<sect3 id="bad-packaging"><title>Bad packaging</title> 
<para>Occasionally, users will encounter bad packaging from the distributions; either from the wrong version of a component being included, or some needful part being left out. For some reason, this often happens with MySQL dependencies. Bug reports in these cases should be made to your distribution, not to bugs.kde.org.
</para>
</sect3>
<sect3 id="difficulties-building-from-source"><title>Difficulties building from source</title> 
<para>For those who wish to help out by testing the newest &amarok; versions, a local build is advised. Use this excellent guide: <ulink url="http://blogs.fsfe.org/myriam/2009/09/compiling-amarok-from-git-locally-full-summary/">Compiling Amarok from GIT Locally; a Full Summary</ulink>. Detailed information about git can be found here: <ulink url="http://techbase.kde.org/Getting_Started/Sources/KDE_git-tutorial">Techbase GIT Tutorial</ulink>.
</para>
<para>If you have built successfully before, and now are encountering errors, try removing <filename>CMakeCache.txt</filename> and try again. If that still errors out, remove the entire Build folder and build completely fresh.
</para>
<para>The URL to pull from git has recently changed. Run <userinput><command>git remote set-url origin git://anongit.kde.org/amarok</command></userinput>  if you still using the old URL. Please ping us if you find the old link in our documents so we can update it everywhere.
</para>
</sect3>
</sect2>
<sect2 id="problems-starting-up"><title>Problems starting up</title> 
<sect3 id="playlist-errors"><title>Playlist errors</title> 
<para>The current playlist can occasionally get corrupt, which will prevent &amarok; from starting. This can be fixed by simply removing the current playlist file in the &amarok; directory, <filename>$HOME/.kde/share/apps/amarok/current.xspf</filename> . Note that on some systems, this may be <filename>.kde4</filename> rather than <filename>.kde</filename>.
</para>
</sect3>
<sect3 id="database-issues"><title>Database issues</title> 
<para>If the database is corrupt and this is preventing &amarok; from starting, you can move the database to a backup location (or simply delete it). This will cause &amarok; to rebuild the database from scratch. Move the <filename>$HOME/.kde/share/apps/amarok/mysqle</filename> folder to a backup location (such as <filename>$HOME/.kde/share/apps/amarok/mysqle~</filename>) and restart &amarok;.
</para>
</sect3>
<sect3 id="other-issues-and-backing-up-settings"><title>Other issues and backing up settings</title> 
<para>If the above two items do not help, or you otherwise need to restore &amarok; to a clean configuration, you can move to a backup location (or delete) the &amarok; directory at <filename>$HOME/.kde/share/apps/amarok</filename> and the &amarok; config files at <filename>$HOME/.kde/share/config/amarok*</filename> (there may be two or three files matching this pattern). Again, the directory may be <filename>.kde4</filename> rather than <filename>.kde</filename>.
</para>
</sect3>
</sect2>
<sect2 id="problems-scanning-sorting-files"><title>Problems Scanning, Sorting files</title> 
<para>&amarok; scans your music files on first startup, and will keep your collection up-to-date automatically, if you chose <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Collection</guimenuitem><guimenuitem>Watch folders for changes</guimenuitem></menuchoice>.
</para>
<para>If you don't want &amarok; scanning for changes, uncheck that, and use <menuchoice><guimenu>Tools</guimenu><guimenuitem>Update Collection</guimenuitem></menuchoice> whenever you make changes to your collection.
</para>
<para>More about <link linkend="collection-scanning">Amarok collection scanning here</link>.
</para>
<sect3 id="corrupt-tags"><title>Corrupt tags</title> 
<para>Some folks notice that &amarok; seems to be missing some files. One of the causes can be corrupt tags, which you can check using the tagging application <ulink url="http://kid3.sourceforge.net/">kid3</ulink>. More about tagging <link linkend="tag-editor">here</link>.
</para>
<para>To find the bad file(s), run <varname>amarokcollectionscanner</varname> from the console. Details <ulink url="http://community.kde.org/Amarok/Development/BatchMode">here</ulink>.
</para>
</sect3>
<sect3 id="inability-to-write-tags"><title>Inability to write tags</title> 
<para>If &amarok; is not saving changes to tags, you may have permissions problems. Ensure that your user has write permissions to your music. For example, <userinput>chown -R youruser Music/</userinput>  to change ownership to your user, or <userinput>chmod -R +w Music/</userinput>  to add write permissions to the owner.
</para>
</sect3>
<sect3 id="incorrect-sorting-various-artists"><title>Incorrect Sorting (Various Artists)</title> 
<para>Sometimes people report that tracks are in Various Artists when they should not be, or are sorted into <quote>Unknown Album.</quote> What separates Various Artists albums and tracks and albums sorted under their artists is the Album Artist tag. When you click <guilabel>Show under Various Artists</guilabel> in the context (right-click) menu, that tag will be emptied if it is filled. The opposite happens to a file in Various Artists when you choose <guilabel>Do not show under Various Artists</guilabel>, but the Album Artist tag will be auto-filled from the Artist tag.
</para>
<para>If there is no Album tag, and no Album Artist tag, &amarok; will put the track into Unknown Album in Various Artists. If you want them sorted otherwise, tag them the way you want them sorted. If you don't know some of the information, try out the new <emphasis>MusicBrainz</emphasis> function in the tag editor, or use a tagging application.
</para>
</sect3>
<sect3 id="duplicate-tracks"><title>Duplicate Tracks</title> 
<para>Sometimes Amarok pops up following dialog during (perhaps initial) collection scan:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok-2-6-duplicates-during-collection-scan.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>This most probably means that an identical file ended up twice in your collection at different places. You can use Amarok's File Browser to check the files individually, <guilabel>usual action is to remove one of the duplicate files</guilabel>. If you are sure that the tracks are not (or shouldn't be) duplicates, there may be several reasons why &amarok; thinks they are:
</para>
<orderedlist>
<listitem><para>The files are bit-by-bit identical<itemizedlist>
<listitem><para>You can use for example <varname>md5sum</varname> command to verify that</para></listitem>
<listitem><para>You can edit metadata of one of the files from within &amarok; File browser to differentiate them somehow, perhaps by editing (album) artist, year, composer or a comment</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>The files have the same Amarok AFT unique id<itemizedlist>
<listitem><para>This is often a result of running amarok_afttagger and then creating multiple copies of a tagged file; tag reader such as Kid3 or MP3Diags can be used to verify this, look for <varname>Amarok 2 AFTv1</varname> string in tags</para></listitem>
<listitem><para>You can use <varname>amarok_afttagger</varname> command-line utility to reset unique id of one of the tracks: <userinput>amarok_afttagger --newid --verbose path/to/one/of/the/tracks.mp3</userinput></para></listitem>
<listitem><para>Alternatively, you can remove the unique id from one of the tracks, loosing the track-even-if-changed-from-outside functionality: <userinput>amarok_afttagger --delete --verbose path/to/one/of/the/tracks.mp3</userinput></para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para>(for Amarok before  <ulink url="http://commits.kde.org/amarok/216c18bdaf1">v2.7.0-96-g216c18b</ulink>) The files have the same MusicBrainz id<itemizedlist>
<listitem><para>Released versions up to &amarok; 2.7 treated MusizBrainz id embedded in tags (filled in by MusicBrainz-enabled tagger such as Picard) as unique identifiers of tracks. However, MusicBrainz changed the semantics of the id to mean <quote>recording id</quote> since it was originally implemented in &amarok;, which means that you may get false duplicates for example for tracks that appear on the original album and the Best of one. See <emphasis role="strikethrough"><ulink url="https://bugs.kde.org/show_bug.cgi?id=315329">bug #315329</ulink></emphasis> for more info</para></listitem>
<listitem><para>You can use any advanced tag reader to verify this (look for <varname>MusicBrainz</varname> string in tags) and to remove the MusicBrainz id from one of the tracks</para></listitem>
<listitem><para>As an alternative solution, you can use <varname>amarok_afttagger</varname> to add &amarok; AFT id to one of the tracks because &amarok; will then prefer its own id rather than the MusicBrainz one: <userinput>amarok_afttagger --newid --verbose path/to/one/of/the/tracks.mp3</userinput></para></listitem>
</itemizedlist>
</para></listitem>
</orderedlist>
</sect3>
</sect2>
<sect2 id="problems-playing-files"><title>Problems playing files</title> 
<sect3 id="amarok-skips-over-tracks-or-appears-to-play-them-without-sound"><title>Amarok skips over tracks, or appears to play them without sound</title> 
<para>If the files you are attempting to play are in mp3 format, please see instructions for enabling mp3 support on your distro, <link linkend="what-media-types-does-amarok-support">here</link>. Note that one piece of software being able to play mp3s on your system does not necessarily mean &amarok; has had the required codecs installed.
</para>
</sect3>
<sect3 id="no-sound-or-bad-sound"><title>No sound, or bad sound</title> 
<para>For more general sound issues, first check what Phonon backend you are using in <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Playback</guimenuitem><guimenuitem>Configure Phonon</guimenuitem><guimenuitem>Backend</guimenuitem></menuchoice>. Consider switching to a different backend; VLC and GStreamer backends should be available from your distribution. Both the Gstreamer or VLC backends are recommended, if your distribution is still shipping other backends do not use them.
</para>
<para>Also check whether the backend standalone software can play the files correctly; if not this is an issue with that software and you may find information in their help files. In other words, can Gstreamer or VLC play the same file? Will it play in <ulink url="help:/dragonplayer">Dragon</ulink>, which also uses phonon?
</para>
<para>If it seems to be a PulseAudio problem, and you want to provide a log to the PulseAudio developers, the troubleshooting page is <ulink url="https://wiki.ubuntu.com/PulseAudio/Log">here</ulink>.
</para>
</sect3>
</sect2>
<sect2 id="problems-with-collections-on-ipod-etc-"><title>Problems with collections on iPod &etc;</title> 
<sect3 id="amarok-show-no-cover-images-or-images-are-lost-when-transferring-to-device"><title>Amarok show no cover-images or images are lost when transferring to device</title> 
<para>Most likely the wrong version of libgpod4 is installed. On Debian and it's derivatives like Kubuntu the default is libgpod4-nogtk, which comes without support for covers. Simply install the variant libgpod4: <userinput>sudo apt-get install libgpod4</userinput>  The package libgpod4-nogtk can then be removed without problem. From Kubuntu Quantal Quetzal on (released as 12.10) this package has been removed and the default is libgpod4.
</para>
</sect3>
</sect2>
<sect2 id="crashes-and-bugs"><title>Crashes and bugs</title> 
<itemizedlist>
<listitem><para>How to run &amarok; from the command line: <userinput>amarok --debug --nofork</userinput></para></listitem>
<listitem><para>&amarok; crashes, but <guilabel>Dr. Konqi</guilabel> doesn't pop up &mdash; run in <guilabel>gdb</guilabel> with the following command: <userinput>gdb --args amarok --debug --nofork</userinput>  In <guilabel>gdb's</guilabel> console, type <varname>run</varname> to start &amarok;, reproduce the crash, and then in <guilabel>gdb</guilabel> type <varname>thread apply all bt</varname> to generate the backtrace.</para></listitem>
<listitem><para>Filing bugs: If triggered, <guilabel>Dr. Konqi</guilabel> will provide an option to report a bug and do most of the work for you. If not, you will need to submit the bug manually at <ulink url="http://bugs.kde.org/enter_bug.cgi?product=amarok"> bugs.kde.org</ulink>. For crash bugs, paste the backtrace from <guilabel>gdb</guilabel> as a comment.</para></listitem>
<listitem><para>How to get personal support with problems: <ulink url="irc://irc.libera.chat/#amarok">IRC</ulink> (#amarok on Libera Chat IRC), <ulink url="http://forum.kde.org/viewforum.php?f=127">Forum</ulink>, <ulink url="https://mail.kde.org/mailman/listinfo/amarok">Mailing list</ulink></para></listitem>
</itemizedlist>
</sect2>
</sect1>
<sect1 id="frequently-asked-questions"><title>Frequently Asked Questions</title> 
<sect2 id="what-is-amarok"><title>What is Amarok?</title> 
<para>&amarok; is an audio player. More information can be found in <link linkend="amarok-menu">a summary of its features</link> and the <ulink url="http://amarok.kde.org/en/screenshots">screenshot gallery</ulink>. To get started using &amarok;, see the <link linkend="quick-start-guide">Quick Start Guide</link>. The &amarok; Handbook is <link linkend="introduction">here</link>.
</para>
</sect2>
<sect2 id="what-are-the-differences-between-amarok-two-and-the-previous-versions"><title>What are the differences between Amarok 2 and the previous versions?</title> 
<para>&amarok; 2 is a nearly complete code-rewrite so the codebase has little to do with &amarok; 1.4. If you are missing a feature, please file a wish in <ulink url="http://bugs.kde.org">Bugzilla</ulink>.
</para>
<para>Here you have a short list of some new features:
</para>
<itemizedlist>
<listitem><para>Maybe the biggest new feature is the <emphasis>Service Framework</emphasis>, which integrates networked music sources directly into &amarok;. This includes online music stores, media servers, Web music lockers, and more. Thanks to it you'll get easy access to music provided by <emphasis>Magnatune</emphasis>, <emphasis>Jamendo</emphasis>, <emphasis>Last.fm</emphasis>, <emphasis>MP3Tunes Locker</emphasis>, <guilabel>Ampache</guilabel> and many others. Expect more big (and small) names to join during the 2.x lifecycle. See <link linkend="internet">Internet Media Sources</link> for more.</para></listitem>
<listitem><para>Another exciting feature is the <guilabel>Context</guilabel> pane, occupying the central place of the &amarok;'s window, replacing the old <emphasis>Context Browser</emphasis> from the 1.x series. It displays contextual information about the music you play, like the album cover, track rating, labels, lyrics, artist information, related songs and artists, guitar and bass tabs and others. Thanks to the Plasma technology it uses, the <guilabel>Context</guilabel> pane can provide very rich content, like AJAX, video and animations, all in an eye-catching fashion. More about the <link linkend="the-context-pane">Context pane</link>.</para></listitem>
<listitem><para>To accompany the <guilabel>Context</guilabel> pane, we developed a new, space efficient playlist. In order to preserve horizontal space, it groups the track name, artist, album name and cover art together, and allows further grouping by album names. Plus you can rearrange it to your heart's content! If you prefer the old 1.4 playlist, you can have that too. See <link linkend="changing-the-playlist-layout">Changing the Playlist layout</link> for more.</para></listitem>
<listitem><para>Another great gem is the video support. Watching your music videos inside &amarok; feels great!</para></listitem>
<listitem><para>We can't forget the <guilabel>Dynamic Playlists</guilabel>, which extend the old <guilabel>Dynamic Playlists</guilabel>. They allow you to define an automatically populated playlist, based on specific probability driven criteria called <quote>biases</quote>. The <guilabel>Dynamic Playlists</guilabel> is joined by the new <guilabel>Automatic Playlist Generator</guilabel>, used to generate lists for specific purposes and of a specified length. See <link linkend="dynamic-playlists">Dynamic Playlists</link> and <link linkend="automatic-playlist-generator">Automatic Playlist Generator</link> for more information.</para></listitem>
</itemizedlist>
<para>There are many more great features like advanced scripting, dynamic collections, usability improvements, improved media devices handling, a new podcast manager, support for more software platforms, and others.
</para>
</sect2>
<sect2 id="installation15"><title>Installation</title> 
<sect3 id="can-i-use-amarok-without-kde"><title>Can I use Amarok without KDE?</title> 
<para>&amarok; requires parts of KDE to be installed to run, but will run fine in Gnome or other desktop environments, including Windows and OS X. For &amarok; to run, kdelibs and kdebase-runtime need to be installed.
</para>
<para>For some features to work correctly, such as the on-screen display, your window manager must be configured to support the relevant <emphasis>freedesktop.org</emphasis> standards. More about running &amarok; on other platforms <link linkend="amarok-on-other-platforms">here</link>.
</para>
</sect3>
<sect3 id="why-does-amarok-use-kdelibs"><title>Why does Amarok use KDElibs?</title> 
<para>We are committed to supporting &amarok; on all platforms. We use KDElibs and Qt because they provide an excellent development environment. Aside from &Linux; and BSD, &amarok; works on Windows and MacOS, and there are installers available, but unfortunately we don't have (yet) the resources to offer full support for those operating systems. Almost all of our developers use free operating systems, and those have priority for us. We do however welcome Windows and OS X developers willing to help, and improve &amarok; on those platforms.
</para>
</sect3>
</sect2>
<sect2 id="general-usage"><title>General usage</title> 
<sect3 id="how-can-i-control-amarok-from-the-keyboard"><title>How can I control Amarok from the keyboard?</title> 
<para>Keyboard shortcuts are available; see our <link linkend="keybinding-reference">Keybinding Reference page</link> for more information.
</para>
<para>To control &amarok; from the console, type <userinput>amarok --help-all</userinput> for a current complete list of available control commands.
</para>
</sect3>
<sect3 id="where-can-i-get-support-for-amarok"><title>Where can I get support for Amarok?</title> 
<para>There are several options. Often times problems you have with the initial install of &amarok; are best answered by experts of your particular &UNIX; or &Linux; distribution. You may seek help from fellow users and developers at the <ulink url="http://forum.kde.org/viewforum.php?f=127">Amarok forum</ulink> and the <ulink url="irc://irc.libera.chat/amarok">Amarok IRC channel</ulink> at irc.libera.chat channel #amarok.
</para>
<para>Note that <ulink url="http://bugs.kde.org">bugzilla</ulink> is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in &amarok; itself.
</para>
</sect3>
<sect3 id="how-do-i-report-a-bug"><title>How do I report a bug?</title> 
<para>If you find a bug in &amarok;, please submit it to the <ulink url="https://bugs.kde.org">KDE bugzilla instance</ulink>. To make a complete bug report, please always include the following information:
</para>
<itemizedlist>
<listitem><para>The exact &amarok; version (the version can be found in <menuchoice><guimenu>Help</guimenu><guimenuitem>About Amarok</guimenuitem></menuchoice>). You should not report bugs for &amarok; versions older than the current stable release as we do not provide backport fixes.</para></listitem>
<listitem><para>The exact KDE and Qt version, even if you do not run &amarok; in KDE (<menuchoice><guimenu>Help</guimenu><guimenuitem>About KDE</guimenuitem></menuchoice>)</para></listitem>
<listitem><para>The exact Phonon backend. You can find this information in the Diagnostics (<menuchoice><guimenu>Help</guimenu><guimenuitem>Diagnostics</guimenuitem></menuchoice>)</para></listitem>
<listitem><para>Whether the bug is reproducible. Please do not report bugs that you can not reproduce as these are almost impossible to fix.</para></listitem>
<listitem><para>Exact steps how to reproduce the bug</para></listitem>
</itemizedlist>
<para>If any of these information is missing the bug report is not complete. Please also be prepared to answer questions from the developers or bug triagers and eventually test other settings.
</para>
</sect3>
</sect2>
<sect2 id="questions-about-the-playlist"><title>Questions about the Playlist</title> 
<para>More about the <link linkend="the-playlist-pane">Playlist here</link>.
</para>
<sect3 id="when-i-start-amarok-i-see-an-empty-playlist--how-do-i-actually-get-tracks-in-there"><title>When I start Amarok, I see an empty playlist. How do I actually get tracks in there?</title> 
<para>Use the <guilabel>Media Sources</guilabel> on the left side to navigate to the desired artist/album/track. Then drag the files into the <guilabel>Playlist</guilabel> part on the right. You can use <guilabel>Dynamic Playlists</guilabel> or the <guilabel>Automatic Playlist Generator</guilabel> to populate your playlist. You can also drag files in from any file manager, such as &dolphin;. You may also double-click a track, artist or genre in your <guilabel>Media Sources</guilabel> or file-system, or right-click and <guilabel>Add to Playlist</guilabel> or <guilabel>Replace Playlist</guilabel>.
</para>
</sect3>
<sect3 id="how-do-i-remove-tracks-from-the-playlist"><title>How do I remove tracks from the Playlist?</title> 
<para>Select the track(s) you want to remove, and press the <keycap>Delete</keycap> key. Or right-click the selection and choose <guilabel>Remove From Playlist</guilabel>.
</para>
</sect3>
<sect3 id="how-can-i-load-a-playlist"><title>How can I load a playlist?</title> 
<para>Just drag and drop the playlist file into the <guilabel>Playlist</guilabel>, like you would do with any other file. It's that simple!
</para>
</sect3>
<sect3 id="how-can-i-save-the-current-playlist"><title>How can I save the current playlist?</title> 
<para>Click the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-save.png" format="PNG"/> </imageobject> </inlinemediaobject> button in the <guilabel>Playlist</guilabel> toolbar. Slow-click the disc icon to chose to save to your harddisk, or to the database.
</para>
</sect3>
</sect2>
<sect2 id="playback-questions"><title>Playback Questions</title> 
<sect3 id="how-do-i-play-audio-cds"><title>How do I play audio CDs?</title> 
<para>Audio CDs are treated differently than data CDs, which are also supported. When you insert an audio CD, it will be shown as a local collection. Drag to the playlist or <emphasis>Pop-Up Dropper</emphasis>, or right-click the selected tracks and choose <guilabel>Add to Playlist</guilabel> or <guilabel>Replace Playlist</guilabel>.
</para>
</sect3>
<sect3 id="what-media-types-does-amarok-support"><title>What media types does Amarok support?</title> 
<para>&amarok; does not play music by itself, but lets Phonon do that job, specifically the VLC or GStreamer backends of Phonon. Therefore, whatever files they can play, &amarok; can play. To analyse file tags, &amarok; uses Taglib, which supports most file types that contain metadata.
</para>
</sect3>
<sect3 id="what-is-phonon-what-are-phonon-backends"><title>What is Phonon? What are Phonon backends?</title> 
<para><emphasis>Phonon</emphasis> is the multimedia framework of KDE 4. You can find more information <link linkend="playback">here</link>.
</para>
<para>We currently recommend both the Gstreamer and  VLC backend as both are actively maintained. If you want to play streams you should use the VLC backend only as the Gstreamer backend has some shortcomings in this regard. Make sure you do not use any other backend as those are obsolete.
</para>
<para>If you are using the Phonon-backend-gstreamer make sure you only use plugins from one single gstreamer version, else your sound will be compromised.
</para>
</sect3>
<sect3 id="amarok-wont-play-mp3s-what-can-i-do"><title>Amarok won't play mp3s, what can I do?</title> 
<para>You probably lack the codecs required by your particular Phonon backend (Gstreamer, or VLC). Please report this to your distribution if you were not prompted to install them automatically when you started &amarok; for the first time.
</para>
</sect3>
<sect3 id="i-have-the-codecs-but-amarok-still-wont-play-mp4s-and-mkas"><title>I have the codecs, but Amarok still won't play mp4s and mkas</title> 
<para>When using some phonon backend, like the gstreamer one, &amarok; might refuse to play <filename>mp4</filename> and <filename>mka</filename> files. This is a known problem, see <emphasis role="strikethrough"><ulink url="https://bugs.kde.org/show_bug.cgi?id=290168">bug #290168</ulink></emphasis> for more technical information.
</para>
<para>A very simple workaround is to change the file extension. Change <filename>mp4</filename> extension to <filename>m4a</filename> and for <filename>mka</filename> change it to <filename>mkv</filename>. Of course you must be sure the files contains audio only. You can use the ffprobe command to look at what data streams are present in the file. If the file has a video stream it must be stripped out. There are a lot of tools able to edit these formats and most of them are based on <filename>ffmpeg</filename>/<filename>libav</filename>, which you can use if you are familiar with them. If you prefer graphical tools one possible choice is <ulink url="http://www.avidemux.org/">avidemux</ulink>.
</para>
<para>This is a quick example how you can remove a video stream from an <filename>mp4</filename> video with ffmpeg. Stripping a video stream from an <filename>mkv</filename> file is the same. First check if there is a video stream
</para>
<para><userinput><command>$ ffprobe example.mp4 2&gt;&amp;1 | grep Video</command></userinput>
</para>
<para><screen><command>Stream #0.1(und): Video: h264 (Baseline), yuv420p, 480x360 [PAR 1:1 DAR 4:3], 242 kb/s, 25 fps, 25 tbr, 25k tbn, 50k tbc</command></screen>
</para>
<para>If the output of the previous command is null there is no video stream in the file. To create an <filename>m4a</filename> file with just the audio stream you can use something like
</para>
<para><screen>
ffmpeg -i example.mp4 -acodec copy -vn example.m4a
</screen>
</para>
<para>You can also use <filename>avconv</filename> in place of <filename>ffmpeg</filename> with the same options, where
</para>
<itemizedlist>
<listitem><para><emphasis>-i example.mp4</emphasis> option is the input file name</para></listitem>
<listitem><para><emphasis>-acodec copy</emphasis> is used to not encode again the audio stream but just copy it. This to avoid quality loss, but you can also encode in a different format if you want, and you are not forced to use m4a container in this case</para></listitem>
<listitem><para><emphasis>-vn</emphasis> strips the video stream</para></listitem>
<listitem><para><replaceable>example.m4a</replaceable> is the output file name</para></listitem>
</itemizedlist>
<para>Another possible workaround is to change the phonon backend. For example the VLC backend doesn't suffer this problem.
</para>
</sect3>
<sect3 id="i-have-a-second-soundcard-and-im-using-alsa--how-do-i-make-amarok-use-it-instead-of-the-default"><title>I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default?</title> 
<para> Configure this in the Phonon system settings module. <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure Amarok</guisubmenu><guimenuitem>Playback</guimenuitem><guimenuitem>Configure Phonon</guimenuitem></menuchoice>
</para>
</sect3>
<sect3 id="wheres-the-equalizer"><title>Where's the equalizer?</title> 
<para>The equalizer is only available if you are using the phonon-backend-gstreamer. You can find the equalizer in the <guilabel>Tools</guilabel> menu.
</para>
</sect3>
<sect3 id="how-can-i-control-the-volume-in-amarok-only-without-having-to-change-in-kmix"><title>How can I control the volume in Amarok only without having to change in KMix?</title> 
<para> Most distributions ship the <guilabel>PulseAudio</guilabel> sound-daemon nowadays which handles the sound settings system-wide. If you can't change the volume in &amarok; independently of &kmix;, then your <application>PulseAudio</application> settings have the option
</para>
<para> <userinput>flat-volume=yes</userinput>
</para>
<para>enabled. Depending on your distribution this is located either in the file <filename>$HOME/.pulse/daemon.conf</filename> or in the system file <filename>/etc/pulse/daemon.conf</filename>. More information about Pulseudio-specific settings can be found in <ulink url="http://linux.die.net/man/5/pulse-daemon.conf">pulse-daemon.conf man page</ulink>.
</para>
</sect3>
<sect3 id="how-do-i-turn-on-visualizations"><title>How do I turn on visualizations?</title> 
<para>Visualizations come in the form of an applet. For more information please see the <link linkend="applets">applets page</link>. Visualizations are currently under development and may be buggy at this time.
</para>
</sect3>
<sect3 id="how-can-i-add-podcasts"><title>How can I add podcasts?</title> 
<para>Go to <guilabel>Podcast</guilabel> section in the <guilabel>Media Sources</guilabel> pane and then select <guilabel>Add Podcast...</guilabel> Add the podcast URL where indicated. More about podcasts <link linkend="podcasts">here</link>.
</para>
<para>We also have some services, such as gpodder and Podcast Directory to help you find great podcasts. Enable services in the <guilabel>Settings</guilabel> menu: <menuchoice><guimenu>Configure Amarok</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>.
</para>
</sect3>
<sect3 id="how-can-i-use-amarok-to-stream-to-my-own-radio-station"><title>How can I use Amarok to stream to my own radio station?</title> 
<para>If you want to stream directly to an icecast or shoutcast server the answer simply is: it is not supported. You could use <ulink url="http://giss.tv/sahabuntu/doc/idjc.html">IDJC</ulink> for that.
</para>
</sect3>
</sect2>
<sect2 id="collection-questions"><title>Collection questions</title> 
<sect3 id="folder-not-properly-picked-up"><title>Folder not properly picked up</title> 
<para>If you find that most of your music is recognized by &amarok;, but some folders are not properly picked up, open a console and type
</para>
<para><userinput>touch <replaceable>folder</replaceable></userinput>
</para>
<para>where <replaceable>folder</replaceable> is the path to the folder that has the problem. Then select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Amarok</guimenuitem></menuchoice> in &amarok; main window menu, open <guilabel>Collection</guilabel> page and click the <guilabel>Full Rescan</guilabel> button. Your folder should be visible again now.
</para>
<para><warning><para> this will not work on Windows, as the touch command is specific to &Linux; and BSD-like systems.</para></warning>
</para>
</sect3>
<sect3 id="can-i-use-removable-media-inside-amarok"><title>Can I use removable media inside Amarok?</title> 
<para>&amarok; has a greatly improved support for the media devices based on Solid, the KDE hardware layer, that doesn't need a lot of configuration. You should be able to just plug in your device and access it within &amarok;. Also, thanks to the <emphasis>Dynamic Collections</emphasis>, your media devices could become part of your music collection, and be searchable and accessible within the <guilabel>Local Music</guilabel> section of the <guilabel>Media Sources</guilabel> pane when it's connected.
</para>
<para>You can transfer your songs, albums and artists from your local collection by right-clicking, selecting <guilabel>Copy to Collection</guilabel> and picking your device; and you can also do it in the other way: right-click and select <menuchoice><guimenu>Copy to Collection</guimenu><guimenuitem>Local Collection</guimenuitem></menuchoice>. More about &amarok; and devices <link linkend="working-with-media-devices">here</link>.
</para>
</sect3>
<sect3 id="can-i-use-the-old-amaroks-collection-in-amarok-two-will-my-tags-score-are-ratings-be-lost"><title>Can I use the old Amarok's collection in Amarok 2? Will my tags, score are ratings be lost?</title> 
<para>A database importer is available. You will be able to keep your ratings and statistics just fine. More <link linkend="collection">here</link>.
</para>
</sect3>
</sect2>
<sect2 id="general-questions"><title>General questions</title> 
<sect3 id="what-are-scripts"><title>What are scripts?</title> 
<para>They are little pieces of software that add some functions to &amarok;. There are a lot of scripts, and you can find them in <ulink url="http://www.kde-apps.org/index.php?xcontentmode=57">kde-apps.org</ulink> or you can find and install them inside &amarok; using the <guilabel>Script Manager</guilabel>. More details can be found <link linkend="script-manager">here</link>. You will find the <guilabel>Script Manager</guilabel> from the <guilabel>Settings</guilabel> menu, <menuchoice><guimenu>Configure Amarok</guimenu><guimenuitem>Scripts</guimenuitem></menuchoice>.
</para>
</sect3>
<sect3 id="can-i-use-amarok-one-four-scripts-in-amarok-2"><title>Can I use Amarok 1.4 scripts in Amarok 2?</title> 
<para>No. A new and powerful scripting API has been created, which provides huge improvements but won't let you use your old scripts. The new scripting system is based on QtScript and will significantly reduce &amarok;'s dependencies, a huge problem for non-technical and cross-platform users, and will greatly reduce the amount of external processes launched at runtime.  Another advantage is that the new API will allow much deeper integration with &amarok; than the old scripting system. <ulink url="http://community.kde.org/Amarok/Development/Script_API">Amarok Scripting API</ulink>.
</para>
</sect3>
<sect3 id="what-are-moodbars"><title>What are Moodbars?</title> 
<para><guilabel>Moodbars</guilabel> show the mood of a song in the progress bar. More about <guilabel>Moodbar</guilabel> <link linkend="the-moodbar">here</link>.
</para>
</sect3>
<sect3 id="can-i-play-video-files"><title>Can I play video files?</title> 
<para>&amarok; is mainly a music player so no video file management, collection support, DVD playback, subtitles, or any other sophisticated features are available.
</para>
</sect3>
<sect3 id="is-it-amarok-amarok-or-amarok"><title>Is it Amarok, AmaroK or amaroK?</title> 
<para>It is &amarok;! The former spelling was <emphasis>amaroK</emphasis>, but it was changed due to its strange look around 2005.
</para>
</sect3>
<sect3 id="how-are-track-scores-determined"><title>How are track scores determined?</title> 
<para>&amarok; assigns a score (a number 0-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing.  Every time the song finishes playing, the score is changed.
</para>
<para>Here you have an example script that can calculate scores:
</para>
<para><screen>if( playcount &lt;= 0 ) # not supposed to be less, but what the hell.
       newscore = ( prevscore + percentage ) / 2
   else
       newscore = ( ( prevscore * playcount ) + percentage ) / ( playcount + 1 )
   end
</screen>
</para>
<para>You can easily create your own script with your own algorithm. Look at the <ulink url="http://community.kde.org/Amarok/Development/Scripting_HowTo_2.0">Script-Writing-Howto</ulink> for further information.
</para>
</sect3>
<sect3 id="how-do-i-manually-change-a-tracks-score"><title>How do I manually change a track's score?</title> 
<para>You may change the score manually in the <guilabel>Track Details</guilabel> dialog, available by right-clicking on a track, choosing <guilabel>Edit Track Details</guilabel> and going to the <guilabel>Summary</guilabel> tab.
</para>
</sect3>
<sect3 id="but-i-also-want-that-stars-system-like-in-other-players"><title>But I also want that stars system like in other players!</title> 
<para>&amarok;, of course, supports a user-defined rating system, and you can rate your tracks with a single click using the <guilabel>Current Track</guilabel> applet. You can also do this in the context menu (right-click) <menuchoice><guimenu>Edit Track Details</guimenu><guimenuitem>Summary</guimenuitem></menuchoice> tab. If you have the rating stars displayed in your playlist layout, you can also edit there, with the <emphasis>slow double-click</emphasis>.
</para>
</sect3>
<sect3 id="can-i-drag-and-drop-plasma-applets-from-the-main-window-to-the-desktop"><title>Can I drag and drop Plasma applets from the main window to the Desktop?</title> 
<para>No, but there are several Plasmoids available for your Desktop, which will let you display information provided by &amarok; as well as control &amarok;.
</para>
</sect3>
<sect3 id="how-can-i-save-a-stream"><title>How can I save a stream?</title> 
<para>First of all, load the stream into the playlist. There are several ways to do this: downloading the file and opening it with &amarok;; using the menu <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Add stream</guimenuitem></menuchoice>; among others.
</para>
<para>Once the stream is loaded, you can save it by clicking on <inlinemediaobject> <imageobject> <imagedata fileref="Icon-document-save.png" format="PNG"/> </imageobject> </inlinemediaobject> in the <guilabel>Playlist</guilabel> pane, and giving it a meaningful name. The Stream will then be added to the <guilabel>Saved Playlists</guilabel> view for later reference.
</para>
</sect3>
<sect3 id="where-do-i-find-the-settings-for-amarok"><title>Where do I find the settings for Amarok?</title> 
<para><userinput>`kde4-config --localprefix`/share/apps/amarok</userinput>
</para>
<para><userinput>`kde4-config --localprefix`/share/config/amarokrc</userinput>
</para>
</sect3>
</sect2>
<sect2 id="troubleshooting16"><title>Troubleshooting</title> 
<sect3 id="how-can-i-obtain-a-backtrace"><title>How can I obtain a backtrace?</title> 
<para>If &amarok; has crashed and you want to report it, visit the <ulink url="http://community.kde.org/Amarok/Development/DebuggingHowTo">Debugging HowTo</ulink>. The bug report must be made in <ulink url="http://bugs.kde.org">bugs.kde.org</ulink> after verifying if it has not already been reported.
</para>
</sect3>
<sect3 id="amarok-just-freezes-how-can-i-help-get-this-fixed"><title>Amarok just freezes! How can I help get this fixed?</title> 
<para>You can obtain a backtrace of a frozen instance of &amarok; using gdb like so:
</para>
<para><userinput>$ gdb -p `pidof amarok` 
(gdb) thread apply full bt all</userinput>  
</para>
<para>Then just post the backtrace to <ulink url="http://paste.kde.org/">PasteBin</ulink>, as described in the <ulink url="http://community.kde.org/Amarok/Development/DebuggingHowTo">Debugging HowTo</ulink>.
</para>
</sect3>
<sect3 id="amarok-takes-a-lot-of-time-to-start"><title>Amarok takes a lot of time to start</title> 
<para>If this happens you have to check what scripts you have installed and what internet services are running, because some of them may slow down the startup. Also, if you have streams in the playlist when you open &amarok;, the startup can take a little longer. The same happens if you have a great number of tracks in the playlist (over 300 and more).
</para>
<para>On the other hand, if you don't use KDE, but a different desktop environment, startup time can be increased very slightly because there are more libraries to be loaded.
</para>
</sect3>
</sect2>
<sect2 id="development-questions"><title>Development questions</title> 
<sect3 id="how-do-i-get-a-git-version-of-amarok"><title>How do I get a GIT version of Amarok?</title> 
<para>See the <ulink url="http://community.kde.org/Amarok/Development/Development_HowTo">Amarok Development build</ulink> instruction page. Check here for a local build: <ulink url="http://blogs.fsfe.org/myriam/2009/09/compiling-amarok-from-git-locally-full-summary/">Building from Git Locally: Full Summary</ulink>
</para>
</sect3>
<sect3 id="why-isnt-amarok-part-of-kde-multimedia"><title>Why isn't Amarok part of KDE Multimedia?</title> 
<para>Packages in the KDE Software Compilation proper have a release schedule that doesn't fit with &amarok;'s development pace, and since none of the other KDE applications depend on &amarok; there is no need to follow this release schedule.
</para>
</sect3>
<sect3 id="ive-found-a-bug---ive-got-a-great-idea-for-amarok"><title>I've found a bug / I've got a great idea for Amarok!</title> 
<para>Please report it at <ulink url="http://bugs.kde.org/enter_bug.cgi?product=amarok">bugs.kde.org</ulink>. If you have a list of suggestions or wishes it may be best to send them to our mailing list: <ulink url="mailto:amarok@kde.org">amarok@kde.org</ulink>. Simply posting the idea to our IRC channels or on an obscure wiki page or blog won't help much as the information will get lost.
</para>
</sect3>
<sect3 id="do-you-accept-patches"><title>Do you accept patches?</title> 
<para>Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret; we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of &amarok;. Submit your patches and code contributions to git.reviewboard.kde.org. See also <ulink url="http://blogs.fsfe.org/myriam/2010/09/how-to-submit-patches-for-amarok/">How to Submit Patches to &amarok;</ulink>. If you have a bug fix then just go ahead; this is open source after all. <inlinemediaobject> <imageobject> <imagedata fileref="Face-smile.png" format="PNG"/> </imageobject> </inlinemediaobject>
</para>
</sect3>
<sect3 id="why-did-you-choose-the-name-amarok"><title>Why did you choose the name Amarok?</title> 
<para><emphasis>Amarok</emphasis> is an album by British composer Mike Oldfield. Project founder Mark Kretschmann happens to like it a lot, and he thought the name had a nice sound. Plus, of course, it contains the all important <guilabel>K</guilabel>. <inlinemediaobject> <imageobject> <imagedata fileref="Face-smile.png" format="PNG"/> </imageobject> </inlinemediaobject>
</para>
</sect3>
</sect2>
</sect1>
</chapter>
<chapter id="references"><title>References</title> 
<itemizedlist>
<listitem><para><link linkend="menu-and-command-reference">Menu and Command Reference</link>&nbsp;<itemizedlist>
<listitem><para><link linkend="amarok-menu">Amarok Menu</link>&nbsp;</para></listitem>
<listitem><para><link linkend="view-menu">View Menu</link>&nbsp;</para></listitem>
<listitem><para><link linkend="playlist">Playlist Menu</link>&nbsp;</para></listitem>
<listitem><para><link linkend="tools-menu">Tools Menu</link>&nbsp;</para></listitem>
<listitem><para><link linkend="settings-menu">Settings Menu</link>&nbsp;</para></listitem>
<listitem><para><link linkend="help-menu">Help Menu</link>&nbsp;</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para><link linkend="keybinding-reference">Keybinding Reference</link>&nbsp;<itemizedlist>
<listitem><para><link linkend="kde-global-shortcuts">Global Shortcuts</link>&nbsp;</para></listitem>
<listitem><para><link linkend="amarok-shortcuts">Amarok Shortcuts</link>&nbsp;</para></listitem>
</itemizedlist>
</para></listitem>
<listitem><para><link linkend="credits-and-license">Credits and License</link>&nbsp;</para></listitem>
</itemizedlist>
<sect1 id="menu-and-command-reference"><title>Menu and Command Reference</title> 
<sect2 id="amarok-top-level-menus"><title>Amarok Top-level Menus</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amaroktoplevelmenus2-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>&amarok;</para>
    </entry>
    <entry>
    <para><link linkend="amarok-menu">Common actions such as Play, Pause, &etc;</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>View</guilabel></para>
    </entry>
    <entry>
    <para><link linkend="view-menu">Change the layout of Amarok</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Playlist</guilabel></para>
    </entry>
    <entry>
    <para><link linkend="playlist">Configure your Playlist</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Tools</guilabel></para>
    </entry>
    <entry>
    <para><link linkend="tools-menu">Start additional tools and scripts</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Settings</guilabel></para>
    </entry>
    <entry>
    <para><link linkend="settings-menu">Change settings and configure Amarok</link>&nbsp;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Help</guilabel></para>
    </entry>
    <entry>
    <para><link linkend="help-menu">Important information about Amarok and KDE</link>&nbsp;</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
<sect2 id="amarok-menu"><title>Amarok Menu</title> 
<para>Some of the common actions in &amarok; are here, mostly to control media playback.
</para>
</sect2>
<sect2 id="contents17"><title>Contents</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_amarokmenu2-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Amarok Menu</phrase>
    </textobject>
    <caption>
      <para>The Amarok Menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
    <entry>Shortcut</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Play Media...</guilabel></para>
    </entry>
    <entry>
    <para>Opens a media file to be played.</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>O</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Previous Track</guilabel></para>
    </entry>
    <entry>
    <para>Skips back to the last track played within your current session.</para>
    </entry>
    <entry>
    <para></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Play/Pause</guilabel></para>
    </entry>
    <entry>
    <para>Starts or temporarily stops the playing of the current media file.</para>
    </entry>
    <entry>
    <para><keycap>Space</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Stop</guilabel></para>
    </entry>
    <entry>
    <para>Stops all playback in progress.</para>
    </entry>
    <entry>
    <para></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Stop after current Track</guilabel></para>
    </entry>
    <entry>
    <para>Waits until the current track ends before stopping the playback. This is useful when using a playlist.</para>
    </entry>
    <entry>
    <para></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Next Track</guilabel></para>
    </entry>
    <entry>
    <para>Skips playback to the next media file in your playlist.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Quit</guilabel></para>
    </entry>
    <entry>
    <para>Exits out of &amarok;.</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Q</keycap></keycombo></para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
</sect1>
<sect1 id="view-menu"><title>View Menu</title> 
<para>This top-level menu contains options to adjust the layout of &amarok;, and a checkbox to lock the configuration; use this to prevent any accidental changes to the &amarok; window layout.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6viewconfigmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>View Menu</phrase>
    </textobject>
    <caption>
      <para>View Menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<sect2 id="changing-the-amarok-toolbar"><title>Changing the Amarok Toolbar</title> 
<para>There are also two radio buttons in this menu, which are used to choose which <emphasis>Toolbar</emphasis> &amarok; will use.  The <emphasis>Main Toolbar</emphasis> has a larger height and slightly different controls than the <emphasis>Slim Toolbar.</emphasis>  The <emphasis>Main Toolbar</emphasis> contains two main control buttons: a <guilabel>Play</guilabel> / <guilabel>Pause</guilabel> button and a button for controlling the volume.  It also displays the name of the current media file and a slider for showing, as well as changing, the position of playback. More about <link linkend="toolbar">the Toolbar</link>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_main_toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Main Toolbar</phrase>
    </textobject>
    <caption>
      <para>The Main Toolbar</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_slim_toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Slim Toolbar</phrase>
    </textobject>
    <caption>
      <para>The Slim Toolbar</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="amarok-window-layouts"><title>Amarok Window Layouts</title> 
<para>If the <guilabel>Lock Layout</guilabel> button is unchecked, the <emphasis>Media Sources</emphasis>, <emphasis>Context</emphasis> and <emphasis>Playlist</emphasis> tabs can be toggled and many layouts can be created as shown below:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout11.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout26.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout28.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout22.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout27.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout25.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout23.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_layout24.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-6_layout.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
<sect2 id="playlist-menu"><title>Playlist Menu</title> 
<para>This is a top-level drop down menu where can configure your <guilabel>Playlist</guilabel>. From here you can add more tracks, streaming radio channels, and clean your playlist.
</para>
<sect3 id="menu-items"><title>Menu Items</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Amarok Playlist Menu</phrase>
    </textobject>
    <caption>
      <para>The Amarok Playlist Menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="3">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
    <entry>Shortcut</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Add Media...</guilabel></para>
    </entry>
    <entry>
    <para>Opens a media file to be played in &amarok;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Add Stream...</guilabel></para>
    </entry>
    <entry>
    <para>Choose different streaming radio channels using the <emphasis>URL bar</emphasis>, by pasting or typing the link</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Export Playlist As...</guilabel></para>
    </entry>
    <entry>
    <para>Save your favorite playlists in various formats - mp3 streaming, Shoutcast, xspf</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Undo</guilabel></para>
    </entry>
    <entry>
    <para>Go one step backward</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Z</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Redo</guilabel></para>
    </entry>
    <entry>
    <para>Click <quote>Redo</quote> to do the last step over again</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Clear PlayList</guilabel></para>
    </entry>
    <entry>
    <para>Cleans the current playlist</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Remove Duplicates</guilabel></para>
    </entry>
    <entry>
    <para>Removes duplicate entries in the playlist</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Playlist Layouts</guilabel></para>
    </entry>
    <entry>
    <para>Changes the visual style of the <guilabel>Playlist</guilabel></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Edit Queue</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to change the order of your queue</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="playlist-layouts"><title>Playlist Layouts</title> 
<para>From <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Playlist Layouts</guimenuitem></menuchoice> switch between different layouts with radio buttons, and configure your personal <guilabel>Playlist</guilabel> layout.
</para>
<sect4 id="default"><title>Default</title> 
<para><menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>Default</guimenuitem></menuchoice>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistlayout1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_layout_d_ss.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="no-grouping"><title>No Grouping</title> 
<para><menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>No Grouping</guimenuitem></menuchoice>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistlayout2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_layout_nog1_s.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="no-grouping-single-line"><title>No Grouping (Single line)</title> 
<para><menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>No Grouping(Single line)</guimenuitem></menuchoice>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistlayout3.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_layout_nog2_s.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="verbose"><title>Verbose</title> 
<para><menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>Verbose</guimenuitem></menuchoice>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playlistlayout4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_layout_v1_s.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect4>
<sect4 id="configure-playlist-layout---"><title>Configure playlist layout...</title> 
<para><menuchoice><guimenu>Playlist</guimenu><guisubmenu>Playlist Layouts</guisubmenu><guimenuitem>Configure playlist layout...</guimenuitem></menuchoice>
</para>
<para>This option allows you to make your own <guilabel>Playlist</guilabel> layout; display Artist, Genre, Year, BPM and so forth.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_playlist_layout_editor.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Make your own layout</phrase>
    </textobject>
    <caption>
      <para>Make your own layout</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
</sect4>
</sect3>
</sect2>
<sect2 id="tools-menu"><title>Tools Menu</title> 
<para>From this menu you can use additional tools and scripts.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok_2-8_menutools.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Tools Menu</phrase>
    </textobject>
    <caption>
      <para>The Tools Menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Bookmark Manager</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to save bookmarks of various types.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Cover Manager</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to view album covers and fetch missing ones.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Equalizer</guilabel></para>
    </entry>
    <entry>
    <para>Shows the equalizer.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Network Request Viewer</guilabel></para>
    </entry>
    <entry>
    <para>Shows the Network Requests Viewer.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Update Collection</guilabel></para>
    </entry>
    <entry>
    <para>Checks the tracks in your collection and updates the database.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Synchronize Statistics..</guilabel></para>
    </entry>
    <entry>
    <para>Opens the Statistics Synchronization dialog.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect3 id="bookmark-manager"><title>Bookmark Manager</title> 
<para>The bookmark manager allows you to bookmark different kinds of things to recall them later. You can also create folders to organize your collection of bookmarks. The search box provides a convenient way to find bookmarks. The context menu offers the possibility to <guilabel>Load</guilabel> and <guilabel>Delete</guilabel> the bookmark.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tools_bookmarkmanager.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Bookmark Context View Applets</guilabel></para>
    </entry>
    <entry>
    <para>Saves the currently used view applets.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Bookmark Media Source View</guilabel></para>
    </entry>
    <entry>
    <para>Saves the current view of the media source tree.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Bookmark Playlist Setup</guilabel></para>
    </entry>
    <entry>
    <para>Saves the current playlist setup.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Bookmark Track Position</guilabel></para>
    </entry>
    <entry>
    <para>Saves the position in the current track.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
<sect3 id="cover-manager18"><title>Cover Manager</title>  
<para>Shows all albums in your collection. Here you can set custom album covers and fetch missing ones. More about the <link linkend="cover-manager">Cover Manager</link>, shown below.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tools_covermanager.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="equalizer"><title>Equalizer</title> 
<para>Provides the possibility to configure sound settings. You can choose between manually adjusting the settings and using templates. Right now, the <emphasis>Phonon</emphasis> <emphasis>GStreamer</emphasis> is required for a functional equalizer.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tools_equalizer.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="network-requests-viewer"><title>Network Requests Viewer</title> 
<para>The <guilabel>Network Requests Viewer</guilabel> allows you to monitor the network requests made by &amarok;. Selecting this option will open this window:
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-7networkrequestsviewer.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="update-collection"><title>Update Collection</title> 
<para>Checks the files in the folders you defined as your collection. New files will be added and missing ones removed from the left pane.
</para>
</sect3>
<sect3 id="synchronize-statistics"><title>Synchronize Statistics</title> 
<para>This option allows you to synchronize statistics of your various collections. This is a new feature in &amarok; since version 2.7 For more information, see also <link linkend="statistics-synchronization">Statistics Synchronization Between Collections and with Last.fm</link> in the handbook.
</para>
</sect3>
</sect2>
<sect2 id="settings-menu"><title>Settings Menu</title> 
<para>Here is where you change settings and configure &amarok;.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok24_settingsmenu_withreplaygain.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Amarok Settings Menu</phrase>
    </textobject>
    <caption>
      <para>The Amarok Settings Menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Show Menubar</guilabel></para>
    </entry>
    <entry>
    <para>Hide the menu bar. Show it again by pressing <keycombo>&Ctrl;<keycap>M</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Replay Gain Mode</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to set the Replay Gain mode; <guilabel>Off</guilabel>, by <guilabel>Track</guilabel>, or by <guilabel>Album</guilabel></para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Configure Shortcuts...</guilabel></para>
    </entry>
    <entry>
    <para>Allows you to make custom keyboard shortcuts</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Configure Amarok...</guilabel></para>
    </entry>
    <entry>
    <para>Configure General options, Internet Services, Playback, Notifications, and Database</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<sect3 id="show-menubar"><title>Show Menubar</title> 
<para>Clicking this option will hide the menu bar.
</para>
<para>The only way to show the menu bar again is by pressing <keycombo>&Ctrl;<keycap>M</keycap></keycombo>, because you can't de-select the menu option when no menu bar is shown. More about the <link linkend="menu-and-command-reference">Menus in the Menubar</link>.
</para>
</sect3>
<sect3 id="replay-gain-mode"><title>Replay Gain Mode</title> 
<para>The replay gain mode will change the volume depending on meta information of the track. More about replay gain: <ulink url="http://en.wikipedia.org/wiki/Replay_Gain">Wikipedia entry for replay gain</ulink>.
</para>
<para>You can switch the replay gain mechanism off, use a track-based or the album-based replay gain.
</para>
</sect3>
<sect3 id="configure-shortcuts---"><title>Configure Shortcuts...</title> 
<para>Change and define new keyboard shortcuts, or turn on multimedia keys if your keyboard has them. More about <link linkend="keybinding-reference">Shortcuts</link>.
</para>
</sect3>
<sect3 id="configure-amarok---"><title>Configure Amarok...</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6configgeneralmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Configure Amarok</phrase>
    </textobject>
    <caption>
      <para>Configure Amarok</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>Configure many aspects of &amarok;. Details in <link linkend="configuring-amarok">Configuring Amarok</link>.
</para>
</sect3>
</sect2>
<sect2 id="help-menu"><title>Help Menu</title> 
<para>Important information about &amarok; and KDE.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok2-6helpmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Amarok help menu</phrase>
    </textobject>
    <caption>
      <para>The Amarok help menu</para>
    </caption>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Menu Item</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Report Bug...</guilabel></para>
    </entry>
    <entry>
    <para>Report bugs to the bug tracker directly, with much of your information automatically supplied to the database form.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Amarok Handbook</guilabel></para>
    </entry>
    <entry>
    <para>This Handbook in Docbook format.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Send a Comment to the Developers</guilabel></para>
    </entry>
    <entry>
    <para>Send a brief comment to &amarok; developers. Do NOT use to send bug reports.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Show Feedback Icons</guilabel></para>
    </entry>
    <entry>
    <para>Check to show feedback icons on every &amarok; screen and sub-menu.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Switch Application Language...</guilabel></para>
    </entry>
    <entry>
    <para>Change &amarok; menus and label language or back-up language.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>About Amarok</guilabel></para>
    </entry>
    <entry>
    <para>&amarok; version, web site, contributors and donors.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Diagnostics</guilabel></para>
    </entry>
    <entry>
    <para>Displays complete information necessary for filing good bug reports, such as Amarok Version, KDE, Qt, Phonon, and Phonon Backend versions, and whether or not PulseAudio is installed, as well as what Amarok Scripts are installed, and whether or not they are running. There is a button on the bottom to copy the information to the clipboard.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>About KDE</guilabel></para>
    </entry>
    <entry>
    <para>Information about KDE, and links to join and support KDE.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect2>
</sect1>
</chapter>
<chapter id="keybinding-reference"><title>Keybinding Reference</title> 
<sect1 id="keyboard-shortcuts"><title>Keyboard Shortcuts</title> 
<para>Keyboard shortcuts let you quickly access &amarok;<command>'s</command> power. Change the shortcuts using <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok24_settingsmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>Shortcuts are divided into two groups:
</para>
<itemizedlist>
<listitem><para><link linkend="kde-global-shortcuts">Global Shortcuts</link>&nbsp;</para></listitem>
<listitem><para><link linkend="amarok-shortcuts">Amarok Shortcuts</link>&nbsp;</para></listitem>
</itemizedlist>
</sect1>
<sect1 id="control-from-console"><title>Control from Console</title> 
<para>To control &amarok; from the console, type <userinput>amarok --help-all</userinput> for a current complete list of available commands.
</para>
<sect2 id="kde-global-shortcuts"><title>KDE Global Shortcuts</title> 
<para><emphasis>Global Shortcuts</emphasis> are KDE's control key combinations. Use them to control &amarok; from the keyboard as an alternative to using the mouse.
</para>
<sect3 id="default-global-shortcuts"><title>Default Global Shortcuts</title> 
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Action</entry>
    <entry>Default Global Shortcut</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>Add Media...</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>A</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Decrease Volume</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>-</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Increase Volume</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>+</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Last.fm: Love Current Track</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>L</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Last.fm: Skip Current Track</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>S</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Mute Volume</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>M</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Next Track</para>
    </entry>
    <entry>
    <para><keycap>Media Next</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Play/Pause</para>
    </entry>
    <entry>
    <para><keycap>Media Play</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Stop</para>
    </entry>
    <entry>
    <para><keycap>Media Stop</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Previous Track</para>
    </entry>
    <entry>
    <para><keycap>Media Previous</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rate Current Track: 1 star</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>1</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rate Current Track: 2 stars</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>2</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rate Current Track: 3 stars</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>3</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rate Current Track: 4 stars</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>4</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rate Current Track: 5 stars</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>5</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Backward</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap>&Shift;<keycap>-</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Forward</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap>&Shift;<keycap>+</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Show Notification Popup</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>O</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Toggle Main Window</para>
    </entry>
    <entry>
    <para><keycombo><keycap>Meta</keycap><keycap>P</keycap></keycombo></para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
</sect3>
</sect2>
<sect2 id="amarok-shortcuts"><title>Amarok Shortcuts</title> 
<para>Control &amarok; using <emphasis>keyboard shortcuts</emphasis>, which are combinations of keys which each control a specific action. &amarok; has default shortcuts, but you can also make your own.
</para>
<sect3 id="default-shortcuts"><title>Default Shortcuts</title> 
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Action</entry>
    <entry>Shortcut</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para>Increase Volume</para>
    </entry>
    <entry>
    <para><keycap>+</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Decrease Volume</para>
    </entry>
    <entry>
    <para><keycap>-</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Edit Details of Currently Selected Track</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>E</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Search in Playlist</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>J</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Shuffle Playlist</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>H</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Play Media...</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>O</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Play/Pause</para>
    </entry>
    <entry>
    <para><keycap>Space</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Previous Browser</para>
    </entry>
    <entry>
    <para>&Backspace;</para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Copy the Currently Playing Artist and Title to the Clipboard</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>C</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Queue Track</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>D</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Quit</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Q</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Redo</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Forward By 2 seconds*</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Right</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Forward By 10 seconds*</para>
    </entry>
    <entry>
    <para><keycap>Right</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Forward By 60 seconds*</para>
    </entry>
    <entry>
    <para><keycombo>&Shift;<keycap>Right</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Backward By 2 seconds*</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Left</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Backward By 10 seconds*</para>
    </entry>
    <entry>
    <para><keycap>Left</keycap></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Seek Backward by 60 seconds*</para>
    </entry>
    <entry>
    <para><keycombo>&Shift;<keycap>Left</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Activate Search Bar</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>F</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Toggle Full Screen</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;&Shift;<keycap>F</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Undo</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>Z</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Save Playlist</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>S</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Select all</para>
    </entry>
    <entry>
    <para><keycombo>&Ctrl;<keycap>A</keycap></keycombo></para>
    </entry>
  </row>
  <row>
    <entry>
    <para>Rename</para>
    </entry>
    <entry>
    <para><keycap>F2</keycap></para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<itemizedlist>
<listitem><para>These durations are configurable in the <filename>amarokrc</filename>.</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="how-to-make-shortcuts"><title>How to make shortcuts</title> 
<para>You can configure shortcuts from <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice> where you can change or make new shortcuts.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok24_settingsmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<sect2 id="how-to-use-configure-shortcuts---"><title>How to use Configure Shortcuts...</title> 
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok24_configureshortcutsdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para>
<informaltable>
  <tgroup cols="2">
  <thead>
  <row>
    <entry>Button</entry>
    <entry>Description</entry>
  </row>
  </thead>
  <tbody>
  <row>
    <entry>
    <para><guilabel>Search</guilabel></para>
    </entry>
    <entry>
    <para>Search Actions and Shortcuts.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Details</guilabel></para>
    </entry>
    <entry>
    <para>Add, remove and get more information about shortcut schemes.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Reset to Defaults</guilabel></para>
    </entry>
    <entry>
    <para>Reset all custom shortcuts back to default.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Print</guilabel></para>
    </entry>
    <entry>
    <para>Print the list of shortcuts.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>OK</guilabel></para>
    </entry>
    <entry>
    <para>Save all changes.</para>
    </entry>
  </row>
  <row>
    <entry>
    <para><guilabel>Cancel</guilabel></para>
    </entry>
    <entry>
    <para>Close window without saving changes.</para></entry>
  </row>
  </tbody>
  </tgroup>
</informaltable>
</para>
<para>When you select an action, that opens a sub-window where you can choose between two radio buttons, <guilabel>Default</guilabel> and <guilabel>Custom</guilabel>. If you choose <guilabel>Default</guilabel> you'll use the default shortcut. If you choose <guilabel>Custom</guilabel> you'll configure and use your shortcut for this action.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="amarok24_configureshortcutdetail.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase></phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
</chapter>
<chapter id="credits-and-license"><title>Credits and License</title> 
<sect1 id="program-copyright"><title>Program copyright</title> 
<para>Copyright 2002, 2003 Mark Kretschmann (kretschmann kde.org).
</para>
<para>Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The Amarok Development Squad
</para>
</sect1>
<sect1 id="documentation-copyright"><title>Documentation copyright</title> 
<para><note><para>Please add your name here if you contribute to the handbook. Please respect alphabetical order</para></note>
</para>
<para>Abhishek Rane (abhishektux gmail.com)
</para>
<para>Adrián Chaves Fernández (adriyetichaves gmail.com)
</para>
<para>Caleb Bryant (c.bryant.30 gmail.com)
</para>
<para>Daniel Marth (danielmarth gmx.at)
</para>
<para>Dima Panov (fluffy freebsd.org)
</para>
<para>Dion Moult ()
</para>
<para>Emilio Castro González (periliocastrol gmail.com)
</para>
<para>eqisow ()
</para>
<para>Geoffry Song (goffrie gmail.com)
</para>
<para>Jeff Mitchell (mitchell kde.org)
</para>
<para>José Antonio Rey (joseeantonior ubuntu.com)
</para>
<para>Lydia Pintscher (lydia kde.org)
</para>
<para>Mayank Madan (mayankmadan live.com)
</para>
<para>Myriam Schweingruber (myriam kde.org)
</para>
<para>Nick Adams (runey676 gmail.com)
</para>
<para>Paul Ivan (bit.alex001 gmail.com)
</para>
<para>Pedro Raimundo (pedrooraimundo gmail.com)
</para>
<para>Pete Daniels (pete guerrillatechsupport.com), screenshots
</para>
<para>Salma Sultana (salma4534 yahoo.com)
</para>
<para>Sash Karttunen (sasu.karttunen tpnet.fi)
</para>
<para>tris r ()
</para>
<para>Valorie Zimmerman (valorie.zimmerman gmail.com)
</para>
<para>Walter P. Little (walterplittle gmail.com)
</para>
<para>Willem Ferguson (willemferguson zoology.up.ac.za)
</para>
</sect1>
<sect1 id="licenses"><title>Licenses</title> 
<para>This documentation is licensed under the terms of the <ulink url="http://userbase.kde.org/Special:myLanguage/KDE_UserBase_Wiki:Copyrights">GNU Free Documentation License</ulink>.
</para>
<para>This program is licensed under the terms of the <ulink url="http://www.gnu.org/licenses/gpl-2.0.txt">GNU General Public License</ulink>.
</para>

<!--userbase-content-->
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->  
&underFDL;
</sect1>
</chapter>
&documentation.index;
</book>
