Configuring Amarok
On first start, some basic configuration is done; see also Quick Start Guide: Getting Started. But there is more under the hood.
To access the Configuration Menu, go to Settings Configure Amarok... and see the following dialog:
General configuration options
General configuration options

General
In the screenshot above, see some General Options 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.
General options:
Option	Tooltip
Show tray icon	Check to enable the system tray icon.
Automatically retrieve cover art	Check to enable the automatic retrieval of cover art from the internet.
Enable context applets collapse animations	Check to enable animations when context applets collapse.
Automatically scroll playlist to current track	Check to make the playlist scroll so the current track is always visible.
Show Moodbar in progress slider	The Moodbar makes it possible to navigate in your music visually. Please note that this feature requires the external Moodbar Generator tool, or a script.
Moodbar style	Choose the mood display style.
When you enable the Moodbar, 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: Moodbar.

Local Collection
Local Collection configuration
Local Collection configuration
This dialog shows your file system in a tree structure, called Collection Folders. 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.
Collection options:
Option	Tooltip
Fully Rescan Entire Collection	Rescan your entire collection. This will not delete any statistics.
Import	Imports ratings and/or statistics from older versions, the batch scanner, or media players.
Scan folders recursively (requires full rescan if newly checked)	If selected, will read all subfolders.
Watch folders for changes	If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.
Importing Music: Transcode tracks	Whether should transcode tracks when they are copied or moved to Local Collection.

Import Statistics
This option allows you to import statistics, ⪚ ratings and scores from either
an older 1.4.x version (from SQLite, MySQL or PostgreSQL databases)
from iTunes
It does not import statistics from an 2.x database, so if you want to merge an older 2.x database version, you will need to do this by hand.

Metadata
This dialog will allow you to configure the settings for metadata handling. This is a separate page starting with Amarok 2.7
Metadata options:
Option	Tooltip
Write statistics to file	Check to write play-changing statistics as tags back to the audio files.
Write covers to file, maximum size...	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.
Enable character set detection in ID3 tags	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.

Statistics Synchronization
This dialog will allow you to keep statistics of your collections synchronized. Make sure to only check collections between which you want to synchronize metadata.
Statistics Synchronization options:
Option	Tooltip
Synchronize Rating	Check to synchronize ratings between collections.
Synchronize First Played	Check to synchronize first played dates between collections.
Synchronize Last Played	Check to synchronize last played dates between collections.
Synchronize Playcount	Check to synchronize playcounts between collections.
Synchronize Labels	Check to synchronize labels between collections.

Playback
Playback configuration dialog
Playback configuration dialog
Configure the playback options, as well as the KDE multimedia framework .
Option	Tooltip
Fadeout on stop	If checked, will slowly fade the volume of the playing track on stop or at the end of the playlist, or stop playback immediately.
Fadeout on pause	If checked, will slowly fade the volume of the playing track on pausing the current track.
Fadeout duration	The length of the fadeout, in milliseconds.
Inhibit automatic suspend if playing	If checked, will prevent the computer from being suspended will a track is playing.
Pause playback on suspend	If checked, will pause playing of the current track when the computer is about to suspend.
Resume playback on start	If checked, will resume playback where you left it the last session -- just like a tape-player.

Configuring Phonon
is the multimedia framework used by . It was created to allow KDE 4 to be independent of any single multimedia framework such as GStreamer or VLC 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 Windows and OS X.
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.
Playback problems in are typically not issues, but rather issues, as doesn't handle sound directly anymore.

Device Preference tab
Depending on your OS and distribution, you may need to use ALSA, OSS, PulseAudio, or something else as your default playback device. Find one that works for you with the Test 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.

Speaker Setup tab
Should you wish to change the standard speaker setup, here is the place to do it.

Backend tab
Depending on your operating system you may see options such as Gstreamer, VLC, or DS9 (Windows) here. The recommended phonon-backend for users is VLC or Gstreamer.
If you don't see VLC or Gstreamer, install the package for it. For most distributions the package for VLC, for example, would be phonon-backend-vlc.
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.

Notifications
Notifications configuration dialog
Notifications configuration dialog
Option	Tooltip
Use On-Screen Display	Check to enable the On-Screen Display. The OSD 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.
Duration	The time in milliseconds for which to show the OSD. The value must be between 500 ms and 10000 ms.
Screen	Allows you to choose the screen that should display the OSD if you have a multiscreen setup. Default is 0.
Translucent	Check to enable translucency if supported by your desktop system.
Font scale	(choose the size of the font in the OSD)
Don't show when a fullscreen application is active	Do not show On-Screen Display if another application is focused and running in fullscreen mode.
Use custom colors	Check to enable custom colors for the On-Screen Display text.
Text color	Click to select the color of the OSD text.
Use system notifications	Check to use the system notification. This can vary depending on your desktop system and/or distribution.

Database
External Database configuration dialog
External Database configuration dialog
The default database is already set to use embedded MySQL. 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 MySQL database.
expects the external database and user account to already exist. The user also requires full access to the database. You MUST restart after changing these settings.
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.
Option	Tooltip
Use external MySQL Database	Check to enable the use of an external database.
Server	Enter the name of the existing MySQL server.
Port	Enter the port number to access the server. Default is port 3306.
Username	Enter the username to access the database with full access privileges.
Password	Enter the password for the default user.
Database	Enter the name of the database. Default preset is amarokdb.
You can find more information about the External Database here.

Plugins
Plugins configuration dialog
Plugins configuration dialog
Plugins configuration controls Collections, Internet Services, and Local Collection Backends.

