Amarok/Manual/Various/FAQ: Difference between revisions

From KDE UserBase Wiki
mNo edit summary
(Marked this version for translation)
Line 2: Line 2:
<translate>
<translate>


== Frequently Asked Questions ==
== Frequently Asked Questions == <!--T:1-->


=== What is Amarok? ===
=== What is Amarok? === <!--T:2-->


<!--T:3-->
:'''Amarok''' is a music player. More information can be found in [[Special:myLanguage/Amarok|a summary of its features]] and the [http://amarok.kde.org/en/screenshots screenshot gallery]. To get started using '''Amarok''', see the [[Special:myLanguage/Amarok/QuickStartGuide|''Quick Start Guide'']]. The '''Amarok Handbook''' is [[Special:myLanguage/Amarok/Manual/Introduction|here]].
:'''Amarok''' is a music player. More information can be found in [[Special:myLanguage/Amarok|a summary of its features]] and the [http://amarok.kde.org/en/screenshots screenshot gallery]. To get started using '''Amarok''', see the [[Special:myLanguage/Amarok/QuickStartGuide|''Quick Start Guide'']]. The '''Amarok Handbook''' is [[Special:myLanguage/Amarok/Manual/Introduction|here]].


=== What are the differences between Amarok 2 and the previous versions? ===
=== What are the differences between Amarok 2 and the previous versions? === <!--T:4-->


<!--T:5-->
:'''Amarok''' 2 is a nearly complete code-rewrite so the codebase has little to do with '''Amarok''' 1.4. If you are missing a feature, please file a wish in [http://bugs.kde.org Bugzilla].
:'''Amarok''' 2 is a nearly complete code-rewrite so the codebase has little to do with '''Amarok''' 1.4. If you are missing a feature, please file a wish in [http://bugs.kde.org Bugzilla].


<!--T:6-->
:Here you have a short list of some new features:
:Here you have a short list of some new features:


<!--T:7-->
* Maybe the biggest new feature is the ''Service Framework'', which integrates networked music sources directly into '''Amarok'''. This includes online music stores, media servers, Web music lockers, and more. Thanks to it you'll get easy access to music provided by ''Magnatune'', ''Jamendo'', ''Last.fm'', ''MP3Tunes Locker'', '''Ampache''' and many others. Expect more big (and small) names to join during the 2.x lifecycle. See [[Special:myLanguage/Amarok/Manual/AmarokWindow/MediaSources#Internet|Internet Media Sources]] for more.
* Maybe the biggest new feature is the ''Service Framework'', which integrates networked music sources directly into '''Amarok'''. This includes online music stores, media servers, Web music lockers, and more. Thanks to it you'll get easy access to music provided by ''Magnatune'', ''Jamendo'', ''Last.fm'', ''MP3Tunes Locker'', '''Ampache''' and many others. Expect more big (and small) names to join during the 2.x lifecycle. See [[Special:myLanguage/Amarok/Manual/AmarokWindow/MediaSources#Internet|Internet Media Sources]] for more.


<!--T:8-->
* Another exciting feature is the ''Context'' pane, occupying the central place of the '''Amarok'''<nowiki>'s</nowiki> window, replacing the old ''Context Browser'' from the 1.x series. It displays contextual information about the music you play, like the album cover, track rating, labels, lyrics, artist information, related songs and artists, guitar and bass tabs and others. Thanks to the Plasma technology it uses, the ''Context'' pane can provide very rich content, like AJAX, video and animations, all in an eye-catching fashion. More about the [[Special:myLanguage/Amarok/Manual/AmarokWindow/ContextPane|Context pane]].
* Another exciting feature is the ''Context'' pane, occupying the central place of the '''Amarok'''<nowiki>'s</nowiki> window, replacing the old ''Context Browser'' from the 1.x series. It displays contextual information about the music you play, like the album cover, track rating, labels, lyrics, artist information, related songs and artists, guitar and bass tabs and others. Thanks to the Plasma technology it uses, the ''Context'' pane can provide very rich content, like AJAX, video and animations, all in an eye-catching fashion. More about the [[Special:myLanguage/Amarok/Manual/AmarokWindow/ContextPane|Context pane]].


<!--T:9-->
* To accompany the ''Context'' pane, we developed a new, space efficient playlist. In order to preserve horizontal space, it groups the track name, artist, album name and cover art together, and allows further grouping by album names. Plus you can rearrange it to your heart's content! If you prefer the old 1.4 playlist, you can have that too. See [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok/ChangingLayout#Changing_the_Playlist_layout|Changing the Playlist layout]] for more.
* To accompany the ''Context'' pane, we developed a new, space efficient playlist. In order to preserve horizontal space, it groups the track name, artist, album name and cover art together, and allows further grouping by album names. Plus you can rearrange it to your heart's content! If you prefer the old 1.4 playlist, you can have that too. See [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok/ChangingLayout#Changing_the_Playlist_layout|Changing the Playlist layout]] for more.


<!--T:10-->
* Another great gem is the video support. Watching your music videos inside '''Amarok''' feels great!
* Another great gem is the video support. Watching your music videos inside '''Amarok''' feels great!


<!--T:11-->
* We can't forget the ''Dynamic Playlists'', which extend the old ''Dynamic Playlists''. They allow you to define an automatically populated playlist, based on specific probability driven criteria called "biases". The dynamic playlist is joined by the new Automatic Playlist Generator, used to generate lists for specific purposes and of a specified length. See [[Special:myLanguage/Amarok/Manual/Playlist/DynamicPlaylists|Dynamic Playlists]] and [[Special:myLanguage/Amarok/Manual/Playlist/AutomaticPlaylistGenerator|Automatic Playlist Generator]] for more information.
* We can't forget the ''Dynamic Playlists'', which extend the old ''Dynamic Playlists''. They allow you to define an automatically populated playlist, based on specific probability driven criteria called "biases". The dynamic playlist is joined by the new Automatic Playlist Generator, used to generate lists for specific purposes and of a specified length. See [[Special:myLanguage/Amarok/Manual/Playlist/DynamicPlaylists|Dynamic Playlists]] and [[Special:myLanguage/Amarok/Manual/Playlist/AutomaticPlaylistGenerator|Automatic Playlist Generator]] for more information.


<!--T:12-->
:There are many more great features like advanced scripting, dynamic collections, usability improvements, improved media devices handling, a new podcast manager, support for more software platforms, and others.
:There are many more great features like advanced scripting, dynamic collections, usability improvements, improved media devices handling, a new podcast manager, support for more software platforms, and others.


=== Installation ===
=== Installation === <!--T:13-->


==== Can I use Amarok without KDE? ====
==== Can I use Amarok without KDE? ==== <!--T:14-->


<!--T:15-->
:'''Amarok''' requires parts of KDE to be installed to run, but will run fine in Gnome or other desktop environments, including Windows and OSx. For '''Amarok''' to run, kdelibs and kdebase-runtime need to be installed.
:'''Amarok''' requires parts of KDE to be installed to run, but will run fine in Gnome or other desktop environments, including Windows and OSx. For '''Amarok''' to run, kdelibs and kdebase-runtime need to be installed.


<!--T:16-->
:For some features to work correctly, such as the on-screen display, your window manager must be configured to support the relevant ''freedesktop.org'' standards. More about running '''Amarok''' on other platforms [[Special:myLanguage/Amarok/Manual/Various/AmarokOnOtherPlatforms|here]].
:For some features to work correctly, such as the on-screen display, your window manager must be configured to support the relevant ''freedesktop.org'' standards. More about running '''Amarok''' on other platforms [[Special:myLanguage/Amarok/Manual/Various/AmarokOnOtherPlatforms|here]].


==== Why does Amarok use KDElibs? ====
==== Why does Amarok use KDElibs? ==== <!--T:17-->


<!--T:18-->
:We are committed to supporting '''Amarok''' on all platforms. We use KDElibs and Qt because they provide an excellent development environment. Aside from Linux and BSD, '''Amarok''' works on Windows and MacOS, and there are installers available, but unfortunately we don't have (yet) the resources to offer full support for those operating systems. Almost all of our developers use free operating systems, and those have priority for us. We do however welcome Windows and OS X developers willing to help, and improve '''Amarok''' on those platforms.
:We are committed to supporting '''Amarok''' on all platforms. We use KDElibs and Qt because they provide an excellent development environment. Aside from Linux and BSD, '''Amarok''' works on Windows and MacOS, and there are installers available, but unfortunately we don't have (yet) the resources to offer full support for those operating systems. Almost all of our developers use free operating systems, and those have priority for us. We do however welcome Windows and OS X developers willing to help, and improve '''Amarok''' on those platforms.


=== General usage ===
=== General usage === <!--T:19-->


==== How can I control Amarok from the keyboard? ====
==== How can I control Amarok from the keyboard? ==== <!--T:20-->


<!--T:21-->
:Keyboard shortcuts are available; see our [[Special:myLanguage/Amarok/Manual/References/KeybindingReference|Keybinding Reference page]] for more information.
:Keyboard shortcuts are available; see our [[Special:myLanguage/Amarok/Manual/References/KeybindingReference|Keybinding Reference page]] for more information.


<!--T:22-->
:To control '''Amarok''' from the console, type {{Input|1=amarok --help-all}}for a current complete list of available control commands.
:To control '''Amarok''' from the console, type {{Input|1=amarok --help-all}}for a current complete list of available control commands.


==== Where can I get support for Amarok? ====
==== Where can I get support for Amarok? ==== <!--T:23-->


<!--T:24-->
:There are several options. Often times problems you have with the initial install of '''Amarok''' are best answered by experts of your particular Unix or Linux distribution. You may seek help from fellow users and developers at the [http://forum.kde.org/viewforum.php?f=127 '''Amarok''' forum] and the [irc://irc.freenode.net/amarok '''Amarok''' IRC channel] at irc.freenode.net channel #amarok.
:There are several options. Often times problems you have with the initial install of '''Amarok''' are best answered by experts of your particular Unix or Linux distribution. You may seek help from fellow users and developers at the [http://forum.kde.org/viewforum.php?f=127 '''Amarok''' forum] and the [irc://irc.freenode.net/amarok '''Amarok''' IRC channel] at irc.freenode.net channel #amarok.


<!--T:25-->
:Note that [http://bugs.kde.org bugzilla] is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in '''Amarok''' itself.
:Note that [http://bugs.kde.org bugzilla] is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in '''Amarok''' itself.


=== Questions about the Playlist ===
=== Questions about the Playlist === <!--T:26-->


<!--T:27-->
:More about the [[Special:myLanguage/Amarok/Manual/AmarokWindow/PlaylistPane|Playlist here]].
:More about the [[Special:myLanguage/Amarok/Manual/AmarokWindow/PlaylistPane|Playlist here]].


==== When I start Amarok, I see an empty playlist. How do I actually get tracks in there? ====
==== When I start Amarok, I see an empty playlist. How do I actually get tracks in there? ==== <!--T:28-->


<!--T:29-->
:Use the ''Collection'' on the left side to navigate to the desired artist/album/track. Then drag the files into the ''Playlist'' part on the right. You can use ''Dynamic Playlists'' or the ''Automatic Playlist Generator'' to populate your playlist. You can also drag files in from any file manager, such as '''Dolphin'''. You may also double-click a track, artist or genre in your ''Collection'' or file-system, or right-click and <menuchoice>Add to Playlist</menuchoice> or <menuchoice>Replace Playlist</menuchoice>.   
:Use the ''Collection'' on the left side to navigate to the desired artist/album/track. Then drag the files into the ''Playlist'' part on the right. You can use ''Dynamic Playlists'' or the ''Automatic Playlist Generator'' to populate your playlist. You can also drag files in from any file manager, such as '''Dolphin'''. You may also double-click a track, artist or genre in your ''Collection'' or file-system, or right-click and <menuchoice>Add to Playlist</menuchoice> or <menuchoice>Replace Playlist</menuchoice>.   


==== How do I remove tracks from the Playlist? ====
==== How do I remove tracks from the Playlist? ==== <!--T:30-->


<!--T:31-->
:Select the track(s) you want to remove, and press the <keycap>Delete</keycap> key. Or right-click the selection and choose <menuchoice>Remove From Playlist</menuchoice>.
:Select the track(s) you want to remove, and press the <keycap>Delete</keycap> key. Or right-click the selection and choose <menuchoice>Remove From Playlist</menuchoice>.


==== How can I load a playlist? ====
==== How can I load a playlist? ==== <!--T:32-->


<!--T:33-->
:Just drag and drop the playlist file into the ''Playlist'', like you would do with any other file. It's that simple!
:Just drag and drop the playlist file into the ''Playlist'', like you would do with any other file. It's that simple!


==== How can I save the current playlist? ====
==== How can I save the current playlist? ==== <!--T:34-->


<!--T:35-->
:Use the <menuchoice>Save Playlist As</menuchoice> button in the ''Playlist'' toolbar. Slow-click the disc icon to chose to save to your harddisk, or to the database.
:Use the <menuchoice>Save Playlist As</menuchoice> button in the ''Playlist'' toolbar. Slow-click the disc icon to chose to save to your harddisk, or to the database.


=== Playback Questions ===
=== Playback Questions === <!--T:36-->


==== How do I play audio CDs? ====
==== How do I play audio CDs? ==== <!--T:37-->


<!--T:38-->
:When you insert an audio CD, it will be shown as a local collection. Drag to the playlist or ''Pop-Up Dropper'', or right-click the selected tracks and choose <menuchoice>Add to Playlist</menuchoice> or <menuchoice>Replace Playlist</menuchoice>.
:When you insert an audio CD, it will be shown as a local collection. Drag to the playlist or ''Pop-Up Dropper'', or right-click the selected tracks and choose <menuchoice>Add to Playlist</menuchoice> or <menuchoice>Replace Playlist</menuchoice>.


==== What media types does Amarok support? ====
==== What media types does Amarok support? ==== <!--T:39-->


<!--T:40-->
:'''Amarok''' does not play music by itself, but lets ''Phonon'' do that job, specifically the ''VLC'', ''GStreamer'' or ''Xine backends'' of ''Phonon''. Therefore, whatever files they can play, '''Amarok''' can play. To analyse file tags, '''Amarok''' uses ''Taglib'', which supports most file types that contain metadata.
:'''Amarok''' does not play music by itself, but lets ''Phonon'' do that job, specifically the ''VLC'', ''GStreamer'' or ''Xine backends'' of ''Phonon''. Therefore, whatever files they can play, '''Amarok''' can play. To analyse file tags, '''Amarok''' uses ''Taglib'', which supports most file types that contain metadata.


==== What is Phonon? What are Phonon backends? ====
==== What is Phonon? What are Phonon backends? ==== <!--T:41-->


<!--T:42-->
:''Phonon'' is the multimedia framework of KDE 4. You can find more information [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok#Playback|here]].
:''Phonon'' is the multimedia framework of KDE 4. You can find more information [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok#Playback|here]].


<!--T:43-->
:Usually the ''VLC backend'' works better than the ''Xine'' one, although this is not always true. We also suggest you try the ''Gstreamer backend'', although it is still in development. You can find more details on installing backends in the [http://amarok.kde.org/wiki/Download download page].
:Usually the ''VLC backend'' works better than the ''Xine'' one, although this is not always true. We also suggest you try the ''Gstreamer backend'', although it is still in development. You can find more details on installing backends in the [http://amarok.kde.org/wiki/Download download page].


==== Amarok won't play mp3s, what can I do? ====
==== Amarok won't play mp3s, what can I do? ==== <!--T:44-->


<!--T:45-->
:Have a look at the [http://amarok.kde.org/wiki/MP3 mp3 information page]. You probably lack the codecs required by your particular ''phonon-backend'' ('''VLC,''' '''Gstreamer''', or '''Xine''').
:Have a look at the [http://amarok.kde.org/wiki/MP3 mp3 information page]. You probably lack the codecs required by your particular ''phonon-backend'' ('''VLC,''' '''Gstreamer''', or '''Xine''').


==== I can't get any media to play in Amarok, why not? ====
==== I can't get any media to play in Amarok, why not? ==== <!--T:46-->


<!--T:47-->
:Test the sound frameworks at the command line:
:Test the sound frameworks at the command line:
{{Input|xine-check}}
{{Input|xine-check}}
Line 99: Line 126:
:The output from these commands should help you identify the problems you are having and how to fix them.
:The output from these commands should help you identify the problems you are having and how to fix them.


==== I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default? ====
==== I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default? ==== <!--T:48-->


<!--T:49-->
: Configure this in the ''Phonon'' system settings module. <menuchoice>Settings -> Configure Amarok -> Playback -> Configure Phonon</menuchoice>
: Configure this in the ''Phonon'' system settings module. <menuchoice>Settings -> Configure Amarok -> Playback -> Configure Phonon</menuchoice>


==== Where's the equalizer? ====
==== Where's the equalizer? ==== <!--T:50-->


<!--T:51-->
:The equalizer is only available if you are using a ''Phonon''-backend which supports it, which the modern ones now do. You can find it in the <menuchoice>Tools</menuchoice> menu. You can get more information about configuring ''Phonon''-backends in your distribution in the [http://amarok.kde.org/wiki/Download download page].
:The equalizer is only available if you are using a ''Phonon''-backend which supports it, which the modern ones now do. You can find it in the <menuchoice>Tools</menuchoice> menu. You can get more information about configuring ''Phonon''-backends in your distribution in the [http://amarok.kde.org/wiki/Download download page].


==== How do I turn on visualizations? ====
==== How do I turn on visualizations? ==== <!--T:52-->


<!--T:53-->
:Visualizations are not implemented yet, but they will be very soon.
:Visualizations are not implemented yet, but they will be very soon.


==== How can I add podcasts? ====
==== How can I add podcasts? ==== <!--T:54-->


<!--T:55-->
:Go to ''Podcast'' section in the left toolbar and then select <menuchoice>Add Podcast...</menuchoice> Add the podcast URL where indicated. More about podcasts [[Special:myLanguage/Amarok/Manual/AmarokWindow/MediaSources#Podcasts|here]].
:Go to ''Podcast'' section in the left toolbar and then select <menuchoice>Add Podcast...</menuchoice> Add the podcast URL where indicated. More about podcasts [[Special:myLanguage/Amarok/Manual/AmarokWindow/MediaSources#Podcasts|here]].


<!--T:56-->
:We also have some services, such as gpodder and Podcast Directory to help you find great podcasts. Enable services in the <menuchoice>Settings</menuchoice> menu: <menuchoice>Configure Amarok -> Plugins</menuchoice>.
:We also have some services, such as gpodder and Podcast Directory to help you find great podcasts. Enable services in the <menuchoice>Settings</menuchoice> menu: <menuchoice>Configure Amarok -> Plugins</menuchoice>.


==== How can I use Amarok to stream to my own radio station? ====
==== How can I use Amarok to stream to my own radio station? ==== <!--T:57-->


<!--T:58-->
:If you want to stream directly to an icecast or shoutcast server the answer simply is: it is not supported. You could use [http://giss.tv/sahabuntu/doc/idjc.html IDJC] for that.
:If you want to stream directly to an icecast or shoutcast server the answer simply is: it is not supported. You could use [http://giss.tv/sahabuntu/doc/idjc.html IDJC] for that.


=== General questions ===
=== General questions === <!--T:59-->


==== What are scripts? ====
==== What are scripts? ==== <!--T:60-->


<!--T:61-->
:They are little pieces of software that add some functions to '''Amarok'''. There are a lot of scripts, and you can find them in [http://www.kde-apps.org/index.php?xcontentmode=57 kde-apps.org] or you can find and install them inside '''Amarok''' using the ''Script Manager'' (until '''Amarok''' 2.4.1). More details [[Special:myLanguage/Amarok/Manual/Organization/ScriptManager|here]]. After '''Amarok''' 2.4.1, you will find the Script Manager from the <menuchoice>Settings</menuchoice> menu, <menuchoice>Configure Amarok -> Scripts</menuchoice>.
:They are little pieces of software that add some functions to '''Amarok'''. There are a lot of scripts, and you can find them in [http://www.kde-apps.org/index.php?xcontentmode=57 kde-apps.org] or you can find and install them inside '''Amarok''' using the ''Script Manager'' (until '''Amarok''' 2.4.1). More details [[Special:myLanguage/Amarok/Manual/Organization/ScriptManager|here]]. After '''Amarok''' 2.4.1, you will find the Script Manager from the <menuchoice>Settings</menuchoice> menu, <menuchoice>Configure Amarok -> Scripts</menuchoice>.


==== Can I use Amarok 1.4 scripts in Amarok 2? ====
==== Can I use Amarok 1.4 scripts in Amarok 2? ==== <!--T:62-->


<!--T:63-->
:No. A new and powerful scripting API has been created, which provides huge improvements but won't let you use your old scripts. The new scripting system is based on QtScript and will significantly reduce '''Amarok'''<nowiki>'s</nowiki> dependencies, a huge problem for non-technical and cross-platform users, and will greatly reduce the amount of external processes launched at runtime.  Another advantage is that the new API will allow much deeper integration with '''Amarok''' than the old scripting system. [http://amarok.kde.org/wiki/Development/Script_API Amarok Scripting API].
:No. A new and powerful scripting API has been created, which provides huge improvements but won't let you use your old scripts. The new scripting system is based on QtScript and will significantly reduce '''Amarok'''<nowiki>'s</nowiki> dependencies, a huge problem for non-technical and cross-platform users, and will greatly reduce the amount of external processes launched at runtime.  Another advantage is that the new API will allow much deeper integration with '''Amarok''' than the old scripting system. [http://amarok.kde.org/wiki/Development/Script_API Amarok Scripting API].


==== What are Moodbars? ====
==== What are Moodbars? ==== <!--T:64-->


<!--T:65-->
:''Moodbars'' show the mood of a song in the progress bar. More about '''Moodbar''' [[Special:myLanguage/Amarok/Manual/Various/Moodbar|here]].
:''Moodbars'' show the mood of a song in the progress bar. More about '''Moodbar''' [[Special:myLanguage/Amarok/Manual/Various/Moodbar|here]].


==== Can I play video files? ====
==== Can I play video files? ==== <!--T:66-->


<!--T:67-->
:'''Amarok''' is mainly a music player so no video file management, collection support, DVD playback, subtitles, or any other sophisticated features are available. However, the ''video applet'' lets you play YouTube video clips inside '''Amarok'''.
:'''Amarok''' is mainly a music player so no video file management, collection support, DVD playback, subtitles, or any other sophisticated features are available. However, the ''video applet'' lets you play YouTube video clips inside '''Amarok'''.


==== Is it Amarok, AmaroK or amaroK? ====
==== Is it Amarok, AmaroK or amaroK? ==== <!--T:68-->


<!--T:69-->
:It is '''Amarok'''! The former spelling was ''amaroK'', but it was changed due to its strange look.
:It is '''Amarok'''! The former spelling was ''amaroK'', but it was changed due to its strange look.


==== How are track scores determined? ====
==== How are track scores determined? ==== <!--T:70-->


<!--T:71-->
:'''Amarok''' assigns a score (a number 0-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing.  Every time the song finishes playing, the score is changed.
:'''Amarok''' assigns a score (a number 0-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing.  Every time the song finishes playing, the score is changed.


<!--T:72-->
:Here you have an example script that can calculate scores:
:Here you have an example script that can calculate scores:


   if( playcount <= 0 ) # not supposed to be less, but what the hell.
   <!--T:73-->
if( playcount <= 0 ) # not supposed to be less, but what the hell.
       newscore = ( prevscore + percentage ) / 2
       newscore = ( prevscore + percentage ) / 2
   else
   else
Line 155: Line 196:
   end
   end


<!--T:74-->
:You can easily create your own script with your own algorithm. Look at the [http://amarok.kde.org/wiki/Development/Scripting_HowTo_2.0 Script-Writing-Howto] for further information.
:You can easily create your own script with your own algorithm. Look at the [http://amarok.kde.org/wiki/Development/Scripting_HowTo_2.0 Script-Writing-Howto] for further information.


==== How do I manually change a track's score? ====
==== How do I manually change a track's score? ==== <!--T:75-->


<!--T:76-->
:You may change the score manually in the ''Edit Track Details'' dialog, available by right-clicking on a track, and choosing the <menuchoice>Summary</menuchoice> tab. Before '''Amarok''' 2.4.1, this is called the <menuchoice>Statistics</menuchoice> tab.
:You may change the score manually in the ''Edit Track Details'' dialog, available by right-clicking on a track, and choosing the <menuchoice>Summary</menuchoice> tab. Before '''Amarok''' 2.4.1, this is called the <menuchoice>Statistics</menuchoice> tab.


==== But I also want that stars system like in other players! ====
==== But I also want that stars system like in other players! ==== <!--T:77-->


<!--T:78-->
:'''Amarok''', of course, supports an user-defined rating system, and you can rate your tracks with a single click using the ''Current Track applet''. You can also do this in the context menu (right-click) <menuchoice>Edit Track Details -> Summary</menuchoice> tab (before Amarok 2.4.1, this is <menuchoice>Edit Track Details -> Statistics</menuchoice>). If you have the rating stars displayed in your playlist layout, you can also edit there, with the ''slow double-click''.
:'''Amarok''', of course, supports an user-defined rating system, and you can rate your tracks with a single click using the ''Current Track applet''. You can also do this in the context menu (right-click) <menuchoice>Edit Track Details -> Summary</menuchoice> tab (before Amarok 2.4.1, this is <menuchoice>Edit Track Details -> Statistics</menuchoice>). If you have the rating stars displayed in your playlist layout, you can also edit there, with the ''slow double-click''.


==== Can I drag and drop Plasma applets from the main window to the Desktop? ====
==== Can I drag and drop Plasma applets from the main window to the Desktop? ==== <!--T:79-->


<!--T:80-->
:No, but there are many Plasmoids available for your Desktop, which will let you display information provided by '''Amarok''' as well as control '''Amarok'''.
:No, but there are many Plasmoids available for your Desktop, which will let you display information provided by '''Amarok''' as well as control '''Amarok'''.


==== Can I use removable media inside Amarok? ====
==== Can I use removable media inside Amarok? ==== <!--T:81-->


<!--T:82-->
:'''Amarok''' has a greatly improved support for the media devices based on ''Solid'', the KDE hardware layer, that doesn't need a lot of configuration. You should be able to just plug in your device and access it within '''Amarok'''. Also, thanks to the ''Dynamic Collections'', your media devices could become part of your music collection, and be searchable and accessible within the ''Collection Browser'' when it's connected.
:'''Amarok''' has a greatly improved support for the media devices based on ''Solid'', the KDE hardware layer, that doesn't need a lot of configuration. You should be able to just plug in your device and access it within '''Amarok'''. Also, thanks to the ''Dynamic Collections'', your media devices could become part of your music collection, and be searchable and accessible within the ''Collection Browser'' when it's connected.


<!--T:83-->
:You can transfer your songs, albums and artists from your local collection by right-clicking <menuchoice>Copy to Collection -> Your device</menuchoice>; and you can also do it in the other way: right-click <menuchoice>Copy to Collection -> Local Collection</menuchoice>. More about '''Amarok''' and devices [[Special:myLanguage/Amarok/Manual/Organization/Collection/WorkingWithMediaDevices|here]].
:You can transfer your songs, albums and artists from your local collection by right-clicking <menuchoice>Copy to Collection -> Your device</menuchoice>; and you can also do it in the other way: right-click <menuchoice>Copy to Collection -> Local Collection</menuchoice>. More about '''Amarok''' and devices [[Special:myLanguage/Amarok/Manual/Organization/Collection/WorkingWithMediaDevices|here]].


==== How can I save a stream? ====
==== How can I save a stream? ==== <!--T:84-->


<!--T:85-->
:First of all, load the stream into the playlist. There are several ways to do this: downloading the file, for example from [http://www.shoutcast.com shoutcast.com], and opening it with '''Amarok'''; using the menu <menuchoice>Playlist -> Add stream</menuchoice>; among others.
:First of all, load the stream into the playlist. There are several ways to do this: downloading the file, for example from [http://www.shoutcast.com shoutcast.com], and opening it with '''Amarok'''; using the menu <menuchoice>Playlist -> Add stream</menuchoice>; among others.


<!--T:86-->
:Once the stream is loaded, you can save it by clicking on <menuchoice>Save current playlist</menuchoice> which is under the Playlist, and giving it a meaningful name. The Stream will then be added to the ''Saved playlists view'' for later reference.
:Once the stream is loaded, you can save it by clicking on <menuchoice>Save current playlist</menuchoice> which is under the Playlist, and giving it a meaningful name. The Stream will then be added to the ''Saved playlists view'' for later reference.


==== Can I use the old Amarok's collection in Amarok 2? Will my tags, score are ratings be lost? ====
==== Can I use the old Amarok's collection in Amarok 2? Will my tags, score are ratings be lost? ==== <!--T:87-->


<!--T:88-->
:A database importer is available. You will be able to keep your ratings and statistics just fine. More [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok#Collection|here]].
:A database importer is available. You will be able to keep your ratings and statistics just fine. More [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok#Collection|here]].


==== Where do I find the settings for Amarok? ====
==== Where do I find the settings for Amarok? ==== <!--T:89-->


<!--T:90-->
:`kde4-config --localprefix`/share/apps/amarok
:`kde4-config --localprefix`/share/apps/amarok


<!--T:91-->
:`kde4-config --localprefix`/share/config/amarokrc
:`kde4-config --localprefix`/share/config/amarokrc


=== Troubleshooting ===
=== Troubleshooting === <!--T:92-->


==== How can I obtain a backtrace? ====
==== How can I obtain a backtrace? ==== <!--T:93-->


<!--T:94-->
:If '''Amarok''' has crashed and you want to report it, visit the [http://amarok.kde.org/wiki/Debugging_(documentation) Debugging HowTo]. The bug report must be sent in [http://bugs.kde.org bugs.kde.org] after verifying if it has already been reported.
:If '''Amarok''' has crashed and you want to report it, visit the [http://amarok.kde.org/wiki/Debugging_(documentation) Debugging HowTo]. The bug report must be sent in [http://bugs.kde.org bugs.kde.org] after verifying if it has already been reported.


==== Amarok just freezes! How can I help get this fixed? ====
==== Amarok just freezes! How can I help get this fixed? ==== <!--T:95-->


<!--T:96-->
:You can obtain a backtrace of a frozen instance of '''Amarok''' using gdb like so:
:You can obtain a backtrace of a frozen instance of '''Amarok''' using gdb like so:
{{Input|1=$ gdb -p `pidof amarok`
{{Input|1=$ gdb -p `pidof amarok`


  (gdb) thread apply full bt all}}
  <!--T:97-->
(gdb) thread apply full bt all}}


<!--T:98-->
:Then just post the backtrace to [http://paste.kde.org/ PasteBin], as described in the [http://amarok.kde.org/wiki/Debugging_%28documentation%29 Debugging HowTo].
:Then just post the backtrace to [http://paste.kde.org/ PasteBin], as described in the [http://amarok.kde.org/wiki/Debugging_%28documentation%29 Debugging HowTo].


==== Amarok takes a lot of time to start ====
==== Amarok takes a lot of time to start ==== <!--T:99-->


<!--T:100-->
:If this happens you have to check what scripts you have installed and what internet services are running, because some of them may slow down the startup. Also, if you have streams in the playlist when you open '''Amarok''', the startup can take a little longer.
:If this happens you have to check what scripts you have installed and what internet services are running, because some of them may slow down the startup. Also, if you have streams in the playlist when you open '''Amarok''', the startup can take a little longer.


<!--T:101-->
:On the other hand, if you don't use KDE, but a different desktop environment, startup time can be increased very slightly because there are more libraries to be loaded.
:On the other hand, if you don't use KDE, but a different desktop environment, startup time can be increased very slightly because there are more libraries to be loaded.


=== Development questions ===
=== Development questions === <!--T:102-->


==== How do I get a GIT version of Amarok? ====
==== How do I get a GIT version of Amarok? ==== <!--T:103-->


<!--T:104-->
:[http://techbase.kde.org/Getting_Started/Sources/KDE_git-tutorial How to obtain and build '''Amarok''' Git]. Check here for a local build: [http://blogs.fsfe.org/myriam/2009/09/compiling-amarok-from-git-locally-full-summary/ Building from Git Locally: Full Summary]
:[http://techbase.kde.org/Getting_Started/Sources/KDE_git-tutorial How to obtain and build '''Amarok''' Git]. Check here for a local build: [http://blogs.fsfe.org/myriam/2009/09/compiling-amarok-from-git-locally-full-summary/ Building from Git Locally: Full Summary]


==== Why isn't Amarok part of KDEmultimedia? ====
==== Why isn't Amarok part of KDEmultimedia? ==== <!--T:105-->


<!--T:106-->
:The developers don't want ''the man'' telling them when they can release. (Meaning, packages in the KDE SC proper have a release schedule that doesn't fit with '''Amarok's''' fast-paced development.)
:The developers don't want ''the man'' telling them when they can release. (Meaning, packages in the KDE SC proper have a release schedule that doesn't fit with '''Amarok's''' fast-paced development.)


==== I've found a bug / I've got a great idea for Amarok! ====
==== I've found a bug / I've got a great idea for Amarok! ==== <!--T:107-->


<!--T:108-->
:Please report it at [http://bugs.kde.org/enter_bug.cgi?product=amarok bugs.kde.org]. If you have a list of suggestions or wishes it may be best to send them to our mailing list: [mailto:[email protected] [email protected]]. Simply posting the idea to our IRC channels or on an obscure wiki page or blog won't help much as the information will get lost.
:Please report it at [http://bugs.kde.org/enter_bug.cgi?product=amarok bugs.kde.org]. If you have a list of suggestions or wishes it may be best to send them to our mailing list: [mailto:[email protected] [email protected]]. Simply posting the idea to our IRC channels or on an obscure wiki page or blog won't help much as the information will get lost.


==== Do you accept patches? ====
==== Do you accept patches? ==== <!--T:109-->


<!--T:110-->
:Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret; we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of '''Amarok'''. Submit your patches and code contributions to git.reviewboard.kde.org. See also [http://blogs.fsfe.org/myriam/2010/09/how-to-submit-patches-for-amarok/ How to Submit Patches to '''Amarok''']. If you have a bug fix then just go ahead; this is open source after all. :)
:Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret; we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of '''Amarok'''. Submit your patches and code contributions to git.reviewboard.kde.org. See also [http://blogs.fsfe.org/myriam/2010/09/how-to-submit-patches-for-amarok/ How to Submit Patches to '''Amarok''']. If you have a bug fix then just go ahead; this is open source after all. :)


==== Why did you choose the name Amarok? ====
==== Why did you choose the name Amarok? ==== <!--T:111-->


<!--T:112-->
:''Amarok'' is an album by British composer Mike Oldfield. Project founder Mark Kretschmann happens to like it a lot, and he thought the name had a nice sound. Plus, of course, it contains the all important '''K'''. {{Smiley}}
:''Amarok'' is an album by British composer Mike Oldfield. Project founder Mark Kretschmann happens to like it a lot, and he thought the name had a nice sound. Plus, of course, it contains the all important '''K'''. {{Smiley}}




<!--T:113-->
{{Prevnext2
{{Prevnext2
| prevpage=Special:myLanguage/Amarok/Manual/Various/TroubleshootingAndCommonProblems | nextpage=Special:myLanguage/Amarok/Manual/References
| prevpage=Special:myLanguage/Amarok/Manual/Various/TroubleshootingAndCommonProblems | nextpage=Special:myLanguage/Amarok/Manual/References
Line 241: Line 305:
}}
}}


<!--T:114-->
[[Category:Amarok]]
[[Category:Amarok]]
[[Category:Multimedia]]
[[Category:Multimedia]]
[[Category:Tutorials]]
[[Category:Tutorials]]
</translate>
</translate>

Revision as of 13:23, 26 November 2011

Frequently Asked Questions

What is Amarok?

Amarok is a music player. More information can be found in a summary of its features and the screenshot gallery. To get started using Amarok, see the Quick Start Guide. The Amarok Handbook is here.

What are the differences between Amarok 2 and the previous versions?

Amarok 2 is a nearly complete code-rewrite so the codebase has little to do with Amarok 1.4. If you are missing a feature, please file a wish in Bugzilla.
Here you have a short list of some new features:
  • Maybe the biggest new feature is the Service Framework, which integrates networked music sources directly into Amarok. This includes online music stores, media servers, Web music lockers, and more. Thanks to it you'll get easy access to music provided by Magnatune, Jamendo, Last.fm, MP3Tunes Locker, Ampache and many others. Expect more big (and small) names to join during the 2.x lifecycle. See Internet Media Sources for more.
  • Another exciting feature is the Context pane, occupying the central place of the Amarok's window, replacing the old Context Browser from the 1.x series. It displays contextual information about the music you play, like the album cover, track rating, labels, lyrics, artist information, related songs and artists, guitar and bass tabs and others. Thanks to the Plasma technology it uses, the Context pane can provide very rich content, like AJAX, video and animations, all in an eye-catching fashion. More about the Context pane.
  • To accompany the Context pane, we developed a new, space efficient playlist. In order to preserve horizontal space, it groups the track name, artist, album name and cover art together, and allows further grouping by album names. Plus you can rearrange it to your heart's content! If you prefer the old 1.4 playlist, you can have that too. See Changing the Playlist layout for more.
  • Another great gem is the video support. Watching your music videos inside Amarok feels great!
  • We can't forget the Dynamic Playlists, which extend the old Dynamic Playlists. They allow you to define an automatically populated playlist, based on specific probability driven criteria called "biases". The dynamic playlist is joined by the new Automatic Playlist Generator, used to generate lists for specific purposes and of a specified length. See Dynamic Playlists and Automatic Playlist Generator for more information.
There are many more great features like advanced scripting, dynamic collections, usability improvements, improved media devices handling, a new podcast manager, support for more software platforms, and others.

Installation

Can I use Amarok without KDE?

Amarok requires parts of KDE to be installed to run, but will run fine in Gnome or other desktop environments, including Windows and OSx. For Amarok to run, kdelibs and kdebase-runtime need to be installed.
For some features to work correctly, such as the on-screen display, your window manager must be configured to support the relevant freedesktop.org standards. More about running Amarok on other platforms here.

Why does Amarok use KDElibs?

We are committed to supporting Amarok on all platforms. We use KDElibs and Qt because they provide an excellent development environment. Aside from Linux and BSD, Amarok works on Windows and MacOS, and there are installers available, but unfortunately we don't have (yet) the resources to offer full support for those operating systems. Almost all of our developers use free operating systems, and those have priority for us. We do however welcome Windows and OS X developers willing to help, and improve Amarok on those platforms.

General usage

How can I control Amarok from the keyboard?

Keyboard shortcuts are available; see our Keybinding Reference page for more information.
To control Amarok from the console, type
amarok --help-all
for a current complete list of available control commands.

Where can I get support for Amarok?

There are several options. Often times problems you have with the initial install of Amarok are best answered by experts of your particular Unix or Linux distribution. You may seek help from fellow users and developers at the Amarok forum and the Amarok IRC channel at irc.freenode.net channel #amarok.
Note that bugzilla is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in Amarok itself.

Questions about the Playlist

More about the Playlist here.

When I start Amarok, I see an empty playlist. How do I actually get tracks in there?

Use the Collection on the left side to navigate to the desired artist/album/track. Then drag the files into the Playlist part on the right. You can use Dynamic Playlists or the Automatic Playlist Generator to populate your playlist. You can also drag files in from any file manager, such as Dolphin. You may also double-click a track, artist or genre in your Collection or file-system, or right-click and Add to Playlist or Replace Playlist.

How do I remove tracks from the Playlist?

Select the track(s) you want to remove, and press the Delete key. Or right-click the selection and choose Remove From Playlist.

How can I load a playlist?

Just drag and drop the playlist file into the Playlist, like you would do with any other file. It's that simple!

How can I save the current playlist?

Use the Save Playlist As button in the Playlist toolbar. Slow-click the disc icon to chose to save to your harddisk, or to the database.

Playback Questions

How do I play audio CDs?

When you insert an audio CD, it will be shown as a local collection. Drag to the playlist or Pop-Up Dropper, or right-click the selected tracks and choose Add to Playlist or Replace Playlist.

What media types does Amarok support?

Amarok does not play music by itself, but lets Phonon do that job, specifically the VLC, GStreamer or Xine backends of Phonon. Therefore, whatever files they can play, Amarok can play. To analyse file tags, Amarok uses Taglib, which supports most file types that contain metadata.

What is Phonon? What are Phonon backends?

Phonon is the multimedia framework of KDE 4. You can find more information here.
Usually the VLC backend works better than the Xine one, although this is not always true. We also suggest you try the Gstreamer backend, although it is still in development. You can find more details on installing backends in the download page.

Amarok won't play mp3s, what can I do?

Have a look at the mp3 information page. You probably lack the codecs required by your particular phonon-backend (VLC, Gstreamer, or Xine).

I can't get any media to play in Amarok, why not?

Test the sound frameworks at the command line:
xine-check
(The xine-ui package contains xine-check)
The output from these commands should help you identify the problems you are having and how to fix them.

I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default?

Configure this in the Phonon system settings module. Settings -> Configure Amarok -> Playback -> Configure Phonon

Where's the equalizer?

The equalizer is only available if you are using a Phonon-backend which supports it, which the modern ones now do. You can find it in the Tools menu. You can get more information about configuring Phonon-backends in your distribution in the download page.

How do I turn on visualizations?

Visualizations are not implemented yet, but they will be very soon.

How can I add podcasts?

Go to Podcast section in the left toolbar and then select Add Podcast... Add the podcast URL where indicated. More about podcasts here.
We also have some services, such as gpodder and Podcast Directory to help you find great podcasts. Enable services in the Settings menu: Configure Amarok -> Plugins.

How can I use Amarok to stream to my own radio station?

If you want to stream directly to an icecast or shoutcast server the answer simply is: it is not supported. You could use IDJC for that.

General questions

What are scripts?

They are little pieces of software that add some functions to Amarok. There are a lot of scripts, and you can find them in kde-apps.org or you can find and install them inside Amarok using the Script Manager (until Amarok 2.4.1). More details here. After Amarok 2.4.1, you will find the Script Manager from the Settings menu, Configure Amarok -> Scripts.

Can I use Amarok 1.4 scripts in Amarok 2?

No. A new and powerful scripting API has been created, which provides huge improvements but won't let you use your old scripts. The new scripting system is based on QtScript and will significantly reduce Amarok's dependencies, a huge problem for non-technical and cross-platform users, and will greatly reduce the amount of external processes launched at runtime. Another advantage is that the new API will allow much deeper integration with Amarok than the old scripting system. Amarok Scripting API.

What are Moodbars?

Moodbars show the mood of a song in the progress bar. More about Moodbar here.

Can I play video files?

Amarok is mainly a music player so no video file management, collection support, DVD playback, subtitles, or any other sophisticated features are available. However, the video applet lets you play YouTube video clips inside Amarok.

Is it Amarok, AmaroK or amaroK?

It is Amarok! The former spelling was amaroK, but it was changed due to its strange look.

How are track scores determined?

Amarok assigns a score (a number 0-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing. Every time the song finishes playing, the score is changed.
Here you have an example script that can calculate scores:
  if( playcount <= 0 ) # not supposed to be less, but what the hell.
      newscore = ( prevscore + percentage ) / 2
  else
      newscore = ( ( prevscore * playcount ) + percentage ) / ( playcount + 1 )
  end
You can easily create your own script with your own algorithm. Look at the Script-Writing-Howto for further information.

How do I manually change a track's score?

You may change the score manually in the Edit Track Details dialog, available by right-clicking on a track, and choosing the Summary tab. Before Amarok 2.4.1, this is called the Statistics tab.

But I also want that stars system like in other players!

Amarok, of course, supports an user-defined rating system, and you can rate your tracks with a single click using the Current Track applet. You can also do this in the context menu (right-click) Edit Track Details -> Summary tab (before Amarok 2.4.1, this is Edit Track Details -> Statistics). If you have the rating stars displayed in your playlist layout, you can also edit there, with the slow double-click.

Can I drag and drop Plasma applets from the main window to the Desktop?

No, but there are many Plasmoids available for your Desktop, which will let you display information provided by Amarok as well as control Amarok.

Can I use removable media inside Amarok?

Amarok has a greatly improved support for the media devices based on Solid, the KDE hardware layer, that doesn't need a lot of configuration. You should be able to just plug in your device and access it within Amarok. Also, thanks to the Dynamic Collections, your media devices could become part of your music collection, and be searchable and accessible within the Collection Browser when it's connected.
You can transfer your songs, albums and artists from your local collection by right-clicking Copy to Collection -> Your device; and you can also do it in the other way: right-click Copy to Collection -> Local Collection. More about Amarok and devices here.

How can I save a stream?

First of all, load the stream into the playlist. There are several ways to do this: downloading the file, for example from shoutcast.com, and opening it with Amarok; using the menu Playlist -> Add stream; among others.
Once the stream is loaded, you can save it by clicking on Save current playlist which is under the Playlist, and giving it a meaningful name. The Stream will then be added to the Saved playlists view for later reference.

Can I use the old Amarok's collection in Amarok 2? Will my tags, score are ratings be lost?

A database importer is available. You will be able to keep your ratings and statistics just fine. More here.

Where do I find the settings for Amarok?

`kde4-config --localprefix`/share/apps/amarok
`kde4-config --localprefix`/share/config/amarokrc

Troubleshooting

How can I obtain a backtrace?

If Amarok has crashed and you want to report it, visit the Debugging HowTo. The bug report must be sent in bugs.kde.org after verifying if it has already been reported.

Amarok just freezes! How can I help get this fixed?

You can obtain a backtrace of a frozen instance of Amarok using gdb like so:
$ gdb -p `pidof amarok`

 (gdb) thread apply full bt all
Then just post the backtrace to PasteBin, as described in the Debugging HowTo.

Amarok takes a lot of time to start

If this happens you have to check what scripts you have installed and what internet services are running, because some of them may slow down the startup. Also, if you have streams in the playlist when you open Amarok, the startup can take a little longer.
On the other hand, if you don't use KDE, but a different desktop environment, startup time can be increased very slightly because there are more libraries to be loaded.

Development questions

How do I get a GIT version of Amarok?

How to obtain and build Amarok Git. Check here for a local build: Building from Git Locally: Full Summary

Why isn't Amarok part of KDEmultimedia?

The developers don't want the man telling them when they can release. (Meaning, packages in the KDE SC proper have a release schedule that doesn't fit with Amarok's fast-paced development.)

I've found a bug / I've got a great idea for Amarok!

Please report it at bugs.kde.org. If you have a list of suggestions or wishes it may be best to send them to our mailing list: [email protected]. Simply posting the idea to our IRC channels or on an obscure wiki page or blog won't help much as the information will get lost.

Do you accept patches?

Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret; we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of Amarok. Submit your patches and code contributions to git.reviewboard.kde.org. See also How to Submit Patches to Amarok. If you have a bug fix then just go ahead; this is open source after all. :)

Why did you choose the name Amarok?

Amarok is an album by British composer Mike Oldfield. Project founder Mark Kretschmann happens to like it a lot, and he thought the name had a nice sound. Plus, of course, it contains the all important K.