<chapter id="using-kapp">
<title>Using &amarok;</title>

<para>&amarok; is a versatile audio player that offers many different ways of controlling your music collection. Like any ordinary audio player, &amarok; has a player window for controlling your most basic functions. &amarok; also has a playlist that is second to none. The playlist window has multiple browsers for creating and browsing your entire audio collection.</para>

<para>In this chapter we will go over how to use all the features of &amarok; including creating a collection and a playlist.</para>

<sect1 id="player-window">
<title>The Player Window</title>

<screenshot>
	<screeninfo>Player Window Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="player_window.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>


<para>The player window is your one click &amarok; control center. At the top of the player there is a scrolling display to show the currently playing track or stream. Just below the scrolling display there is an area to display the current track's play time, bit rate, and sample rate. Clicking this area will change the track time from total played to total time remaining.</para>

<para>The player window also features a selection of audio analyzers also located under the scrolling display. You can cycle through the available analyzers by left clicking the analyzer area.</para>

<anchor id="analyzer-tip"/>

<tip>

<screenshot>
	<screeninfo>Analyzer Tip</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="analyzer.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The &amarok; player analyzers can be detached from the player window. By pressing <keycap>d</keycap> on your keyboard the active analyzer will open in an independent, re-sizeable window.</para>
</tip>

<para>Also below the scrolling display are the <guibutton>PL</guibutton> and <guibutton>FX</guibutton> buttons. The <guibutton>PL</guibutton> button is used to quickly enable or disable the playlist window, while the <guibutton>FX</guibutton> button is used to configure your available sound system effects.</para>

<para>The remainder of the player includes the playback buttons and the volume and track position sliders. Use the sliders to choose a track postion or volume level that suits your needs. Use the playback buttons to control the playback of the current track, or to skip either forward or back through your tracks.</para>

</sect1>

<sect1 id="equalizer">
<title>The Equalizer Window</title>

<screenshot>
	<screeninfo>Equalizer Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="equalizer.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The equalizer is similar to the equalizers found in other media players. Checking the <guilabel>Enable Equalizer</guilabel> check box activates the equalizer and enables the sliders to adjust the levels in the equalizer to suit your listening needs.</para>

<para>The equalizer can be found in the <link linkend="rmb-menu">right mouse button menu</link>. You can also find it in the <link linkend="menubar">Menubar</link> by selecting <menuchoice><guimenu>Tools</guimenu> <guimenuitem>Equalizer</guimenuitem></menuchoice>.</para>

</sect1>

<sect1 id="playlist-window">
<title>The Playlist Window</title>

<screenshot>
	<screeninfo>Playlist Window Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="playlist_window.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The &amarok; playlist is the most advanced playlist available to any audio player for &kde;. The playlist offers many features that are not found in any other player. You should not be intimidated by the power of the playlist however, as it is still the easiest to use.</para>

<para>The playlist window can be divided into two main sections, on the left is the sidebar. The sidebar is where you will find some of the excellent features of the playlist like the <link linkend="context-browser">Context Browser</link>. On the right side of the window is the playlist itself. The playlist is simple to use yet powerful enough for even the most advanced users.</para>
</sect1>


<sect1 id="playlist-browsers">
<title>The Sidebar Browsers</title>

<para>The Sidebar Browsers transform the &amarok; playlist into a complete media management tool. From adding media to your collection to suggesting other tracks to listen to, the Sidebar Browsers do it all. You will also find full iPod support along with browsers for handling playlists and browsing your filesystem.</para>

<para>In this section there is all the information you need to get the most out of the Sidebar Browsers, and as you will see, the Browsers will have you listening to your music in a whole new way.</para>

<sect2 id="context-browser">
<title>Context Browser</title>

<screenshot>
	<screeninfo>Context Screenshot</screeninfo>
	<mediaobject>
	<imageobject><imagedata fileref="context.png" format="PNG"/></imageobject>
	</mediaobject>
</screenshot>

<para>The Context Browser is a tabbed browser that provides many different kinds of information about the currently playing track, and your music collection in general.</para>

<sect3 id="home-tab">
<title>The Home Tab</title>

<para>The <guilabel>Home</guilabel> Tab offers information about your entire music collection. In this tab you will find the <guilabel>Your Favorite Tracks</guilabel>, <guilabel>Your Newest Tracks</guilabel>, and <guilabel>Least Listened Songs</guilabel> panes.</para>