Collections
offers you access to the following Collections, if they are available:
Collection	Description
AudioCD Collection	AudioCD collection plugin for
DAAP Collection	DAAP collection plugin for
iPod, iPad & iPhone Collection	Plugin to use iPod-like devices as collections in
MTP Collection	MTP collection plugin for
Universal Mass Storage Collection	UMS/USB collection plugin for
UPnP Collection	UPnP collection plugin for

Internet Services
offers by default the following Internet services:
Service	Description	Needs configuration
Ampache	Use an external music server	Yes, Ampache server needed
gpodder.net	Podcast service. See also gpodder.net	No
Jamendo	Listen to free music published under Creative Common licenses. See also Jamendo.com	No
Last.fm	A popular internet radio service, streaming only for subscribers. See also Last.fm	Yes, personal information to scrobble 
Magnatune Store	Preview and buy music from a non-evil record label. See also Magnatunes.com	Only for downloads
MP3 Music Store	Access the Amazon MP3 Store directly from Amarok	Yes
mp3tunes	A personal mp3 locker. See also mp3tunes.com	Yes
Podcast Directory	Browse and subscribe to a huge choice of podcasts	No
Other service are available through scripts.

Local Collection Backends
offers you access to the following Local Collection Backends, if they are available:
Devices	Description
Local Files & USB Mass Storage Backend	Local Collection folders on local and pluggable disks
NFS Share Backend	Local Collection folders on remote NFS shares (Network File System)
SMB (Windows) Share Backend	Local Collection folders on remote Samba (Windows) shares

Ampache configuration
If you have access to a remote Ampache music server, click and enter the necessary information. You can configure access to more than one Ampache server. For more information see the Ampache section in what follows.

Last.fm configuration
While streaming is free with Last.fm's own online player for residents of the US, the UK and Germany, it only works in for paid subscribers. Scrobbling is free, however, provided you enter your Last.fm username and password by clicking . allows you to store the password in the secure KDE Wallet. If you decline the use of Kwallet, your password will be stored in clear text instead.

Magnatune Store configuration
Listen to the music offered by Magnatune for free and buy it directly through . Click 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.
To download, you then go to the Media Sources 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.

MP3 Store configuration
Access the Amazon MP3 Store directly from .
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:
France
Austria, Germany, Switzerland
Japan
United Kingdom
United States (default)
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.

mp3tunes configuration
If you have a personal mp3tunes locker, click and enter your username and password. You will then be able to access your online locker.

Scripts
Scripts configuration dialog
Scripts configuration dialog
Script Configuration in covers Generic, Lyrics, and Scriptable Service scripts. Scripts are added in the Manage Scripts dialog.

Generic scripts
Generic scripts add functionality to . The Amarok Script Console 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 Tools menu.

Lyrics scripts
A variety of lyrics scripts are available; Ultimate Lyrics is provided by default. Your chosen lyrics scripts will provide the lyrics shown in the Lyrics applet in the Context pane.

Scriptable Services scripts
Scriptable services, if enabled, will show up in the Internet Services in the Collections pane. Many collections of streams are available, in many languages, and from many sources.

Manage Scripts
At bottom of the configuration dialog are two options:
Automatically update built-in scripts
Automatically download and install updates for the built-in scripts from the 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.
Manage Scripts button
Browse, install and uninstall user-supplied scripts; also search, sort and rate the scripts in the Amarok Add-on Installer.

Add-on Installer
Amarok Script Manager
Amarok Script Manager
Using the Add-on Installer, one can install the latest user-contributed scripts. There are also options to search, sort and rate the scripts.
The Install Scripts and Uninstall buttons can be used to manage scripts. One can install script packages of type amarokscript.tar, amarokscript.tar.bz2, amarokscript.tar.gz

Script Information
Learn more about a script using the button.
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 OK or the Apply button. To deactivate the Script Console deselect it and confirm again.

Changing Layouts

Changing the Amarok Window Layout
The visibility of each of the three panes is indicated in the View 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 window. Clicking the X closes that particular pane. Having been closed, a pane can be activated again by checking the appropriate box in the View menu. Clicking Reset Layout will of course reset the layout back to the default look.

Undocking Amarok panes
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 window. You can drag the panes inside your window to reorder them. You may stack the panes, or even put one or two of them covering the others, selectable by tabs.

Lock and save Amarok window layout
If you are satisfied with the layout inside your window, you can lock this layout by clicking the appropriate item in the View menu. Be aware that if you want to be sure your layout is preserved when you shut down your session with still open, quit first by either choosing Amarok Quit, or by typing Q.

Changing the Toolbar
You can also choose between two layouts of the Toolbar by clicking the appropriate item in the View menu:
Main Toolbar
Slim Toolbar
More about the Toolbar here.

Changing the Playlist layout
To access the Playlist Layout Editor, go to Playlist Playlist Layouts Configure Playlist Layouts... 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 Preview button allows you to see the applied layout in the Playlist pane.

Modifying a default layout
To modify one of the default layouts, first make a new copy of it: simply click on and save it under a new name. To generate a new layout, click on
A layout consists of 3 elements: the Album Head, the Album Body (with a special album body for Various Artist tracks) and the Single 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 Cover field.
In addition, you can also add:
Menu Item	Description
Show inline playback controls	playback controls will appear below the line of the playing track.
Show tooltips	Tooltips showing ID3 tag information will be shown on hovering over a track.

Item layout configuration
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 Album item:
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.

Example: single line layout
Example: to generate a single line layout without grouping you only add items in the Single Track element.

Playlist layout storage
The playlist layouts will be stored in xml format in $HOME/.kde/share/apps/amarok/playlist_layouts (might be $HOME/.kde4/share/apps/amarok/playlist-layouts for some distributions).