Template:Search - KDE UserBase Wiki

Warning

This template does not work currently due to a bug in DynamicPageList3. Avoid using it for the moment

Find pages containing a string: {{Search|string}} finds all pages containing the string. Searches are case sensitive. In order to find both xyz and Xyz use a regular expression: {{Search|[Xx]yz}}.

Regular expressions use a perl like syntax. Special characters like '[', '[','(' and ')' need to be escaped.

No wiki expansion takes place before passing arguments to the template.

Warning

Due to the limitations of the underlying database queries, the search is split in five parts, each searching less that 500 pages. To check that this limit is not exceeded, the number of pages in each search is also printed. Should one of the page counts exceed 500, some pages will have been ignored. The template then needs to be modified!

Example: {{Search|1=Learn more}} gives

There are 268 pages beginning with A-J

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>

- What distribution do you use (and what version?) e.g. Kubuntu 18.04</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>

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

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.

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>

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:

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:

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.

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

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.

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 controls Collections and Internet Services.

Collections

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

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:

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

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

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.

</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. When hovering over the options with the mouse pointer, a tooltip will show to explain the individual settings.

General options:

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

Collection options:

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:

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:

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

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

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

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

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

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

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

Collections

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

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:

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:

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

Last.fm configuration

Magnatune Store configuration

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

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

Generic scripts

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

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

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.

</translate>

There are 329 pages beginning with KA-KZ

Obsolete Page

This page is no longer relevant — it will be archived.

[[Image:<translate> KWin_Plasma_5_16.png</translate>|thumb|center|356px|

<translate> KWin running a Plasma 5.16 desktop</translate>]]

The reliable and flexible window manager for KDE Plasma Desktops, now with effects!</translate>

</translate><translate>

Feature Overview

Stable and reliable
Compositing, 3D effects
Easy configuration
Improved efficiency

KWin (pronounced "kay-win") is the window manager for the KDE Plasma Desktop. It gives you complete control over your windows, making sure they're not in the way but aid you in your task. It paints the window decoration, the bar on top of every window with (configurable) buttons like close, maximize and minimize. It also handles placing of windows and switching between them.

KWin supports compositing, which means using 3D effects for handling your windows. This can make window management smoother, easier, more efficient and more natural. It’s hardware requirements are very modest and pretty much every reasonably modern system since 2002 supports it.

Practical Features

Click with your right mouse button on a window decoration or use System Settings to access the new and easier configuration of KWin. Here you can enable effects to more efficiently manage your windows. You can for example use the Present Windows as the effect for window switching. Instead of showing you icons or very small previews of your applications, it arranges them in a grid so you can quickly choose the right one. Just use the Alt-Tab keysequence and keep the Alt key pressed. You can now use tab to switch through the windows or just activate the right one using the mouse. Hitting Alt-Tab keys quickly will show you the next window in the queue, just like it used to.

If your X server already supports compositing, switching it on is as easy as opening System Settings, opening the Worskpace Appearance and Behaviour module, choosing Desktop Effects and enabling the checkbox Enable desktop effects at startup. More advanced compositing settings (such as Use VSync, Scale method, Compositing type) are available through the Advanced dialog. Customising the behaviour of the KWin effects means opening the All effects tab, and choosing the plugins you want to use. Please note that only a subset of the plugins works with XRender-based compositing. For the full experience, you need to use OpenGL mode.

Employing motion physics, KWin provides your windows with a more natural feel. New desktop effects like the Cube desktop switcher and Magic Lamp minimize animation have been added. Improvements in the existing effects make window management smoother than ever. KWin has seen many performance improvements to enable these effects even on low-end hardware. Elaborate checks have been build in to ensure users with low-end hardware are not presented with an unusable setup. KWin detects the capabilities of the hardware and if needed gracefully scales its effects down. You can take control and disable these checks or change settings like the global animation speed to fine-tune your experience. When your computer is under heavy load, KWin will automatically disable the compositing temporarily to keep things running smoothly. It will notify you if it does so, and you can re-enable compositing by pressing Shift+Alt+F12. Finally, support for multiple screen handling has been improved in KWin using the new Kephal library. You can move maximized windows between Xinerama screens and the addition of external screens is handled correctly.

More information about what was introduced in KDE SC 4.9 can be found at the following link:

kwin improvements

Tutorials

You want an application to launch in a specific size and position every time

Sometimes the screen position of an application is vital to your comfort, so use the flexibility of KWin to make sure it's always where you want it.

Position the window where you want it to open, then right-click on the title-bar, choosing Advanced -> Special Window Settings. This will open a settings window, with appropriate entries already made. All you need to do now is select the Size & Position tab and check Position and Size. OK - you are finished!

Use the WMIface utility. -->

Customise the position of titlebar buttons

Take a look at System Settings -> Application Style -> Window Decorations -> Buttons tab. The options open to you may depend on your distribution or theme, and it's clear that there is more to come.