<para>The <guilabel>Your Favorite Tracks</guilabel> pane lists the ten highest rated tracks in your collection.</para>

<para>The <guilabel>Your Newest Tracks</guilabel> pane lists the five most recently added tracks in your collection.</para>

<para>The <guilabel>Least Listened Songs</guilabel> pane lists the five least listened to tracks in your collection. These are tracks that were once played, but have not been played in a while.</para>

<note><para>Clicking an item in any of these panes will begin playback of the track.</para></note>

</sect3>


<sect3 id="current-track-tab">
<title>The Current Track Tab</title>

<para>The <guilabel>Current Track</guilabel> Tab offers information about the currently playing track, and it's artist and album.</para>

<para>The first pane in this tab is for information about the track. The title of the pane lists the track name, artist name, and album. Inside the pane you will find it shows the album cover image for the track. Next to the image you will find a <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> icon. <inlinemediaobject><imageobject><imagedata fileref="musicbrainz.png" format="PNG"/></imageobject></inlinemediaobject> Click this icon to do a MusicBrainz look-up for the track.</para>

<para>Below the MusicBrainz icon there is more information about you current track. Here you will find the total number of times the track has been played, the track's current core, and when the track was First and Last played.</para>

<tip><para>To display album cover images in the Context Browser you must have the album cover image in the same directory as the track you are listening to. Supported file formats are .jpg, .jpeg, .gif, and .png. The images can be named anything, but images with the word <quote>front</quote> in the filename will be used with preference. The Context Browser will also use cover images saved from the album cover downloader, or images embedded in ID3v2 tags.</para></tip>

<para>The next pane, <guilabel>Suggested Songs</guilabel>, lists multiple tracks for suggested listening. Click on any of the listed tracks to begin playback of the track.</para>

<para>Below <guilabel>Suggested Songs</guilabel> is the <guilabel>Favorite Tracks By Artist</guilabel>. This pane lists the five highest rated tracks by the current track's artist.</para>

<para>The last pane, <guilabel>Albums By Artists</guilabel>, lists all of the albums by the current track's artists that are in your collection. Clicking on any of the albums in this pane will expand the album to show the album's content.</para>

<tip><para>You can click on tracks in any of the panes to begin playback of the track. You can also right click albums and tracks for a pop-up menu to choose several ways to play or enqueue the track or album.</para></tip>

</sect3>


<sect3 id="lyrics">
<title>The Lyrics Tab</title>

<para>The <guilabel>Lyrics</guilabel> Tab has a single pane that is used to display the lyrics to the currently playing track if they are available.</para>

</sect3>


</sect2>



<sect2 id="collection-browser">
<title>Collection Browser</title>

<screenshot>
	<screeninfo>Collection Browser Screenshot</screeninfo>
	<mediaobject>
	<imageobject><imagedata fileref="collection.png" format="PNG"/></imageobject>
	</mediaobject>
</screenshot>

<para>The Collection Browser is used to view your audio collection in a Tree View. In order to use the Collection Browser, you must setup the directories to use for your collection. Clicking the <guibutton>Configure Folders..</guibutton> button in the Collection Browser toolbar will start a dialog for adding directories to your collection.</para>

<note><para>If you enabled the <guilabel>Watch folders for changes</guilabel> option in the <guilabel>Configure Collection</guilabel> dialog you may notice that changes may not be updated instantly. This is because the normal behavior of the Collection Browser is to update automatically every 30 seconds.</para></note>

<para>Once your directories have been scanned, you will see your collection in a tree view. The tree view is organized by <guimenuitem>First</guimenuitem>, <guimenuitem>Second</guimenuitem> and <guimenuitem>Third</guimenuitem> Levels. The Levels can represent the tracks Album, Artist, Genre, or Year. Selecting the <guimenuitem>First</guimenuitem>, <guimenuitem>Second</guimenuitem>, or <guimenuitem>Third</guimenuitem> Level entries in the <guimenuitem>Tag Filter</guimenuitem> menu will allow to set what the branches represent.</para>

