Template:SearchTest

    From KDE UserBase Wiki
    {{#dpl:
      |namespace = 
      |nottitleregexp = .*/[a-z][a-z].?$¦.*/[a-z][a-z]-..$¦.*[ _][(][a-z][a-z][)]$
      |titleregexp = ^[A-J]
      |include = *
      |includematchparsed = @{{{1}}}@
      |includemaxlength = 0
      |format = ,\n* [[%PAGE%{{!}}%TITLE%]],,
    | resultsheader = There are %TOTALPAGES% pages beginning with A-J\n
    }}
    

    called with {{SearchTest|1 = Learn more}} "finds" all English pages whoes titles begin by the letters A to J, regardless of whether they contain the string searched for or not.


    Warning

    This template is only meant for testing!


    There are 261 pages beginning with A-J

    Page is outdated

    This page is outdated: Please help us to cleanup parts that are no longer true and add missing information


    <translate>

    Using IRC to get help

    Here are a few tips on asking questions, especially in #kde on Libera Chat, in a way that is more likely to get answers:

    • Don't ask to ask, just ask: the irc.libera.chat channel #kde is a user support channel, so we expect your questions - go right ahead .
    • Be ready with as much relevant details about your system as you can find: Questions you are likely to be asked are:</translate>

    <translate>

      • What distribution do you use (and what version?) e.g. Kubuntu 18.04</translate>

    <translate>

      • what version of Plasma you are running — if you don't know, open Konsole and type plasmashell --version and look at the version number given there</translate>

    <translate>

      • how you installed it — mostly likely from your distribution repositories.

    You probably won't need to give all of this information straight away, but if you know how to find it quickly it often helps

    • Try to do some troubleshooting yourself before asking: Google is your friend (entering error messages into Google often finds something useful). You should also take a look at Troubleshooting KDE Problems - the advice there is probably what you'll be told in #kde anyway, so try it first
    • Also, try to make sure that the problem you're having is a problem with KDE software and not some other component of your system (for example, a problem with X or with ALSA). If possible, try an alternative, non-KDE application to see whether the problem also occurs there. Of course, if you're not sure, please ask.
    • Use the Forum. Try asking a question on the forum. If the discussion brings up interesting information you might add it to UserBase, so that it can help others.
    • Be prepared to wait! Often on IRC, someone will notice your question a little while after you ask it, so wait around for a while after you ask. There's nothing more annoying than typing out a long answer for someone, only to realise that they left 3 minutes after asking their question! In some cases there could be hours between your question being asked and someone who knows the answer coming on-line (remember that KDE users are all over the world) so sometimes you just have to ask again at a different time of day.
    • If you don't get an answer on #kde, you can also try the channel for your distribution (eg, #suse, #kde-freebsd, etc), or an appropriate mailing list: see lists.kde.org or forum.
    • Above all, be patient and polite. Remember that the people who help are all volunteers, and could be spending their time doing other things than helping.

    If your problem is with sound, you might want to first read Sound Problems.

    If your question relates to development, please see KDE TechBase's contribute page

    Because KDE is so actively developed, changes arrive very frequently, so don't be surprised if you can't find any written information. Ask in IRC, the Forum or a mailing list, and when you have an answer, register an account on UserBase and add the information to the relevant page. At the same time as learning about your system you will be helping others do the same

    The Forums

    Another great place to get help is the KDE Community Forums. It is always a good idea to search the forums first. Maybe your question has already been answered. If not, you can start a thread in the Help category. Don't expect an immediate answer, but remember to come back regularly to participate in the discussion as it gets going. Remember that the forums are run by users like yourself.

    The forums have an extensive search feature: prior to posting try finding if your question has already been answered, or there are hints that might help you solve your issue. If there is no satisfactory solution for your problem, make a new post. To search, click on the magnifying glass in the upper right of any forum page, then enter your search query. For extended searches, click on the hamburger menu on the right of the search dialog.

    If your question has been properly answered, consider marking a topic as "solved". It is a very little step, but quite helpful for other users and staff, because it tells them that there are no more issues.

    Most distributions have forums of their own; these can also be valuable. The web pages of your distribution should provide links to its forums.

    Operating-System-Specific Questions

    For questions relating to the desktop use of Plasma with a particular operating system (OS), you can try the above methods, but unless the question directly involves KDE software or KDE/GNU/Linux you are unlikely to find the answer. If your question does not directly involve KDE, please do not post the question on the "normal" KDE mailing lists. An example of questions that do not directly involve KDE is "my sound card does not work". In that case, please direct your questions at sites devoted to helping users of that system. For example, for GNU/Linux questions you may try looking at www.linuxnewbie.org or www.linuxnewbie.com, or the kde-linux mailing list mentioned above.

    If you are not using GNU/Linux, you might want to try the kde-nonlinux (subscribe) mailing list. Also particularly useful are searches on your favorite search engine, such as Google, and searches on the Usenet archives.

    In addition, many OS distributors have their own mailing lists which can address distribution-specific issues. You can find out more about these mailing lists at your distribution's website or find them through your browser search engine.

    If you are searching for packages you may consider checking the ftp servers for your distribution, including the "contrib" sections, as well as indexing servers such as rpmfind.net. Wherever possible, install the package that your distro offers directly through its package manager.

    </translate><translate>

    Reporting KDE Bugs

    Reporting bugs is a small but valuable contribution to KDE, and there's a website where you can report any bug or feature request you have about KDE: bugs.kde.org. The only requirement on your side is basic knowledge of English. With that, and following some additional guidelines, you'll be able to report helpful bug reports and thus help the whole KDE community and yourself.

    The first thing you need is to open an account in the website. You can start here. Once you have a validated account, you can report.

    There are usually two different situations to report a bug:

    • You notice something which is not working properly or not working at all, a bad design, a missed functionality... If this is your case, open the application Help -> Report Bug... menu. You will then be guided to bugs.kde.org. Some information will be automatically picked up, like the application version number.
    • Your program disappears and another window appears named "The KDE crash Handler". Don't get scared! You will be guided to efficiently report this crash. The link in the dialog "Learn more about bug reporting" will explain you the process. If you choose to report the problem, click on Report Bug and an assistant will guide you through the steps. The requisite to report a crash is to have your distribution debug packages installed in order to provide a valid backtrace.

    And these are a few tips on how to write good bug reports:

    • Write it in English. You can switch every KDE application language through Help -> Switch Application Language..., so go there and choose American English as the primary language. Then restart the application. That can help you in explaining what happens.
    • Be specific. One bug per report only! Do not mix different problems in the same report.
    • Be clear. Explain the steps that lead to the bug so that we can reproduce them easily.
    • Include screenshots: a picture is worth many words so attach a screenshot to the bug report. You can use KSnapshot to take screenshots. Also, do not link to an external web link which can expire, use the Attachments link at the bottom of the bug report.
    • Include the backtrace within the bug report as a comment, it makes it easier to find duplicates for us (do not attach the backtrace as a text file).
    • Clearly separate facts from speculation: only describe what happens. For a design problem, include a mock-up if possible.

    If you are testing trunk or the beta, if you kept your precedent settings, sometimes you will want to check with a new user.

    Also notice that Forums have a section about Beta Releases.

    A good guide to bug reporting can be found here.</translate>


    <translate> How to open a console

    Typically when reporting a problem in IRC or on a mailing list, your helpers will ask you to open a console. A console is a text-based window that you can use to give commands for your computer to execute. You can open a console by typing Alt + Space. An input box called Krunner opens. Type the following to open a console:</translate>

    konsole

    <translate> If this does not work, you may not have it installed. In this case, type Alt + F2 and input:</translate>

    xterm


    <translate>

    Back to Getting_Help</translate>

    <translate> </translate>

    <translate>

    The Music Collection

    The Media Sources pane

    The Media Sources pane is the place where you browse and display your complete collection of music. This includes the tracks on your local hard disk, as well as those on any external devices or media connected to your computer, such as audio CD, USB devices, media players, network disks or Internet sources.

    </translate><translate>

    Setting up a collection

    Do you have music tracks in mp3, Ogg or FLAC format on your computer? Begin by telling Amarok where to find those files, so it can create your collection. In the top-level menu: Settings -> Configure Amarok -> Local Collection.

    Configure Collection Dialog, as of version 2.8

    A tree-view of your home directory is shown above. Click the check box where your music is stored; usually home -> Music. Then choose Fully Rescan Entire Collection. This will take some time, so do not be alarmed if Amarok seems slow for a while. Once the scan is complete, it is best to quit Amarok using the top-level Amarok menu, or Ctrl + Q, and then restart it. Your newly-added music should show up under the Local Collection section.

    More about configuring your collection here.

    Tip

    The set of multimedia formats recognized by Amarok is not restricted to those mentioned above; is controlled by the Phonon back end.


    </translate><translate>

    Adding Media Devices to the Collection

    Underneath the search bar near the top of the Media Sources pane you see the different devices and/or content categories within the Content Browser. If you insert an Audio CD in the CD drive it will appear in the Media Sources pane, along with media players, thumb drives, and other USB devices. After an external device has been mounted, it will show automatically within the Media Sources pane.

    Below is a screenshot showing three connected sources with music: Audio CD, mp3 player, and the Local Collection.

    </translate><translate>

    Ripping a CD into the collection

    If you don't have any music files on your computer, it's easy to rip them (copy the tracks from your CDs to your collection). Just pop in a CD, and right-click on the banner of the CD device in the Content Browser to play, or copy to your collection, which will rip and tag your tracks (see image below). If you copy music from an audio CD to your Local Collection, the message bar at the bottom of the Amarok window will indicate that it is busy copying. The ripping may take several minutes. Once the rip is complete, the message in the message bar disappears and the music appears in the content browser of your Local Collection. If the ripped music does not appear in your Media Sources pane it's best to quit Amarok from the Amarok top-level menu, or Ctrl + Q, and then restart it. Now you should see it in your collection. The screenshot below shows how you move tracks from your audio CD, iPod or other device to your collection, using the context (right-click) menu.



    In the above context menu, you can also see the choice to Edit Track Details. Use this option if you have a track that needs a tag edited. This becomes important when you rip music to .WAV format, losing some of the tags. If quite a bit of your collection needs tagging, consider dedicated tagging software, such as

    Correct tagging is important to help Amarok show your tracks in the appropriate albums and proper sort order. Learn more about ripping and tagging.

    </translate><translate>

    Accessing other media sources

    You might have wondered why the Media Sources pane is not called the 'Collections' pane. Amarok gives you access to much more music than just your collection -- Internet shops, audio books, podcasts, music files stored outside your collection, and previously stored playlists. The Amarok breadcrumb navigation is the key to all of this. The starting icon for the breadcrumb navigation is the home folder icon at the extreme top left of the Media Sources pane. This icon expands and contracts as you browse through the Media Sources pane, allowing you to easily navigate your collection by clicking your desired folder in the breadcrumb bar.


    If you click the Amarok home folder you see the Media Sources pane on the left below, containing icons to available resources. If you click Files (left image below, second item from the bottom), you will see something similar to the image on the right, below. Notice how the breadcrumb bar expands and how the content of the selected folder is shown in the Media Sources pane (right image below). Clicking the > symbols among the breadcrumbs allows you to view the folders available at that level of the folder structure. The Amarok file browser gives you access to your entire file system, even outside your Local Collection.

    Media Sources pane Files icon clicked


    The functions of the icons in the Amarok Home folder (left above) are:

    Icon Name Action
    Local Music Your Amarok collection
    Internet Internet shops such as Magnatune, Jamendo and Last.fm. First configure your internet resources in: Settings -> Configure Amarok -> Internet Services
    Playlists Saved playlists -- see also Playlists. Also playlists on media devices
    Files Your file system
    Podcasts Access to Podcasts via RSS feed

    Clicking Local Music in the root of Media Sources (image above) or in the breadcrumb bar returns you to your collection, showing you a list of all the available resources, artists, albums and tracks that you have previously defined as part of your collection. The breadcrumb bar indicates that you are viewing Local Music.

    </translate><translate>

    Streams and Podcasts

    There are two ways to listen to streams.

    • If you have a favorite station, get the stream URL and add it: Playlist -> Add Stream. If you then save your playlist, later you can find it again in Playlists, as a Saved Playlist.
    • Browse through the scripts available in our Script Manager, Tools -> Script Manager up to Amarok 2.4.0, after 2.4.1 Settings -> Configure Amarok -> Scripts. There are some excellent collections available, which will show up in the Internet section of your Media pane.

    Podcasts have their own section in the Media pane, above. If you have an RSS or Atom feed URL, click the and add it there. If you have an OPML file to import, that choice is available also. Use the context (right-click) menus to Add to playlist, Configure, Remove Subscription, Update Channel, or mark an episode as New. If you are interested in browsing through a large collection of podcasts, check out the Podcast Directory available through the Script Manager, referred to above.

    More about configuring Amaroks Internet Services here.

    </translate><translate>

    Using the Content Browser

    The hard disk of your computer, audio CDs, external devices and the Internet are the basic resources for your collection. After your collection has been set up, it is likely that your collection will hold a large number of albums and tracks, much more than can be shown on a single window.

    How to change the display of your collection, below:

    </translate><translate>

    Hiding or expanding information

    The area of the Media Sources pane below the search bar is called the Content Browser. Three media sources are indicated in the image of a Content Browser below: CD, Local Collection and a Media Player:


    Clicking the banner for a device (the blue bar for the Sansa above) shows or hides the content of that device. The direction of the arrow on the right indicates whether the contents for that device is hidden or shown. The content on a particular device can, in turn, be hidden or shown using the same principle, clicking on the appropriate artist or album. An arrow pointing down on the left of an artist or an album indicates that the contents has been expanded. An arrow pointing right indicates that more content for that category is available but currently hidden. In the image above, the information for Mike Oldfield - The Songs of Distant Earth CD has been expanded, showing the individual tracks. On the other hand, the albums and tracks in the Local Collection are hidden. By clicking these arrows you also can expand or hide information.

    </translate><translate>

    Changing the order of tracks and albums

    The order in which tracks are sorted in the Content Browser can be customised by using the button at the top of the Media Sources pane:

    The Collection sort options for version 2.8


    The sort order is indicated on the top left of the Media Sources pane, just below the Search text box. The default order is Artist / Year - Album. The display order of the Content Browser can be temporarily switched between the user-defined sort order (described above) and a Merged view in which artists are listed alphabetically, no matter on which media the music is stored. To toggle the Merged view, click the icon at the top right-hand of the Media Sources pane:

    To search your collection, type your search term into the Search bar at the top of the Local Music section. Not only can you search by artist, album or track name, but any part. You might create a nice playlist by searching for winter, for instance, or merely find a track when you only remember one word of the title. You can also search by rating, playcount, even filetype. See Search in Collection for more details.

    </translate><translate>

    Deleting items from the collection

    You can delete any item from your collection by right-clicking on it and choosing the bottom item Move Tracks to Trash. A confirmation dialog will appear, preventing the accidental deletion of any tracks. More than one item can be selected with Ctrl + click.



    </translate>

    <translate>

    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

    In the screenshot above, 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 options:

    <translate> <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Show splash-screen on startup Check to enable the splash screen on Amarok startup.</translate>
    Show tray icon Check to enable the Amarok system tray icon.</translate>
    Automatically retrieve cover art Check to enable the automatic retrieval of cover art from the internet.</translate>
    Enable context applets collapse animations Check to enable animations when context applets collapse.</translate>
    Automatically scroll playlist to current track Check to make the playlist scroll so the current track is always visible.</translate>
    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.</translate>
    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.

    </translate><translate>

    Collection

    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:

    <translate> <translate> <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Fully Rescan Entire Collection Rescan your entire collection. This will not delete any statistics.</translate>
    Import Imports ratings and/or statistics from older Amarok versions, the batch scanner, or media players.</translate>
    Scan folders recursively (requires full rescan if newly checked) If selected, Amarok will read all subfolders.</translate>
    Watch folders for changes If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.</translate>
    Write statistics to file Write play-changing statistics (e.g. score, lastplayed, playcount) as tags back to the file.</translate>
    Write covers to file Write changed covers back to the file. This will replace existing embedded covers.</translate>
    Enable character set detection in ID3 tags If selected, Amarok will use Mozilla's Character Set Detector to attempt to automatically guess the character set used in ID3 tags.</translate>
    Importing Music: Transcode tracks Whether Amarok should transcode tracks when they are copied or moved to Local Collection.

    </translate><translate>

    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.

    Playback

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

    <translate> <translate> <translate>
    Option Tooltip</translate>
    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.</translate>
    Fadeout duration The length of the fadeout, in milliseconds.</translate>
    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.

    For information on codecs and playing mp3s see the mp3 information page.

    </translate><translate>

    Notifications


    ,

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

    </translate><translate>

    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.

    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.

    <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Use external MySQL Database Check to enable the use of an external database.</translate>
    Server Enter the name of the existing MySQL server.</translate>
    Port Enter the port number to access the server. Default is port 3306.</translate>
    Username Enter the username to access the database with full access privileges.</translate>
    Password Enter the password for the default user.</translate>
    Database Enter the name of the database. Default preset is amarokdb.

    You can find more information about the External Database here.

    </translate><translate>

    Plugins

    (Click to enlarge)

    Plugins configuration controls Collections and Internet Services.

    Collections

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

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

    Internet Services

    Amarok offers by default the following Internet services:

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


    Other service are available through scripts.

    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.

    </translate><translate>

    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. Before Amarok 2.4.1, called Get More Scripts.
    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.

    Amarok Script Info
    Amarok Script Info

    </translate>

    <translate>

    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:

    <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Show tray icon Check to enable the Amarok system tray icon.</translate>
    Automatically retrieve cover art Check to enable the automatic retrieval of cover art from the internet.</translate>
    Enable context applets collapse animations Check to enable animations when context applets collapse.</translate>
    Automatically scroll playlist to current track Check to make the playlist scroll so the current track is always visible.</translate>
    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.</translate>
    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.

    </translate><translate>

    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:

    <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Fully Rescan Entire Collection Rescan your entire collection. This will not delete any statistics.</translate>
    Import Imports ratings and/or statistics from older Amarok versions, the batch scanner, or media players.</translate>
    Scan folders recursively (requires full rescan if newly checked) If selected, Amarok will read all subfolders.</translate>
    Watch folders for changes If selected, the collection folders will be watched for changes. The watcher will not notice changes behind symbolic links.</translate>
    Importing Music: Transcode tracks Whether Amarok should transcode tracks when they are copied or moved to Local Collection.

    </translate><translate>

    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:

    <translate> <translate> <translate>
    Option Tooltip</translate>
    Write statistics to file Check to write play-changing statistics as tags back to the audio files.</translate>
    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.</translate>
    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:

    <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Synchronize Rating Check to synchronize ratings between collections.</translate>
    Synchronize First Played Check to synchronize first played dates between collections.</translate>
    Synchronize Last Played Check to synchronize last played dates between collections.</translate>
    Synchronize Playcount Check to synchronize playcounts between collections.</translate>
    Synchronize Labels Check to synchronize labels between collections.

    Playback

    Playback configuration dialog

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

    <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    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.</translate>
    Fadeout on pause If checked, Amarok will slowly fade the volume of the playing track on pausing the current track.</translate>
    Fadeout duration The length of the fadeout, in milliseconds.</translate>
    Inhibit automatic suspend if playing If checked, Amarok will prevent the computer from being suspended will a track is playing.</translate>
    Pause playback on suspend If checked, Amarok will pause playing of the current track when the computer is about to suspend.</translate>
    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.


    </translate><translate>

    Notifications

    Notifications configuration dialog


    ,

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

    </translate><translate>

    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.

    <translate> <translate> <translate> <translate> <translate> <translate>
    Option Tooltip</translate>
    Use external MySQL Database Check to enable the use of an external database.</translate>
    Server Enter the name of the existing MySQL server.</translate>
    Port Enter the port number to access the server. Default is port 3306.</translate>
    Username Enter the username to access the database with full access privileges.</translate>
    Password Enter the password for the default user.</translate>
    Database Enter the name of the database. Default preset is amarokdb.

    You can find more information about the External Database here.

    </translate><translate>

    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:

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

    Internet Services

    Amarok offers by default the following Internet services:

    <translate> <translate> <translate> <translate> <translate> <translate> <translate> <translate>
    Service Description Needs configuration </translate>
    Ampache Use an external music server Yes, Ampache server needed</translate>
    gpodder.net Podcast service. See also gpodder.net No</translate>
    Jamendo Listen to free music published under Creative Common licenses. See also Jamendo.com No</translate>
    Last.fm A popular internet radio service, streaming only for subscribers. See also Last.fm Yes, personal information to scrobble</translate>
    Magnatune Store Preview and buy music from a non-evil record label. See also Magnatunes.com Only for downloads</translate>
    MP3 Music Store Access the Amazon MP3 Store directly from Amarok Yes</translate>
    mp3tunes A personal mp3 locker. See also mp3tunes.com Yes</translate>
    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:

    <translate> <translate> <translate>
    Devices Description</translate>
    Local Files & USB Mass Storage Backend Local Collection folders on local and pluggable disks</translate>
    NFS Share Backend Local Collection folders on remote NFS shares (Network File System)</translate>
    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.

    </translate><translate>

    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

    </translate>