Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

=== Frequently Asked Questions ===

==== What is Amarok? ====

:'''Amarok''' is an audio 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? ====

:'''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].

: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 [[Special:myLanguage/Amarok/Manual/AmarokWindow/MediaSources#Internet|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 [[Special:myLanguage/Amarok/Manual/AmarokWindow/ContextPane|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 [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok/ChangingLayout#Changing_the_Playlist_layout|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 Playlists''' 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.

: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 OS X. 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 [[Special:myLanguage/Amarok/Manual/Various/AmarokOnOtherPlatforms|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 [[Special:myLanguage/Amarok/Manual/References/KeybindingReference|Keybinding Reference page]] for more information.

: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? =====

: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.

: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.

===== How do I report a bug?=====

:If you find a bug in '''Amarok''', please submit it to the [https://bugs.kde.org KDE bugzilla instance]. To make a complete bug report, please always include the following information:

* The exact '''Amarok''' version (the version can be found in <menuchoice>Help -> About Amarok</menuchoice>). You should not report bugs for '''Amarok''' versions older than the current stable release as we do not provide backport fixes.

* The exact KDE and Qt version, even if you do not run '''Amarok''' in KDE (<menuchoice>Help -> About KDE</menuchoice>)

* The exact Phonon backend. You can find this information in the Diagnostics (<menuchoice>Help -> Diagnostics </menuchoice>)

* Whether the bug is reproducible. Please do not report bugs that you can not reproduce as these are almost impossible to fix.

* Exact steps how to reproduce the bug

:If any of these information is missing the bug report is not complete. Please also be prepared to answer questions from the developers or bug triagers and eventually test other settings.

==== Questions about the Playlist ====

: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? =====

:Use the '''Media Sources''' 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 '''Media Sources''' 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? =====

: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? =====

: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? =====

:Click the {{Icon|document-save}} 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? =====

:Audio CDs are treated differently than data CDs, which are also supported. When you insert an audio CD, it will be shown as a local collection. Drag to the playlist or ''Pop-Up Dropper'', or right-click the selected tracks and choose <menuchoice>Add to Playlist</menuchoice> or <menuchoice>Replace Playlist</menuchoice>.
<span id="What media types does Amarok support?"></span>
===== What media types does Amarok support? =====

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

===== What is Phonon? What are Phonon backends? =====

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

:We currently recommend both the Gstreamer and  VLC backend as both are actively maintained. If you want to play streams you should use the VLC backend only as the Gstreamer backend has some shortcomings in this regard. Make sure you do not use any other backend as those are obsolete.

:If you are using the Phonon-backend-gstreamer make sure you only use plugins from one single gstreamer version, else your sound will be compromised.

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

You probably lack the codecs required by your particular Phonon backend (Gstreamer, or VLC). Please report this to your distribution if you were not prompted to install them automatically when you started '''Amarok''' for the first time.

===== I have the codecs, but Amarok still won't play mp4s and mkas =====

When using some phonon backend, like the gstreamer one, '''Amarok''' might refuse to play <tt>mp4</tt> and <tt>mka</tt> files. This is a known problem, see <s>{{bug|290168}}</s> for more technical information.

A very simple workaround is to change the file extension. Change <tt>mp4</tt> extension to <tt>m4a</tt> and for <tt>mka</tt> change it to <tt>mkv</tt>. Of course you must be sure the files contains audio only. You can use the ffprobe command to look at what data streams are present in the file. If the file has a video stream it must be stripped out. There are a lot of tools able to edit these formats and most of them are based on <tt>ffmpeg</tt>/<tt>libav</tt>, which you can use if you are familiar with them. If you prefer graphical tools one possible choice is [http://www.avidemux.org/ avidemux].

This is a quick example how you can remove a video stream from an <tt>mp4</tt> video with ffmpeg. Stripping a video stream from an <tt>mkv</tt> file is the same. First check if there is a video stream

{{Input|1=<nowiki>$ ffprobe example.mp4 2>&1 | grep Video</nowiki>}}
{{Output|1=<nowiki>Stream #0.1(und): Video: h264 (Baseline), yuv420p, 480x360 [PAR 1:1 DAR 4:3], 242 kb/s, 25 fps, 25 tbr, 25k tbn, 50k tbc</nowiki>}}

If the output of the previous command is null there is no video stream in the file. To create an <tt>m4a</tt> file with just the audio stream you can use something like

{{Input|1=<nowiki>
ffmpeg -i example.mp4 -acodec copy -vn example.m4a
</nowiki>}}

You can also use <tt>avconv</tt> in place of <tt>ffmpeg</tt> with the same options, where

* ''-i example.mp4'' option is the input file name

* ''-acodec copy'' is used to not encode again the audio stream but just copy it. This to avoid quality loss, but you can also encode in a different format if you want, and you are not forced to use m4a container in this case

* ''-vn'' strips the video stream

* '''''example.m4a''''' is the output file name

Another possible workaround is to change the phonon backend. For example the VLC backend doesn't suffer this problem.

===== 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. <menuchoice>Settings -> Configure Amarok -> Playback -> Configure Phonon</menuchoice>

===== Where's the equalizer? =====

:The equalizer is only available if you are using the phonon-backend-gstreamer. You can find the equalizer in the <menuchoice>Tools</menuchoice> menu.

===== How can I control the volume in Amarok only without having to change in KMix? =====

: Most distributions ship the '''PulseAudio''' sound-daemon nowadays which handles the sound settings system-wide. If you can't change the volume in '''Amarok''' independently of '''KMix''', then your '''Pulseaudio''' settings have the option
 <blockquote>flat-volume=yes</blockquote> 
:enabled. Depending on your distribution this is located either in the file <tt>$HOME/.pulse/daemon.conf</tt> or in the system file <tt>/etc/pulse/daemon.conf</tt>. More information about Pulseudio-specific settings can be found in [http://linux.die.net/man/5/pulse-daemon.conf pulse-daemon.conf man page].

===== How do I turn on visualizations? =====

:Visualizations come in the form of an applet. For more information please see the [[Special:myLanguage/Amarok/Manual/AmarokWindow/ContextPane#Applets|applets page]]. Visualizations are currently under development and may be buggy at this time.

===== How can I add podcasts? =====

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

: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? =====

: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.

==== Collection questions ====

===== Folder not properly picked up =====

If you find that most of your music is recognized by '''Amarok''', but some folders are not properly picked up, open a console and type

where '''''folder''''' is the path to the folder that has the problem. Then select <menuchoice>Settings -> Configure Amarok</menuchoice> in '''Amarok''' main window menu, open <menuchoice>Collection</menuchoice> page and click the <menuchoice>Full Rescan</menuchoice> button. Your folder should be visible again now.

{{Warning|1= this will not work on Windows, as the touch command is specific to Linux and BSD-like systems.}}

===== 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 '''Local Music''' section of the '''Media Sources''' pane when it's connected.

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

===== 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 [[Special:myLanguage/Amarok/Manual/ConfiguringAmarok#Collection|here]].

==== 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 [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'''. More details can be found [[Special:myLanguage/Amarok/Manual/Organization/ScriptManager|here]]. 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? =====

: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. [http://community.kde.org/Amarok/Development/Script_API Amarok Scripting API].

===== What are Moodbars? =====

:'''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? =====

:'''Amarok''' is mainly a music player so no video file management, collection support, DVD playback, subtitles, or any other sophisticated features are available.

===== Is it Amarok, AmaroK or amaroK? =====

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

===== 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:

{{Input|1=<nowiki>if( playcount <= 0 ) # not supposed to be less, but what the hell.
       newscore = ( prevscore + percentage ) / 2
   else
       newscore = ( ( prevscore * playcount ) + percentage ) / ( playcount + 1 )
   end
</nowiki>}}

:You can easily create your own script with your own algorithm. Look at the [http://community.kde.org/Amarok/Development/Scripting_HowTo_2.0 Script-Writing-Howto] for further information.

===== How do I manually change a track's score? =====

:You may change the score manually in the '''Track Details''' dialog, available by right-clicking on a track, choosing <menuchoice>Edit Track Details</menuchoice> and going to the <menuchoice>Summary</menuchoice> tab.

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

:'''Amarok''', of course, supports a 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. 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 several Plasmoids available for your Desktop, which will let you display information provided by '''Amarok''' as well as control '''Amarok'''.

===== 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 and opening it with '''Amarok'''; using the menu <menuchoice>Playlist -> Add stream</menuchoice>; among others.

:Once the stream is loaded, you can save it by clicking on {{Icon|document-save}} in the '''Playlist''' pane, and giving it a meaningful name. The Stream will then be added to the '''Saved Playlists''' view for later reference.

===== Where do I find the settings for Amarok? =====

==== Troubleshooting ====

===== How can I obtain a backtrace? =====

:If '''Amarok''' has crashed and you want to report it, visit the [http://community.kde.org/Amarok/Development/DebuggingHowTo Debugging HowTo]. The bug report must be made in [http://bugs.kde.org bugs.kde.org] after verifying if it has not 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:
{{Input|1=$ gdb -p `pidof amarok`

(gdb) thread apply full bt all}}

:Then just post the backtrace to [http://paste.kde.org/ PasteBin], as described in the [http://community.kde.org/Amarok/Development/DebuggingHowTo 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. The same happens if you have a great number of tracks in the playlist (over 300 and more).

: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? =====

:See the [http://community.kde.org/Amarok/Development/Development_HowTo Amarok Development build] instruction page. 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 KDE Multimedia? =====

:Packages in the KDE Software Compilation proper have a release schedule that doesn't fit with '''Amarok's''' development pace, and since none of the other KDE applications depend on '''Amarok''' there is no need to follow this release schedule.

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

: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:amarok@kde.org amarok@kde.org]. 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 [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. {{Smiley}}

===== 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'''. {{Smiley}}

{{Prevnext2
| prevpage=Special:myLanguage/Amarok/Manual/Various/TroubleshootingAndCommonProblems | nextpage=Special:myLanguage/Amarok/Manual/References
| prevtext=Troubleshooting and Common Problems | nexttext=References
| index=Special:myLanguage/Amarok/Manual | indextext=Back to Menu
}}

[[Category:Amarok2.8]]
[[Category:Multimedia]]
[[Category:Tutorials]]