<note><para>The Collection Browser also features a Flat View. You can choose the Flat View by clicking the <guibutton>Flat View</guibutton> button in the Collection Browser toolbar. In the Flat View your collection will first appear to be empty. You can now start entering text into the search text box. After three or more characters are entered you will begin to see the results in the Flat View. You can begin another search by clicking the <guibutton>Clear Filter</guibutton> button next to the text box, and then enter more text in the text box.</para></note>

<para>At the top of the Collection Browser is a search bar for searching your collection. The Collection Browser will show only the items that contain the search string you type in the text box. Once you are done searching, you can click the clear button to clear the search field.</para>

<para>The Collection Browser also supports downloading of album cover images. To download an album cover  you can simply right click an item in the Collection Browser and select <guimenuitem>Fetch Cover Images</guimenuitem>. The cover downloader will open a window to display the downloaded image allowing you to save the image or perform a new search with a more specific search string.</para>

<para>Included with the cover downloader is an <link linkend="cover-manager">Album Cover Manager</link>. You can launch the Cover Manager by selecting <menuchoice><guimenu>Actions</guimenu><guimenuitem>Cover Manager</guimenuitem></menuchoice>.</para>
</sect2>


<sect2 id="playlist-browser">
<title>Playlist Browser</title>

<screenshot>
	<screeninfo>Playlist Browser Screenshot</screeninfo>
	<mediaobject>
	<imageobject><imagedata fileref="pl_browser.png" format="PNG"/></imageobject>
	</mediaobject>
</screenshot>

<para>The Playlist Browser is used for easy handling of your multiple playlists. The Playlist Browser also features built in smart playlists making it the most clever playlist browser around.</para>

<para>The Playlist Browser is divided into two sections, Playlists and Smart Playlists. The Playlists sections is for your own custom playlists. You can view the contents of your playlists in a list view by clicking the <quote>+</quote> symbol found next to each of the listed playlists. When you view a playlist in the list view new items can be added to the playlist by dragging and dropping them into the view. When you have found a playlist that you would like to load, you can double click the playlist, or press the <keycap>Space Bar</keycap> to have &amarok; load it. The other Playlist Browser keyboard shortcuts can be found in the <link linkend="keybd-shortcuts">Keyboard Shortcuts section</link>.</para>

<tip><para>When you save a new playlist from the Playlist Window it is automatically added to the Playlist section.</para></tip>

<para>The bottom section of the Playlist Browser is the Smart Playlists. The Smart Playlists use &amarok;'s built in data base to compile some useful playlists on the fly. The Smart Playlists include the following.</para>

<para>All Collection: a playlist with all the tracks that are in your configured collection.</para>

<para>Favorite Tracks: multiple playlists of the fifteen highest rated tracks in a listview by artitst.</para>

<para>Most Played: multiple playlists of the fifteen most played tracks in a listview by artitst.</para>

<para>Newest Tracks: multiple playlists of the fifteen most recently added tracks in a listview by artitst.</para>

<para>Last Played: a playlist of the fifteen most recently played tracks in your collection.</para>

<para>Never Played: a playlist of the tracks in your collection which have never been played before.</para>

<para>Genres: multiple playlists in a listview ordered by genre.</para>

<para>User defined smart playlists are also possible. Clicking the <guibutton>Create Smart-Playlist</guibutton> button will open a dialog to configure a smart playlist to fit your criteria.</para>

</sect2>


<sect2 id="media-device-browser">
<title>Media Device Browser</title>

<screenshot>
	<screeninfo>Media Device Browser Screenshot</screeninfo>
	<mediaobject>
	<imageobject><imagedata fileref="media_device.png" format="PNG"/></imageobject>
	</mediaobject>
</screenshot>

<para>The Media Device panel is used for connecting your audio device, such as an iPod, to &amarok;.</para>

</sect2>

<sect2 id="file-browser">
<title>File Browser</title>

<screenshot>
	<screeninfo>File Browser Screenshot</screeninfo>
	<mediaobject>
	<imageobject><imagedata fileref="file_browser.png" format="PNG"/></imageobject>
	</mediaobject>
</screenshot>

<para>The File Browser panel is like a mini konqueror embedded into the playlist. You can use the File Browser panel to browse your entire filesystem for audio files to add to the playlist. At the top of the File Browser you will find a toolbar with navigation buttons for moving Up, Back, and Forward through your filesystem. The tool bar also offers a Home, Reload, Short view and Detailed view buttons, it also features a Bookmarks button for creating bookmarks of your favorite filesystem areas.</para>