To simply move things around you work with the specimen titlebar. Drag icons there to where you want to see them.

You may find that you have other icons available to you. A circle indicates that the button will set that window on all desktops. Another icon that you may find useful is Shade - a toggle between rolled up (titlebar only visible) and normal view. These icons are added by dragging from the text description window onto the speciman title bar - just position them as you want to use them.

If you prefer a Classic, KDE3-style Desktop

Change to traditional desktop

Right-click on your desktop - select Desktop Settings (or Appearance Settings, in some distros). Change the Layout: from Desktop to Folder View. The whole desktop is now a folderview, and another right-click on the desktop will allow you to select FolderView Settings. Set the folderview to the directory you want to use as your desktop.

Open applications directly into a different desktop

Use commands like

kstart5 --desktop 4 kate

</translate><translate>

Using with small screens (eg Netbooks)

Make the window decorations smaller

System Settings -> Application Style -> Window Decorations tab. Two good options there:

Using the default style (Breeze), select Configure Decoration and set Button size to Tiny or Small.
Using an other style, with smaller windows decorations.

Both routes will give you slim and functional window titles and borders.

Change the base fonts

On many netbooks the screen is very clear, so that reading fonts much smaller than you expect is feasible. On Acer Aspire One I find that 8 point is a good base settings.

Experimentation with about:config did not bring satisfactory results. Do this instead. Download and install gtk-chtheme from this website. Using that tool you can either set a specific font size, or better still, tell it to use your KDE desktop settings. This will work with Firefox as well as any gtk applications that you use. -->

KMail's Aggregation options take up too much space

See this FAQ to change it.

KMail's Folder-List Tooltips hide too many folder names

See this FAQ to change their behaviour

Gallery

The Gallery holds many screenshots of past and present desktops and effects.

Troubleshoot Graphics Problems

Curing graphics problems depends on knowing the correct drivers for your graphics card. Learn more about this on the Desktop Effects Performance page.

Defining Window Rules

There is a tutorial on defining your own rules for the behaviour of specific windows on the KWin Rules pages.

More Information

</translate>

There are 289 pages beginning with Ka-Kz but not Kd

There are 204 pages beginning with Kd

There are 459 pages beginning with L-Z

<translate> The home for KDE users and enthusiasts.</translate>

Note

Userbase.kde.org is the home for KDE users and enthusiasts. It provides information for end users on how to use KDE applications. KDE operates three wikis, listed at wiki.kde.org

</translate>

==== <translate> An introduction to KDE</translate> ====

<translate> Learn more about the KDE community and its software and find information to help you get started. Also, discover what UserBase is and how it can help you.</translate>

=== <translate> Tutorials</translate> ===

<translate> How-Tos, Tips & Tricks that can help make your KDE software experience more enjoyable and productive.</translate>

===<translate> Getting Help</translate>===

<translate> Can't find your answer on UserBase? Here are some other places like forums where you can get help.</translate>

===<translate> Applications</translate>===

<translate> Discover the wide variety of applications from the KDE Community, and find out what program suits your needs and preferences.</translate>

===<translate> Websites</translate>===

<translate> Other sites from the KDE community.</translate>

<translate> If you are willing to contribute, please read Tasks and Tools before starting. If you already contribute, check out Stats to see the top 10 contributors for the week, the most popular pages and most discussed pages.</translate>

</translate>

Obsolete Page

This page is no longer relevant — it will be archived.

The fast, simple WebKit-based KDE browser

</translate>

Introduction

Based initially on qtwebkit (and currently on kdewebkit), rekonq is a lightweight browser designed to use the WebKit rendering engine in combination with various KDE technologies, allowing it to integrate seamlessly into the KDE desktop. The name is a throwback to the venerable khtml-based Konqueror which is currently the default KDE web browser.

rekonq has already replaced Konqueror as the default browser in Chakra and Kubuntu, with more distributions expressing similar intent for their future releases. The current stable release version is rekonq 0.7.0.

Interface

rekonq 0.5.0 main toolbar

By default, the rekonq window uses only one toolbar. This main toolbar consists of four navigation buttons (back, forward, home, reload/stop), the URL bar and two menu/buttons, one for bookmarks and one for the settings. This minimalist approach to the main toolbar marks the most significant user-interface departure from the traditional multi-toolbar paradigm followed by most other browsers like Konqueror.

Further, the main toolbar offers only limited customization - orientation (locked at the top of the window, by default), icon size (medium, by default) and icon labels (not shown, by default). This helps keep the rekonq UI simple and puts the focus on the webpage on display.

Version 0.5.0 introduces the tech preview of a vastly improved URL bar that offers access to search engines from the drop down completion list itself. The completion list is also populated by matching items from your history and bookmarks.

When started, rekonq displays the New Tab page, much of which is taken by a set of preview thumbnails of favorite webpages. These thumbnails offer a speedy way for the user to access their most frequently used webpages. There is also a pane at the top of this page allows the user to switch to previews of recently closed tabs and lists of bookmarked webpages, download and browsing histories.

