Amarok/Manual/ConfiguringAmarok: Difference between revisions

From KDE UserBase Wiki
(added Scipts section)
(Marked this version for translation)
 
(105 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category:Amarok]]
<languages />
<translate>


== Configuring Amarok ==
== Configuring Amarok == <!--T:1-->


<!--T:2-->
On first start, some basic configuration is done; see also [[Special:myLanguage/Amarok/QuickStartGuide/GettingStarted|Quick Start Guide: Getting Started]]. But there is more under the hood.
On first start, some basic configuration is done; see also [[Special:myLanguage/Amarok/QuickStartGuide/GettingStarted|Quick Start Guide: Getting Started]]. But there is more under the hood.
<br /><br />
 
<!--T:3-->
To access the ''Configuration Menu'', go to <menuchoice>Settings -> Configure Amarok...</menuchoice> and see the following dialog:
To access the ''Configuration Menu'', go to <menuchoice>Settings -> Configure Amarok...</menuchoice> and see the following dialog:


[[File:Configure Amarok.png|thumb|300px|center|Before version 2.4.1]][[File:Amarok2.4.1ConfigureDialog.png|thumb|300px|center|Amarok 2.4.1]]


=== General ===
<!--T:171-->
[[File:Amarok_2.8_ConfigurationDialogGeneral.png|thumb|center|300px|General configuration options]]


In the screenshot above you can see some ''General Options'' you can set. Depending on the distribution, the default settings can vary, sometimes the ''Splash Screen'' is disabled for example. When hovering over the options with the mouse pointer, a tooltip will show to explain the individual settings.
=== General === <!--T:4-->


This section allows you to configure the following options:
<!--T:5-->
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.