<para>Below the toolbar is a handy search bar for searching by file name. You will find the search bar useful for directories with many files as it searches as you type leaving only the relevant file names in the view.</para>

<para>At the bottom of the File Browser is an address bar for accessing your music from any URL that you type. For instance typing <filename class="directory">tar:/home/mike/music.tar.gz</filename> into the address bar and pressing <keycap>Enter</keycap> on your keyboard  will allow you to access the files inside the music tar ball. Now you can drag the audio from the tar ball and drop it into the playlist.</para>

<tip><para>When playlist grows larger than one screenful, it becomes hard to
append files by simply dropping them. Holding <keycap>Shift</keycap> key on keyboard while dropping
may help in this case: the files will be appended at the end of playlist rather than
inserted at current drop position.</para></tip>
</sect2>

</sect1>


<sect1 id="playlist">
<title>The Playlist</title>

<screenshot>
	<screeninfo>Playlist Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="play_list.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The Playlist holds all the tracks you have en-queued for playing. You can change the sequence by dragging items around with the mouse, and dropping them in the desired position. Above the Playlist you see a Text Box, where you can enter a filter string. As soon as you enter a letter there, the Playlist will be redisplayed, showing only entries containing the entered characters. To stop the filtering, simply press <keycap>Backspace</keycap>, until the filter is empty. You can also search by specific fields. Next to the text input is a search field button, clicking the button will allow you to search by All, Title, Artist, Album, or Genre.</para>

<tip>

<screenshot>
	<screeninfo>Playlist Tip</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="pl_tip1.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>You can select items to be played in a specific order by holding <keycap>Control</keycap> and clicking the &RMB; on items in the order in which you wish them to be played. The items will be tagged with a number showing the order in which you selected them.</para>

</tip>

</sect1>

<sect1 id="menubar">
<title>The Playlist Menubar</title>

<screenshot>
	<screeninfo>Playlist Menubar Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="menubar.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<sect2 id="actions-menu">
<title>The Actions Menu</title>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Play Media...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog for entering an URL.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Play Audio CD</guimenuitem>
</menuchoice></term>
<listitem><para>Allows you to view and play an Audio CD using the audiocd:/ protocol.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Win</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Actions</guimenu>
<guimenuitem>Previous Track</guimenuitem>
</menuchoice></term>
<listitem><para>Move to the previous track in the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Pause</guimenuitem>
</menuchoice></term>
<listitem><para>Pauses the playback of the current track.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Win</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Actions</guimenu>
<guimenuitem>Stop</guimenuitem>
</menuchoice></term>
<listitem><para>Stops playback.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Win</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Actions</guimenu>
<guimenuitem>Next Track</guimenuitem>
</menuchoice></term>
<listitem><para>Move to the next track in the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>Actions</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para>Quits &amarok;.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="playlist-menu">
<title>The Playlist Menu</title>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Add Media...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog to add media to your current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Save Playlist As...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog to save your current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem><para>Undo the last change to the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Redo</guimenuitem>
</menuchoice></term>
<listitem><para>Reverts changes made by Undo.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Playlist</guimenu>
<guimenuitem>Clear</guimenuitem>
</menuchoice></term>
<listitem><para>Clears the current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Shuffle</guimenuitem>
</menuchoice></term>
<listitem><para>Shuffles the ordering of the current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Enter</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Goto Current</guimenuitem>
</menuchoice></term>
<listitem><para>Moves the playlist to the currently playing track.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Playlist</guimenu>
<guimenuitem>Remove Duplicates / Missing</guimenuitem>
</menuchoice></term>
<listitem><para>Remove all duplicate or missing tracks in the current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo>
</shortcut>
<guimenu>Playlist</guimenu>
<guimenuitem>Select All</guimenuitem>
</menuchoice></term>
<listitem><para>Selects all the tracks in the current playlist.</para></listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="tools-menu">
<title>The Tools Menu</title>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Cover Manager</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <link linkend="cover-manager">Cover Manager</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>First-Run Wizard</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the First-Run wizard.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Visualizations</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <link linkend="visualizations">Visualizations</link> dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Equalizer</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <link linkend="equalizer">Equalizer Window</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Scripts</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the scripts dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Rescan Collection</guimenuitem>
</menuchoice></term>
<listitem><para>Starts a manual scan of your collection folders.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="settings-menu">
<title>The Settings Menu</title>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo>
</shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Hide Menubar</guimenuitem>
</menuchoice></term>
<listitem><para>Hide the Playlist Window <link linkend="menubar">Menubar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Hide Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Hide the Playlist Window <link linkend="toolbar">Toolbar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Hide Player Window</guimenuitem>
</menuchoice></term>
<listitem><para>Hide the <link linkend="player-window">Player Window</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Repeat Track</guimenuitem>
</menuchoice></term>
<listitem><para>Repeat playback of the current track.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Repeat Playlist</guimenuitem>
</menuchoice></term>
<listitem><para>Repeat playback of the current playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Random Mode</guimenuitem>
</menuchoice></term>
<listitem><para>Randomizes the order of playback of the tracks in the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Effects</guimenuitem>
</menuchoice></term>
<listitem><para>Allows configuration of the sound effects of your sound system.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Append Suggestions</guimenuitem>
</menuchoice></term>
<listitem><para>Appends the suggested songs in the Context Browser to the current playlist.</para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Global Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the global shortcut configuration dialog..</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the &amarok; shortcut configuration dialog..</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the &amarok; toolbar configuration dialog..</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure amaroK...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the &amarok; configuration dialog..</para></listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="help-menu">
<title>The Help Menu</title>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>amaroK Handbook</guimenuitem>
</menuchoice></term>
<listitem><para>Opens this documentation.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Shift</keycap><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>What's This</guimenuitem>
</menuchoice></term>
<listitem><para>Activates the What's This mouse cursor.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Report Bug...</guimenuitem>
</menuchoice></term>
<listitem><para>Starts the bug reporting tool.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>about amaroK</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the about amaroK dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>about KDE</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the about KDE dialog.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