Further configuration options activate several other UI elements hidden by default. These include a toolbar for bookmarks, a panel (a panel, being a mini-window that can be resized, detached or re-docked in the main window) each for bookmarks and history and a web inspector panel (handy for web development).

Features

Under its minimalist appearance, rekonq packs a full set of powerful features. Some of them are described below:

KDE integration

rekonq is designed with the aim of being a KDE browser. And it shows;

Appearance

It obeys your themes, fonts, window decoration, menu highlighting, and many personalization options you set for your desktop.

Applications

rekonq 0.5.0 opens a pdf file in a Okular **kpart**

rekonq plays well with other applications in the KDE family. rekonq will always use your chosen default applications to handle file types. PDF files, for example will open in an embedded Okular kpart within rekonq itself. Media files will open in Dragon Player (or any other designated default application for that filetype).

rekonq 0.5.0 shares bookmarks etc. with Konqueror

Bookmarks, web shortcuts (more on these later), cookies and authentication information are shared with Konqueror. You will see the same set of bookmarks from either application and you can log onto a website in Konqueror and carry on seamlessly if you decide to switch to rekonq. Your passwords are stored securely in KWallet and can be used from either Konqueror or rekonq.

Your downloads can be optionally handled by KGet. Feeds from websites can be saved to Akregator (or Google Reader).

rekonq 0.5.0 + kget

Services

KIO support

rekonq supports KIO services, including cookies, cache, proxies and network settings. KIO-slaves like file:/, ftp:/, man:/, help:/, info:/ etc will work in rekonq, too.

Dialogs

In addition to all this, rekonq uses KDE's own file dialog for opening/saving documents. This means, you have access to the Places sidebar from Dolphin while you open or save documents.

Thus, rekonq looks, feels and behaves like a part of your KDE desktop.

WebKit engine

rekonq uses the open source WebKit rendering engine which incidentally began life as a branch of the khtml/kjs libraries from the KDE project. WebKit is fast, powerful and used by many other popular browsers today including Google's Chrome/chromium, Apple's Safari and others.

Auto-load/click-to-load plugins

rekonq 0.5.0 demonstrating the click-to-load-plugins feature on youtube.com

One of the benefits of using the WebKit engine, is that plugins can be disabled from automatically loading. This comes in handy to surf websites fast, without being bogged down by flash plugins. In the so-called Click-to-load mode, you will instead see a button that you can click on to activate the plugin.

Adblock support

rekonq 0.5.0 blocking images on kde-apps.org

rekonq comes with an automatic subscription to the Easylist filter, which is updated every week. Additionally, you can set up manual filters to block loading of elements from webpages that match your criteria. You can even download and import additional published filterlists or export your list for backup.

If you want to import your Manual Filters e.g. from Konqueror just copy your list into this file: /home/username/.kde4/share/apps/rekonq/adblockrules_local

Web shortcuts support

rekonq allows you to pick from an extensive list of web shortcuts - these are keywords that allow you to search the web quickly. For instance, entering

gg:KDE

in the location bar will search Google for "KDE", while

wp:KDE

will search Wikipedia for "KDE". There are dozens of these defined by default. You can edit these or even define custom shortcuts to search on your favorite websites. See Web Shortcuts for details.

Privacy and security features

rekonq allows users to browse the web without retaining information about the visited pages in your history. Note that this feature does not necessarily make you anonymous on the Internet - it only prevents fresh information from being recorded on your computer. You can also delete your history, cookies and other private data anytime straight from the configuration menu button.

rekonq 0.5.0 URL bar showing the SSL info icon

When viewing webpages over a secure connection, you can also view SSL information straight from the URLbar by clicking on the yellow lock icon.

Advanced tab handling

rekonq 0.5.0 showing a preview of a tab on hover

rekonq allows you to rearrange your tabs on the fly. Just drag a tab to the left or to the right and the other tabs will move out of your way. You can also hover over a tab to see a live preview of the webpage being displayed there.

A context menu (right-click menu) gives access to more tab-related functions such as the ability to detach, clone, reload the tab.

Session restore feature

If rekonq crashes, it will automatically attempt to restore your session, complete with all the tabs the next time you start it. If for some reason, the browser continues to crash upon restoring the session, rekonq will automatically start with a fresh session the second time.

Full screen mode

rekonq supports full-screening the webpage straight from the configuration menu button or through a keyboard shortcut (Ctrl+Shift+F, by default). In the full screen view, the main toolbar will auto-hide and the webpage will be displayed over your entire screen.

Zoom slider

rekonq has a slider to adjust the zoom right from the configuration menu with a handy button to restore the zoom back to default. Of course, you can still use keyboard (Ctrl+ +/-) or mouse (Ctrl + mouse scroll up/down) shortcuts just the same.

Learn more about rekonq from our FAQs, Tips and Tricks page </translate>