{| border="1" cellpadding="5"
<!--T:6-->
! Option !! Tooltip
General options:
 
<!--T:7-->
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
|-
| <menuchoice>Show splash-screen on startup</menuchoice> || Check to enable the splash screen on '''Amarok''' startup.
<translate>
<!--T:92-->
| <menuchoice>Show tray icon</menuchoice> || Check to enable the '''Amarok''' system tray icon.</translate>
|-
|-
| <menuchoice>Show tray icon</menuchoice> || Check to enable the '''Amarok''' system tray icon.
<translate>
<!--T:93-->
| <menuchoice>Automatically retrieve cover art</menuchoice> || Check to enable the automatic retrieval of cover art from the internet.</translate>
|-
|-
| <menuchoice>Automatically retrieve cover art</menuchoice> || Check to enable the automatic retrieval of cover art from the internet.
<translate>
<!--T:94-->
| <menuchoice>Enable context applets collapse animations</menuchoice> || Check to enable animations when context applets collapse.</translate>
|-
|-
| <menuchoice>Automatically scroll playlist to current track</menuchoice> || Check to make the playlist scroll so the current track is always visible.
<translate>
<!--T:95-->
| <menuchoice>Automatically scroll playlist to current track</menuchoice> || Check to make the playlist scroll so the current track is always visible.</translate>
|-
|-
| <menuchoice>Show Moodbar in progress slider</menuchoice> || The ''Moodbar'' makes it possible to navigate in your music visually. Please note that this feature requires the [[Special:myLanguage/Amarok/Manual/AdvancedFeatures/Moodbar|external Moodbar Generator tool]], or a script.
<translate>
<!--T:96-->
| <menuchoice>Show Moodbar in progress slider</menuchoice> || The ''Moodbar'' makes it possible to navigate in your music visually. Please note that this feature requires the [[Special:myLanguage/Amarok/Manual/Various/Moodbar|external Moodbar Generator tool]], or a script.</translate>
|-
|-
<translate>
<!--T:97-->
| <menuchoice>Moodbar style</menuchoice> || Choose the mood display style.
| <menuchoice>Moodbar style</menuchoice> || 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 this section: [[Special:myLanguage/Amarok/Manual/AdvancedFeatures/Moodbar|Advanced Features -> Moodbar]]
<!--T:8-->
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: [[Special:myLanguage/Amarok/Manual/Various/Moodbar|Moodbar]].


=== Collection ===
</translate><span id="Collection"></span><translate>


[[File:Amarok2.4.1ConfigureDialogCollection.png|thumb|350px|center]]
=== Local Collection === <!--T:9-->


The above dialog shows a large section in the center where you see the tree structure of your file system, called ''Collection Folders''. Selecting a folder always includes also its subfolders.
<!--T:10-->
[[File:Amarok_2.8_ConfigurationDialogLocalCollection.png|thumb|300px|center|Local Collection configuration]]


The available options in this dialog are the following:
<!--T:11-->
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.


{| border="1" cellpadding="5"
<!--T:12-->
! Option !! Tooltip
Collection options:
 
<!--T:13-->
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
|-
| <menuchoice>Fully Rescan Entire Collection</menuchoice> || Rescan your entire collection. This will ''not'' delete any statistics.
<translate>
<!--T:98-->
| <menuchoice>Fully Rescan Entire Collection</menuchoice> || Rescan your entire collection. This will ''not'' delete any statistics.</translate>
|-
|-
| <menuchoice>Import (statistics)</menuchoice> || Import statistics from older '''Amarok''' versions, or from other media players.
<translate>
<!--T:99-->
| <menuchoice>Import</menuchoice> || Imports ratings and/or statistics from older '''Amarok''' versions, the batch scanner, or media players.</translate>
|-
|-
| <menuchoice>Scan folders recursively (requires full rescan if newly checked)</menuchoice> || If selected, '''Amarok''' will read all subfolders.
<translate>
<!--T:100-->
| <menuchoice>Scan folders recursively (requires full rescan if newly checked)</menuchoice> || If selected, '''Amarok''' will read all subfolders.</translate>
|-
|-
| <menuchoice>Watch folders for changes</menuchoice> || If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.
<translate>
<!--T:101-->
| <menuchoice>Watch folders for changes</menuchoice> || If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.</translate>
|-
|-
| <menuchoice>Write statistics to file</menuchoice> || Write play-changing statistics (e.g. score, lastplayed, playcount) as tags back to the file.
|-
| <menuchoice>Write covers to file</menuchoice> || Write changed covers back to the file. This will replace existing embedded covers.
|-
| <menuchoice>Enable character set detection in ID3 tags</menuchoice> || If selected, '''Amarok''' will use Mozilla's Character Set Detector to attempt to automatically guess the character set used in ID3 tags.
|}


==== Import Statistics ====
<translate>
<!--T:149-->
| <menuchoice>Importing Music: Transcode tracks</menuchoice> || Whether '''Amarok''' should transcode tracks when they are copied or moved to ''Local Collection''.
|}<!--{-->
 
</translate><span id="Import Statistics"></span><translate>
 
==== Import Statistics ==== <!--T:14-->


<!--T:15-->
This option allows you to import statistics, e.g. ratings and scores from either
This option allows you to import statistics, e.g. ratings and scores from either
* an older '''Amarok''' 1.4.x version (from '''SQLite''', '''MySQL''' or '''PostgreSQL''' databases)
* an older '''Amarok''' 1.4.x version (from '''SQLite''', '''MySQL''' or '''PostgreSQL''' databases)
* from '''iTunes'''
* from '''iTunes'''


<!--T:16-->
It does ''not'' 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.
It does ''not'' 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.


=== Plugins; formerly Internet Services ===
=== Metadata === <!--T:151-->
 
<!--T:152-->
[[File:MetadataDialog.png|thumb|350px|center]]
 
<!--T:153-->
This dialog will allow you to configure the settings for metadata handling. This is a separate page starting with Amarok 2.7
 
<!--T:154-->
Metadata options:
 
<!--T:155-->
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
<translate>
<!--T:160-->
| <menuchoice>Write statistics to file</menuchoice> || Check to write play-changing statistics as tags back to the audio files.</translate>
|-
<translate>
<!--T:161-->
| <menuchoice>Write covers to file, maximum size...</menuchoice> || 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.</translate>
|-
<translate>
<!--T:162-->
| <menuchoice>Enable character set detection in ID3 tags</menuchoice> || 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 ==== <!--T:156-->
 
<!--T:157-->
This dialog will allow you to [[Special:myLanguage/Amarok/Manual/Organization/Collection/StatisticsSynchronization|keep statistics of your collections synchronized]]. Make sure to only check collections between which you want to synchronize metadata.
 
<!--T:158-->
Statistics Synchronization options:
 
<!--T:159-->
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
<translate>
<!--T:163-->
| <menuchoice>Synchronize Rating</menuchoice> || Check to synchronize ratings between collections.</translate>
|-
<translate>
<!--T:164-->
| <menuchoice>Synchronize First Played</menuchoice> || Check to synchronize first played dates between collections.</translate>
|-
<translate>
<!--T:165-->
| <menuchoice>Synchronize Last Played</menuchoice> || Check to synchronize last played dates between collections.</translate>
|-
<translate>
<!--T:166-->
| <menuchoice>Synchronize Playcount</menuchoice> || Check to synchronize playcounts between collections.</translate>
|-
<translate>
<!--T:167-->
| <menuchoice>Synchronize Labels</menuchoice> || Check to synchronize labels between collections.
|}<!--{-->


Moved down the page to conform to the new configuration order.
=== Playback === <!--T:19-->


=== Playback ===


[[File:Amarok2.4.1ConfigPlayback.png|thumb|250px|center]]
<!--T:172-->
[[File:Amarok_2.8_ConfigurationDialogPlayback.png|thumb|300px|center|Playback configuration dialog]]


In the above ''Playback'' section you can configure the playback options, as well as the KDE multimedia framework called ''Phonon''.
<!--T:21-->
Configure the playback options, as well as the KDE multimedia framework '''Phonon'''.


{| border="1" cellpadding="5"
<!--T:22-->
! Option !! Tooltip
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
<translate>
<!--T:105-->
| <menuchoice>Fadeout on stop</menuchoice> || 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.</translate>
|-
<translate>
<!--T:168-->
| <menuchoice>Fadeout on pause</menuchoice> || If checked, '''Amarok''' will slowly fade the volume of the playing track on pausing the current track.</translate>
|-
<translate>
<!--T:106-->
| <menuchoice>Fadeout duration</menuchoice> || The length of the fadeout, in milliseconds.</translate>
|-
|-
| <menuchoice>Fadeout on stop</menuchoice> || 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.
<translate>
<!--T:169-->
| <menuchoice>Inhibit automatic suspend if playing</menuchoice> || If checked, '''Amarok''' will prevent the computer from being suspended will a track is playing.</translate>
|-
|-
| <menuchoice>Fadeout duration</menuchoice> || The length of the fadeout, in milliseconds.
<translate>
<!--T:170-->
| <menuchoice>Pause playback on suspend</menuchoice> || If checked, '''Amarok''' will pause playing of the current track when the computer is about to suspend.</translate>
|-
|-
<translate>
<!--T:107-->
| <menuchoice>Resume playback on start</menuchoice> || If checked, '''Amarok''' will resume playback where you left it the last session -- just like a tape-player.
| <menuchoice>Resume playback on start</menuchoice> || If checked, '''Amarok''' will resume playback where you left it the last session -- just like a tape-player.
|}
|}<!--{-->


==== Configuring Phonon ====
==== Configuring Phonon ==== <!--T:23-->


''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 ''GStreamer'' or ''Xine'' and to provide a stable API for KDE 4's lifetime. As an added bonus, it simplifies development by providing a simple API that can work across different platforms such as Windows and OS X.
<!--T:24-->
<br /><br />
'''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 '''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'''.
 
<!--T:25-->
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.
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.
<br /><br />
Another result is that playback problems in '''Amarok''' are typically not '''Amarok''' issues, but rather ''Phonon'' issues, as '''Amarok''' doesn't handle sound directly anymore.


===== Selecting an output device =====
<!--T:26-->
Playback problems in '''Amarok''' are typically not '''Amarok''' issues, but rather '''Phonon''' issues, as '''Amarok''' doesn't handle sound directly anymore.
 
===== Device Preference tab ===== <!--T:27-->
 
<!--T:28-->
[[File:AmarokConfigurationDialog2.7PhononDevice.png|thumb|300px|center]]
 
<!--T:29-->
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 <menuchoice>Test</menuchoice> 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 ===== <!--T:30-->
 
<!--T:31-->
[[File:AmarokConfigurationDialog2.7PhononHardware.png|thumb|300px|center]]
 
<!--T:32-->
Should you wish to change the standard speaker setup, here is the place to do it.


[[File:Amarok2.4.1PhononDevices.png|thumb|250px|center]]
===== Backend tab ===== <!--T:33-->


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 <menuchoice>Test</menuchoice> 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.
<!--T:34-->
[[File:AmarokConfigurationDialog2.7PhononBackend.png|thumb|250px|center]]


===== Selecting a multimedia backend =====
<!--T:35-->
Depending on your operating system you may see options such as ''Gstreamer'', ''VLC'', or ''DS9'' (Windows) here. The recommended phonon-backend for Linux users is ''VLC'' or ''Gstreamer''.


[[File:Amarok2.4.1PhononBackends.png|thumb|250px|center]]
<!--T:36-->
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'''.


Depending on your OS you may see options such as ''Xine'', ''Gstreamer'', ''VLC'', or ''DS9'' (Windows only) here. The recommended one for Linux users is ''VLC'' or ''Gstreamer''.
<!--T:37-->
<br /><br />
If you don't see ''VLC'' or the particular back-end you want here you may need to install the package for it. For most distributions the package for ''VLC'', for example, would be ''phonon-backend-vlc''.
<br /><br />
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.  
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.  
<br /><br />
For information on codecs and playing mp3s see the [http://amarok.kde.org/wiki/MP3 mp3 information] page.


=== Notifications ===


[[File:Amarok2.4.1Notifications.png|thumb|300px|center]]
</translate><span id="Notifications"></span><translate>
 
=== Notifications === <!--T:39-->
 


{| border="1" cellpadding="5"
<!--T:173-->
! Option !! Tooltip
[[File:Amarok_2.8_ConfigurationDialogNotifications.png|thumb|center|300px|Notifications configuration dialog]]
<br />,<br />
<!--}-->{| border="1"  
! Option !! Tooltip</translate>
|-
<translate>
<!--T:108-->
| <menuchoice>Use On-Screen Display</menuchoice> || 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.</translate>
|-
|-
| <menuchoice>Use On-Screen Display</menuchoice> || 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.
<translate>
<!--T:109-->
| <menuchoice>Duration</menuchoice> || The time in milliseconds for which to show the OSD. The value must be between 500 ms and 10000 ms.</translate>
|-
|-
| <menuchoice>Duration</menuchoice> || The time in milliseconds for which to show the ''OSD''. The value must be between 500 ms and 10000 ms.
<translate>
<!--T:110-->
| <menuchoice>Screen</menuchoice> || Allows you to choose the screen that should display the OSD if you have a multiscreen setup. Default is 0.</translate>
|-
|-
| <menuchoice>Screen</menuchoice> || Allows you to choose the screen that should display the ''OSD'' if you have a multiscreen setup. Default is 0.
<translate>
<!--T:111-->
| <menuchoice>Translucent</menuchoice> || Check to enable translucency if supported by your desktop system.</translate>
|-
|-
| <menuchoice>Translucent</menuchoice> || Check to enable translucency if supported by your desktop system.
<translate>
<!--T:112-->
| <menuchoice>Font scale</menuchoice> || (choose the size of the font in the OSD)</translate>
|-
|-
| <menuchoice>Use custom colors</menuchoice> || Check to enable custom colors for the ''On-Screen Display'' text.
<translate>
<!--T:113-->
| <menuchoice>Don't show when a fullscreen application is active</menuchoice> || Do not show On-Screen Display if another application is focused and running in fullscreen mode.</translate>
|-
|-
| <menuchoice>Text color</menuchoice> || Click to select the color of the ''OSD'' text.
<translate>
<!--T:114-->
| <menuchoice>Use custom colors</menuchoice> || Check to enable custom colors for the ''On-Screen Display'' text.</translate>
|-
|-
<translate>
<!--T:115-->
| <menuchoice>Text color</menuchoice> || Click to select the color of the ''OSD'' text.</translate>
|-
<translate>
<!--T:116-->
| <menuchoice>Use system notifications</menuchoice> || Check to use the system notification. This can vary depending on your desktop system and/or distribution.
| <menuchoice>Use system notifications</menuchoice> || Check to use the system notification. This can vary depending on your desktop system and/or distribution.
|}
|}<!--{-->


=== Database ===
</translate><span id="Database"></span><translate>


[[File:Amarok2.4.1DatabaseConfig.png|thumb|300px|center]]
=== Database === <!--T:42-->


<!--T:174-->
[[File:Amarok_2.8_ConfigurationDialogDatabase.png|thumb|300px|center|External Database configuration dialog]]
<!--T:44-->
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.
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.
<br /><br />
<br /><br />
Line 145: Line 309:
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.  
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.  


{| border="1" cellpadding="5"
<!--T:45-->
! Option !! Tooltip
<!--}-->{| border="1" cellpadding="5"
! Option !! Tooltip</translate>
|-
|-
| <menuchoice>Use external MySQL Database</menuchoice> || Check to enable the use of an external database.
<translate>
<!--T:117-->
| <menuchoice>Use external MySQL Database</menuchoice> || Check to enable the use of an external database.</translate>
|-
|-
| <menuchoice>Server</menuchoice> || Enter the name of the existing '''MySQL''' server
<translate>
<!--T:118-->
| <menuchoice>Server</menuchoice> || Enter the name of the existing '''MySQL''' server.</translate>
|-
|-
| <menuchoice>Port</menuchoice> || Enter the port number to access the server. Default is port 3306.
<translate>
<!--T:119-->
| <menuchoice>Port</menuchoice> || Enter the port number to access the server. Default is port 3306.</translate>
|-
|-
| <menuchoice>Username</menuchoice> || Enter the username to access the database with full access privileges.
<translate>
<!--T:120-->
| <menuchoice>Username</menuchoice> || Enter the username to access the database with full access privileges.</translate>
|-
|-
| <menuchoice>Password</menuchoice> || Enter the password for the default user.
<translate>
<!--T:121-->
| <menuchoice>Password</menuchoice> || Enter the password for the default user.</translate>
|-
|-
<translate>
<!--T:122-->
| <menuchoice>Database</menuchoice> || Enter the name of the database. Default preset is amarokdb.
| <menuchoice>Database</menuchoice> || Enter the name of the database. Default preset is amarokdb.
|}
|}<!--{-->


You can find more information about the External Database [[Special:myLanguage/Amarok/Manual/AdvancedFeatures/ExternalDatabase|here]].
<!--T:46-->
You can find more information about the External Database [[Special:myLanguage/Amarok/Manual/Organization/Collection/ExternalDatabase|here]].


</translate><span id="Plugins (formerly Internet Services)"></span><translate>


=== Plugins (formerly Internet Services) ===
=== Plugins === <!--T:47-->


[[File:Settings-Internet-amarok.png|thumb|250px|left|Before version 2.4.1]][[File:Amarok2.4.1ConfigureDialogPlugins.png|thumb|300px|Amarok 2.4.1 (Click to enlarge image)]]<br style="clear:both" />
<!--T:175-->
[[File:Amarok_2.8_ConfigurationDialogPlugins.png|thumb|center|300px|Plugins configuration dialog]]


Plugins configuration now controls <menuchoice>Collections</menuchoice>, <menuchoice>Devices</menuchoice>, and <menuchoice>Internet Services</menuchoice>.
<!--T:49-->
Plugins configuration controls <menuchoice>Collections</menuchoice>, <menuchoice>Internet Services</menuchoice>, and <menuchoice>Local Collection Backends</menuchoice>.


==== Collections ====
==== Collections ==== <!--T:50-->


<!--T:51-->
'''Amarok''' offers you access to the following Collections, if they are available:
'''Amarok''' offers you access to the following Collections, if they are available:


{| border="1" cellpadding="5"
<!--T:52-->
! Collection !! Description
<!--}-->{| border="1" cellpadding="5"
! Collection !! Description</translate>
|-
|-
| <menuchoice>AudioCD Collection</menuchoice> || AudioCD collection plugin for '''Amarok'''
<translate>
<!--T:123-->
| <menuchoice>AudioCD Collection</menuchoice> || AudioCD collection plugin for '''Amarok'''</translate>
|-
|-
| <menuchoice>DAAP Collection</menuchoice> || DAAP collection plugin for '''Amarok'''
<translate>
<!--T:124-->
| <menuchoice>DAAP Collection</menuchoice> || DAAP collection plugin for '''Amarok'''</translate>
|-
|-
| <menuchoice>Ipod Collection</menuchoice> || Ipod collection plugin for '''Amarok'''
<translate>
<!--T:125-->
| <menuchoice>iPod, iPad & iPhone Collection</menuchoice> || Plugin to use iPod-like devices as collections in '''Amarok'''</translate>
|-
|-
| <menuchoice>MTP Collection</menuchoice> || MTP collection plugin for '''Amarok'''
<translate>
<!--T:126-->
| <menuchoice>MTP Collection</menuchoice> || MTP collection plugin for '''Amarok'''</translate>
|-
|-
| <menuchoice>Universal Mass Storage Collection</menuchoice> ||  
<translate>
<!--T:127-->
| <menuchoice>Universal Mass Storage Collection</menuchoice> || UMS/USB collection plugin for '''Amarok'''</translate>
|-
|-
<translate>
<!--T:128-->
| <menuchoice>UPnP Collection</menuchoice> || UPnP collection plugin for '''Amarok'''
| <menuchoice>UPnP Collection</menuchoice> || UPnP collection plugin for '''Amarok'''
|}
|}<!--{-->


==== Devices ====
==== Internet Services ==== <!--T:56-->


'''Amarok''' offers you access to the following Devices, if they are available:
<!--T:57-->
'''Amarok''' offers by default the following Internet services:


{| border="1" cellpadding="5"
<!--T:58-->
! Devices !! Description
<!--}-->{| border="1" cellpadding="4"
! Service !! Description !! Needs configuration {{Configure}}</translate>
|-
<translate>
<!--T:132-->
| <menuchoice>Ampache</menuchoice> || Use an external music server  || Yes, '''Ampache''' server needed</translate>
|-
|-
| <menuchoice>Mass Storage Device</menuchoice> || Device Plugin for '''Amarok'''
<translate>
<!--T:133-->
| <menuchoice>gpodder.net</menuchoice> || Podcast service. See also [http://www.gpodder.net gpodder.net] || No</translate>
|-
|-
| <menuchoice>NFS Device</menuchoice> || Device Plugin for '''Amarok''' which supports NFS (Network File System)
<translate>
<!--T:134-->
| <menuchoice>Jamendo</menuchoice> || Listen to free music published under Creative Common licenses. See also [http://www.jamendo.com/en/about Jamendo.com] || No</translate>
|-
|-
| <menuchoice>SMB Device</menuchoice> || Device Plugin for '''Amarok''' which supports SMBFS (Samba File System)
<translate>
|}
<!--T:135-->
 
| <menuchoice>Last.fm</menuchoice> || A popular internet radio service, streaming only for subscribers. See also [http://www.last.fm/about Last.fm] || Yes, personal information to [[Special:myLanguage/Amarok/QuickStartGuide/Glossary#Scrobble|scrobble]]</translate>
==== Internet Services ====
 
'''Amarok''' offers by default the following Internet services:
 
{| border="1" cellpadding="5"
! Service !! Description !! Needs configuration
|-
|-
| <menuchoice>Ampache</menuchoice> || Use an external music server  || Yes, '''Ampache''' server needed
<translate>
<!--T:137-->
| <menuchoice>Magnatune Store</menuchoice> || Preview and buy music from a non-evil record label. See also [http://magnatune.com/info/whynotevil Magnatunes.com] || Only for downloads</translate>
|-
|-
| <menuchoice>gpodder.net</menuchoice> || Podcast service. See also [http://www.gpodder.net gpodder.net] || No
<translate>
<!--T:140-->
| <menuchoice>MP3 Music Store</menuchoice> || Access the Amazon MP3 Store directly from Amarok || Yes</translate>
|-
|-
| <menuchoice>Jamendo</menuchoice> || Listen to free music published under Creative Common licenses. See also [http://www.jamendo.com/en/about Jamendo.com] || No
<translate>
<!--T:136-->
| <menuchoice>mp3tunes</menuchoice> || A personal mp3 locker. See also [http://www.mp3tunes.com/cb/about/ mp3tunes.com] || Yes</translate>
|-
|-
| <menuchoice>Last.fm</menuchoice> || A popular internet radio service, streaming only for subscribers. See also [http://www.last.fm/about Last.fm] || Yes, personal information to [[Special:myLanguage/Amarok/QuickStartGuide/Glossary#Scrobble|scrobble]]
<translate>
<!--T:138-->
| <menuchoice>Podcast Directory</menuchoice> || Browse and subscribe to a huge choice of podcasts || No
|}<!--{-->
<br />
 
<!--T:59-->
Other service are available through scripts.
 
==== Local Collection Backends ==== <!--T:53-->
 
<!--T:54-->
'''Amarok''' offers you access to the following Local Collection Backends, if they are available:
 
<!--T:55-->
<!--}-->{| border="1" cellpadding="5"
! Devices !! Description</translate>
|-
|-
| <menuchoice>mp3tunes</menuchoice> || A personal mp3 locker. See also [http://www.mp3tunes.com/cb/about/ mp3tunes.com] || Yes
<translate>
<!--T:129-->
| <menuchoice>Local Files & USB Mass Storage Backend</menuchoice> || Local Collection folders on local and pluggable disks</translate>
|-
|-
| <menuchoice>Magnatune Store</menuchoice> || Prewiew and buy music from a non-evil record label. See also [http://magnatune.com/info/whynotevil Magnatunes.com] || Only for downloads
<translate>
<!--T:130-->
| <menuchoice>NFS Share Backend</menuchoice> || Local Collection folders on remote NFS shares (Network File System)</translate>
|-
|-
| <menuchoice>Podcast Directory</menuchoice> || Browse and subscribe to a huge choice of podcasts || No
<translate>
|}
<!--T:131-->
| <menuchoice>SMB (Windows) Share Backend</menuchoice> || Local Collection folders on remote Samba (Windows) shares
|}<!--{-->
 
==== Ampache configuration ==== <!--T:60-->
 
<!--T:61-->
If you have access to a remote '''Ampache''' music server, click {{Configure}} and enter the necessary information. You can configure access to more than one '''Ampache''' server. For more information see the [[Special:myLanguage/Amarok/Manual/Organization/Collection/RemoteCollections/Ampache|Ampache]] section in what follows.
 
==== Last.fm configuration ==== <!--T:62-->
 
<!--T:63-->
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 {{Configure}}. '''Amarok''' 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 ==== <!--T:66-->
 
<!--T:67-->
Listen to the music offered by Magnatune for free and buy it directly through '''Amarok'''. Click {{Configure}} 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.
 
<!--T:68-->
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 ==== <!--T:141-->
 
<!--T:142-->
Access the Amazon MP3 Store directly from '''Amarok'''.
 
<!--T:143-->
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:
 
<!--T:144-->
* France
* Austria, Germany, Switzerland
* Japan
* United Kingdom
* United States (default)
 
<!--T:145-->
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 ==== <!--T:64-->
 
<!--T:65-->
If you have a personal mp3tunes locker, click {{Configure}} and enter your username and password. You will then be able to access your online locker.
 
</translate><span id="Scripts"></span><translate>
 
=== Scripts === <!--T:69-->
 
<!--T:70-->
[[File:Amarok2.7ScriptsConfigMenu.png|center|thumb|300px|Scripts configuration dialog (click to enlarge)]]
 
<!--T:71-->
Script Configuration in '''Amarok''' covers <menuchoice>Generic</menuchoice>, <menuchoice>Lyrics</menuchoice>, and <menuchoice>Scriptable Service</menuchoice> scripts. Scripts are added in the <menuchoice>Manage Scripts</menuchoice> dialog.
 
==== Generic scripts ==== <!--T:72-->
 
<!--T:73-->
Generic scripts add functionality to '''Amarok'''. 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.


Other service are available through scripts.
==== Lyrics scripts ==== <!--T:74-->


<!--T:75-->
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.


==== Ampache configuration ====
==== Scriptable Services scripts ==== <!--T:76-->


If you have access to a remote '''Ampache''' music server, click on the wrench icon and enter the necessary information. You can configure access to more than one '''Ampache''' server. For more information see the [[Special:myLanguage/Amarok/Manual/AdvancedFeatures/RemoteCollections/Ampache|Ampache]] section in Advanced Features.
<!--T:77-->
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.


==== Last.fm configuration ====
==== Manage Scripts ==== <!--T:78-->


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 on the wrench icon. '''Amarok''' 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.
<!--T:79-->
At bottom of the configuration dialog are two options:


==== mp3tunes configuration ====
<!--T:80-->
*<menuchoice>Automatically update built-in scripts</menuchoice>
: 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.


If you have a personal mp3tunes locker, click on the wrench icon and enter your username and password. You will then be able to access your online locker.
<!--T:139-->
*<menuchoice>Manage Scripts</menuchoice> button
: Browse, install and uninstall user-supplied scripts; also search, sort and rate the scripts in the ''Amarok Add-on Installer''.


==== Magnatune Store configuration ====
===== Add-on Installer ===== <!--T:81-->


Listen to the music offered by Magnatune for free and buy it directly through '''Amarok'''. Click on the wrench icon 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.
<!--T:82-->
<br /><br />
[[File:Amarok_add-on_installer.png|300px|thumb|center|Amarok Script Manager]]
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 catalogue and you can search and select the music you want to buy.


<!--T:83-->
Using the ''Add-on Installer'', one can install the latest user-contributed '''Amarok''' scripts. There are also options to search, sort and rate the scripts.


=== Scripts ===
<!--T:84-->
The <menuchoice>Install Scripts</menuchoice> and <menuchoice>Uninstall</menuchoice> buttons can be used to manage scripts. One can install script packages of type amarokscript.tar, amarokscript.tar.bz2, amarokscript.tar.gz


===== Script Information ===== <!--T:85-->


<!--T:87-->
Learn more about a script using the {{Icon|dialog-information}} button.


<!--T:88-->
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 <menuchoice>OK</menuchoice> or the <menuchoice>Apply</menuchoice> button. To deactivate the Script Console deselect it and confirm again.
[[File:AmarokConfigurationDialog2.7ScriptConsole.png|300px|large|center]]


<!--T:89-->
{{Prevnext2
{{Prevnext2
| prevpage=Amarok/Manual/AmarokWindow | nextpage=Amarok/Manual/ConfiguringAmarok/ChangingLayout
| prevpage=Special:myLanguage/Amarok/Manual/AmarokWindow | nextpage=Special:myLanguage/Amarok/Manual/ConfiguringAmarok/ChangingLayout
| prevtext=Amarok Window | nexttext=Changing Layout
| prevtext=Amarok Window | nexttext=Changing Layout
| index=Amarok/Manual | indextext=Back to Menu
| index=Special:myLanguage/Amarok/Manual | indextext=Back to Menu
}}
}}
<!--T:90-->
[[Category:Amarok2.8]]
[[Category:Multimedia]]
[[Category:Tutorials]]
</translate>

Latest revision as of 14:32, 20 July 2013

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

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 Amarok 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

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 Amarok versions, the batch scanner, or media players.
Scan folders recursively (requires full rescan if newly checked) If selected, Amarok 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 Amarok should transcode tracks when they are copied or moved to Local Collection.

Import Statistics

This option allows you to import statistics, e.g. ratings and scores from either

  • an older Amarok 1.4.x version (from SQLite, MySQL or PostgreSQL databases)
  • from iTunes

It does not 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.

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

Configure the playback options, as well as the KDE multimedia framework Phonon.

Option Tooltip
Fadeout on stop 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.
Fadeout on pause If checked, Amarok 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, Amarok will prevent the computer from being suspended will a track is playing.
Pause playback on suspend If checked, Amarok will pause playing of the current track when the computer is about to suspend.
Resume playback on start If checked, Amarok will resume playback where you left it the last session -- just like a tape-player.

Configuring Phonon

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 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 Amarok are typically not Amarok issues, but rather Phonon issues, as Amarok 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 Linux 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


,

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

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.

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.

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 controls Collections, Internet Services, and Local Collection Backends.

Collections

Amarok offers you access to the following Collections, if they are available:

Collection Description
AudioCD Collection AudioCD collection plugin for Amarok
DAAP Collection DAAP collection plugin for Amarok
iPod, iPad & iPhone Collection Plugin to use iPod-like devices as collections in Amarok
MTP Collection MTP collection plugin for Amarok
Universal Mass Storage Collection UMS/USB collection plugin for Amarok
UPnP Collection UPnP collection plugin for Amarok

Internet Services

Amarok 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

Amarok 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 Amarok for paid subscribers. Scrobbling is free, however, provided you enter your Last.fm username and password by clicking . Amarok 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 Amarok. 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 Amarok.

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 (click to enlarge)

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

Generic scripts

Generic scripts add functionality to Amarok. 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 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.
  • 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

Using the Add-on Installer, one can install the latest user-contributed Amarok 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.

large
large