</sect1>


<sect1 id="toolbar">
<title>The Playlist Toolbar</title>

<screenshot>
	<screeninfo>Playlist Toolbar Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="buttons.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The Playlist Window Toolbar is found near the bottom of the Playlist Window. The Toolbar contains buttons for many of the Playlist actions. On the right side of the Toolbar you can find the <guibutton>Add Media</guibutton> button, which opens a file dialog to add your media files to the playlist. Following the <guibutton>Add Media</guibutton> button are the <guibutton>Save Playlist</guibutton>, <guibutton>Clear Playlist</guibutton>, and <guibutton>Refresh Playlist</guibutton> buttons. You can use these buttons for handling the current Playlist.</para>

<para>The next set of buttons are the <guibutton>Undo</guibutton>, and <guibutton>Redo</guibutton> buttons. You can use these buttons to Undo or Redo any changes made to the playlist.</para>

<para>In the center of the Toolbar you can find a unique, re-sizeable analyzer. You can adjust the refresh rate for the analyzer by using the &RMB; menu, and selecting your desired frame rate.</para>

<para>The last button in the Toolbar is the <guibutton>Menu</guibutton> button. The <guibutton>Menu</guibutton> button opens the same menu as the Player Window &RMB; menu. You can use this menu for accessing the &amarok; configuration options.</para>

<tip><para>There are many other buttons available for the Toolbar including player control buttons and a volume slider. You can configure what buttons are in the Toolbar by clicking the <guibutton>Menu</guibutton> button and selecting <guimenuitem>Configure Toolbars...</guimenuitem></para></tip>

</sect1>

<sect1 id="statusbar">
<title>The Playlist Status Bar</title>

<screenshot>
	<screeninfo>Status Bar Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="status_bar.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The Status Bar provides quick access to some useful information about the playlist. The Status Bar displays the current track's title, the number of tracks in the playlist along with the total playlist time, Random and Repeat status, a mini track position slider, and the current track's play time. You can change the Random and Repeat status by double clicking there respective areas in the status bar.</para>

<para>You can also choose to not have the Status Bar displayed using the <guilabel>Show statusbar</guilabel> option in the <link linkend="general-options">Configure General Options Dialog</link>.</para>

</sect1>

<sect1 id="rmb-menu">
<title>The Right Mouse Button Menu</title>

<screenshot>
	<screeninfo>RMB Menu Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="rmb_menu.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The &RMB; menu can be found by right clicking the player window, it can also be found by clicking the <guibutton>Menu</guibutton> button in the playlist window. The &RMB; menu is used for access to all of &amarok;'s options.</para>

<variablelist>


<varlistentry>
<term><menuchoice><guimenu>Repeat Track</guimenu></menuchoice></term>
<listitem>
<para>This option when enabled repeats playback of the current track.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Repeat Playlist</guimenu></menuchoice></term>
<listitem>
<para>This option when enabled repeats playback of the entire playlist.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Random Mode</guimenu></menuchoice></term>
<listitem>
<para>This option when enabled randomizes the playback of the tracks in your playlist.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Append Suggestions</guimenu></menuchoice></term>
<listitem>
<para>Appends the suggested songs in the Context Browser to the current playlist.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Cover manager</guimenu></menuchoice></term>
<listitem>
<para>Opens the <link linkend="cover-manager">Cover Manager</link>.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>First-run Wizard</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option starts the first-run wizard for the initial configuration of &amarok;.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Visualizations...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option opens the <link linkend="visualizations">Visualizations Window</link> for choosing what visualizations to use with &amarok;.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Equalizer</guimenu></menuchoice></term>
<listitem>
<para>Opens the <link linkend="equalizer">Equalizer Window.</link></para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Scripts...</guimenu></menuchoice></term>
<listitem>
<para>Opens the scripts dialog.</para>
</listitem>
</varlistentry>



<varlistentry>
<term><menuchoice><guimenu>Configure Effects...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option opens a window to configure the effects of your sound engine. Some engines do not provide effects and this option will be disabled.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Configure Toolbars...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option opens a dialog to configure the <link linkend="toolbar">Playlist Toolbar</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Configure Shortcuts...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option opens a dialog to configure the <link linkend="keybd-shortcuts">&amarok; Shortcuts</link>.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><menuchoice><guimenu>Configure Global Shortcuts...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this option opens a dialog to configure the global <link linkend="keybd-shortcuts">&amarok; Shortcuts</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Configure Global amaroK...</guimenu></menuchoice></term>
<listitem>
<para>Clicking this options opens the <link linkend="configuring-kapp">&amarok; Configuration Dialog</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Help</guimenu></menuchoice></term>
<listitem>
<para>This entry provides a sub-menu providing links to this document and other &amarok; information.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Quit</guimenu></menuchoice></term>
<listitem>
<para>This entry when clicked will quit &amarok;.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>


<sect1 id="cover-manager">
<title>Album Cover Manager</title>

<screenshot>
	<screeninfo>Album Cover Manager</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="coverman.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The Album Cover Manager is a useful tool for managing your album covers. You can start the Cover Manager by selecting <menuchoice><guimenu>Actions</guimenu><guimenuitem>Cover Manager</guimenuitem></menuchoice> in the Collection Browser.</para>

<para>The cover manager provides a listview of all the albums in your collection. You can view all of your album covers for an artist by clicking on the artist in the list view.</para>

<para>The cover manager provides a search bar for searching in your album covers. The cover manager will search your albums for the search criteria you type in the search bar.</para>

<para>The <guimenuitem>View</guimenuitem> menu allows you to choose what is displayed in the cover manager. You can choose from:</para>

<para><guimenuitem>All albums</guimenuitem> which displays all your albums in your collection.</para>

<para><guimenuitem>Albums with cover</guimenuitem> which displays only the albums that have cover images.</para>

<para><guimenuitem>Albums without cover</guimenuitem> which displays only the albums that do not have cover images.</para>

<para>The <guimenuitem>Fetch Missing Covers</guimenuitem> button is used to download cover images for your albums that do not already have cover images available.</para>
</sect1>


<sect1 id="visualizations">
<title>The Visualizations</title>

<screenshot>
	<screeninfo>Visualizations Screenshot</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="vis_window.png" format="PNG"/>
	</imageobject>
	</mediaobject>
</screenshot>

<para>The Visualizations Window is used to enable your available visualizations with &amarok;. A list of your available visualizations will be provided in the window. To enable a visualization check the provided checkbox for the specific visualization.</para>

</sect1>


</chapter>
