
Copyright © 2011, 2012, 2013 T.C. Hollingsworth
Copyright © 2011 Alexey Subach
Copyright © 2011 Salma Sultana
This guide provides an introduction to the KDE Software Collection and describes many common tasks that can be performed in all KDE applications.
Table of Contents
- 1. Introduction
- 2. Installing the KDE Software Collection
- 3. Finding Your Way Around
- 4. Common Tasks
- 5. Customizing KDE software
- 6. Credits and License

Welcome to KDE!
This guide will introduce you to the many features of the KDE Software Collection and describe many common tasks you can perform in all KDE applications.
For more information on KDE, visit the KDE website.

You can install the KDE Software Collection on a variety of different platforms, ranging from smartphones and tablets to computers running Microsoft® Windows®, Mac® OS, UNIX®, BSD™ or Linux®. Binary packages are available for many different platforms and distributions, or advanced users may build the source code.
Hundreds of developers worldwide have done a lot of work to make it easy to install KDE on a variety of different devices and platforms.
Nearly every Linux® distribution provides binary packages for individual KDE Software Collection applications and the KDE Plasma Workspaces as a whole.
To install an individual application, look for its name in your
distribution's package collection. To install one of the KDE Plasma Workspaces,
like KDE Plasma Desktop, look for a metapackage or package
group, typically kde-desktop
.
Note
Some core applications may be installed together with other core
applications in a combined package named after the KDE package they are
provided in. For instance, Dolphin might be found in the
kde-baseapps
package.
If you have trouble locating KDE packages for your distribution, please contact their support resources. Many distributions also have a team dedicated to packaging KDE that can provide assistance specific to KDE
The KDE on Windows Initiative provides binary packages of KDE Software Collection applications for Microsoft® Windows®. They also provide a special installer application that permits you to install individual applications or groups and all necessary dependencies easily.
For more information on the initiative and to download the installer, visit the KDE on Windows Initiative.
Individual KDE Software Collection applications can be installed through several different “ports” systems available for Mac® OS. Several different KDE applications also provide their own binary builds for Mac® OS.
For more information, visit KDE on Mac® OSX.
Most BSD™ distributions allows you to install KDE Software Collection applications and the KDE Plasma Workspaces as a whole through their “ports” system.
For more information on installing ports, see your BSD™ distribution's documentation.
Plasma Active is an exciting initiative to bring a new KDE experience to mobile devices like smartphones or tablets. Binary releases are provided for several different devices.
For more information, visit Plasma Active.
Several Linux® and BSD™ distributions offer live media. This permits you to try out the KDE Plasma Workspaces without installing anything to your system. All you have to do insert a CD or connect a USB drive and boot from it. If you like what you see, most offer an option to install it to your hard drive.
There is a list of distributions that offer the KDE Software Collection on live media on the KDE website.
For detailed information on how to compile and install KDE applications see Building and Running KDE Software From Source on KDE TechBase.
Since KDE software uses cmake you should have no trouble compiling it. Should you run into problems please report them to the KDE mailing lists.

The KDE Plasma Workspaces feature many different graphical user interface elements, commonly known as “widgets”. This guide will introduce you to their names and functions.

This is the window of the KWrite, a text editor. Click on part of the window to learn more about it.
The Window Menu
A Button to place this window on all desktops
The Titlebar
Buttons to minimize, maximize, or close the window
The Menubar
The Toolbar
A very large Text Area that acts as this program's Central Widget
A vertical Scrollbar (there is also a horizontal scrollbar below the text box)
The Statusbar

This is the another window, that of the Dolphin file manager. Click on part of the window to learn more about it.
A panel that contains a list of Places on the computer system
A Breadcrumb of the path of the displayed folder
A folder Icon
A file Icon
A highlighted Icon
A Context Menu listing actions that can be performed on a file
More Panels

This screenshot, from the System Settings Country/Region & Language panel, shows some GUI elements. Click on part of the window to learn more about it.
An Icon List (the first item is selected)
Some Tabs
An open Drop Down Box
A Button that resets the Drop Down Box to its default value
An item in the Drop Down Box that has been selected
Some more Buttons

This screenshot, from the System Settings Custom Shortcuts panel, shows some more GUI elements.
A Check Box that has been selected
A pair of Spin Boxes

This screenshot, from the System Settings Default Applications panel, shows even more GUI elements. Click on part of the window to learn more about it.
A List Box
A pair of Radio Buttons
A Text Box

Finally, this screenshot, from another tab of the System Settings Country/Region & Language panel, shows five Combo Boxes
Name | Description | Screenshot |
---|---|---|
Central Widget | The main area of the running application. This might be the document you are editing in a word processor or the board of a game like Chess. |
![]() |
Button | These can be clicked with the | mouse button to perform an action.
![]() |
Breadcrumb | Shows the path in a hierarchical system, such as a filesystem. Click on any part of the path to go up in the tree to that location. Click on the arrow to the right of part of the path to go to another child element of that path. |
![]() |
Check Box | These can be clicked to select and unselect items. They are typically used in a list of several selections. Selected items typically display a check mark, whereas unselected items will have an empty box. |
![]() |
Color Selector | This allows a color to be selected for various purposes, such as changing the color of text. For more information, see the section called “Choosing Colors” |
![]() |
Combo Box | A combination of a Drop Down Box and a Text Box. You can select an option from the list, or type in the text box. Some combo boxes may automatically complete entries for you, or open the list with a list of choices that match what you have typed. |
![]() |
Context Menu | Many user interface elements in the KDE Software Collection contain a context menu, which can be opened by clicking on something with the | mouse button. This menu contains options and actions that usually affect the user interface element that was right-clicked.
![]() |
Dialog Box | A small window that appears above a larger application window. It may contain a message, warning, or configuration panel, among others. |
![]() |
Drop Down Box | This provides a list of items, from which you may select one. |
![]() |
Icon | A graphical representation of something, such as a file or action. They typically, but not always, also contain a text description, either beneath or to the right of the icon. |
![]() |
Icon List | This provides a list of items represented by an Icon and a description. It is typically used in the left panel of configuration panels to allow selection from various types of configuration categories. |
![]() |
List Box | This is a list of items that typically allows multiple items to be selected. To select a group of contiguous items, press the Shift key and click the first and last items. To select multiple items that are not contiguous, press the Ctrl key and select the desired items. |
![]() |
Menu | A list of selections, that usually perform an action, set an option, or opens a window. These can be opened from menubars or menu buttons. |
![]() |
Menubar | These are located at the top of nearly every window and provide access to all the functions of the running application. For more information, see the section called “Common Menus”. |
![]() |
Menu Button | A special type of button that opens a menu. |
![]() |
Panel or Sidebar or Tool View | These are located on the sides or bottom of the central widget and allow you to perform many different tasks in an application. A text editor might provide a list of open documents in one, while a word processor might allow you to select a clip art image. |
![]() |
Progress Bar | A small bar that indicates that a long-running operation is being performed. The bar may indicate how much of the operation has completed, or it may simply bounce back and forth to indicate that the operation is in progress. |
![]() |
Radio Button | These are used in a list of options, and only permit one of the options in the list to be selected. |
![]() |
Scrollbar | Allows you to navigate a document. |
![]() |
Slider | Allows a numeric value to be selected by moving a small bar either horizontally or vertically across a line. |
![]() |
Spin Box | This permits a numerical value to be selected, either by using the up and down arrows to the right of the box to raise or lower the value, respectively, or by typing the value into the text box. |
![]() |
Status Bar | These are located at the bottom of many applications and display information about what the application is currently doing. For instance, a web browser might indicate the progress of loading a web page, while a word processor might display the current word count. |
![]() |
Tab | These appear at the top of an area of a window, and permit that area of the window to be changed to a variety of different selections. |
![]() |
Text Area | Allows a large amount of text to be typed in, typically multiple lines or paragraphs. Unlike a Text Box, pressing Enter will usually result in a line break. |
![]() |
Text Box | A single-line text entry that allows a small amount of text to be typed in. Typically, pressing Enter will perform the same action as clicking the button. |
![]() |
Titlebar | This is located at the top of every window. It contains the name of the application and usually information about what the application is doing, like the title of the web page being viewed in a web browser or the filename of a document open in a word processor. |
![]() |
Toolbar | These are located near the top of many applications, typically directly underneath the menu bar. They provide access to many common functions of the running application, like Save or Print. |
![]() |
Tree View | A Tree View allows you to select from a hierarchical list of options. A section, or category, of the Tree View may be unexpanded, in which case no options will appear beneath it and the arrow to the left of the title will be pointing right, toward the title. It may also be expanded, in which case several options will be listed below it, and the arrow to the left of the title will be pointing down, toward the options. To expand a portion of the tree view, click the arrow to the left of the title of the section you wish to expand, double-click on the title, or select the title using your keyboard's arrow keys and press the Enter or + key. To minimize a portion of the tree view, you may also click the arrow, double-click on the title, or press the Enter or - key. |
![]() |

Many KDE applications contain these menus. However, most applications will have more menu entries than those listed here, and others may be missing some of the entries listed here.

The menubar in Gwenview.
Some applications, like Dolphin, do not show a menubar by default. You can show it by pressing Ctrl+M. You can also use this to hide the menubar in applications that support doing so.
The menu allows you to perform operations on the currently open file and access common tasks in applications.
Common menu items include:
- → (Ctrl+N)
Creates a new file.
- →
Opens a new window.
- → (Ctrl+O)
Opens an already existing file.
- → (Ctrl+S)
Saves the file. If the file already exists it will be overwritten.
- →
Saves the file with a new filename.
- →
Saves all open files.
- → (F5)
Reloads the current file.
- →
Reloads all open files.
- → (Ctrl+P)
Prints the file.
- → (Ctrl+W)
Closes the current file.
- →
Closes all open files.
- → (Ctrl+Q)
Exits the program.
The menu allows you to modify the currently open file.
- → (Ctrl+Z)
Undo the last action you performed in the file.
- → (Ctrl+Shift+Z)
Redo the last action you performed in the file.
- → (Ctrl+X)
Removes the currently selected portion of the file, if any, and places a copy of it in the clipboard buffer.
- → (Ctrl+C)
Places a copy of the currently selected portion of the file, if any, in the clipboard buffer.
- → (Ctrl+V)
Copies the first item in the clipboard buffer to the current location in the file, if any.
- → (Ctrl+A)
Selects the entire contents of the currently open file.
- → (Ctrl+F)
Allows you to search for text in the currently open file.
- → (Ctrl+R)
Allows you to search for text in the currently open file and replace it with something else.
- → (F3)
Go to the next match of the last Find operation.
- → (Shift+F3)
Go to the previous match of the last Find operation.
The menu allows you to change the layout of the currently open file and/or the running application.
This menu has different options depending on the application you are using.
The menu allows you to perform certain actions on the currently open file.
- → (Ctrl+Shift+O)
Check for spelling errors as you type. For more information, see the section called “Automatic Spell Checking”.
- →
This initiates the spellchecking program - a program designed to help the user catch and correct any spelling errors. For more information, see the section called “Check Spelling”.
- →
This initiates the spellchecking program, but only checks the portion of the document from the current location of the cursor to the end. For more information, see the section called “Check Spelling”.
- →
This initiates the spellchecking program, but only checks the currently selected text in the document. For more information, see the section called “Check Spelling”.
- →
This allows you to change the dictionary used to check spellings. For more information, see the section called “Configuring Sonnet”.
The allows you to customize the application.
This menu typically contains the following items:
- → (Ctrl+M)
Hides and shows the menubar.
- →
Toggles the display of the statusbar on and off. Some KDE applications use statusbar at the bottom of their screen to display useful information.
- →
Allows you to show and hide the various toolbars supported by the application.
- →
Allows you to enable, disable, and modify keyboard shortcuts. For more information, see the section called “Using and Customizing Shortcuts”.
- →
Allows you to customize the contents, layout, text, and icons of toolbars. For more information, see the section called “Customizing Toolbars”.
- →
This item displays a standard KDE notifications configuration dialog, where you can change the notifications (sounds, visible messages, etc.) used by the application.
For more information how to configure notifications please read the documentation for the System Settings module Manage Notifications.
- →
Opens the configuration panel for the currently running application.
The menu gives you access to the application's documentation and other useful resources.
- → (F1)
Invokes the KDE Help system starting at the running application's handbook.
- → (Shift+F1)
Changes the mouse cursor to a combination arrow and question mark. Clicking on items within the application; will open a help window (if one exists for the particular item) explaining the item's function.
- →
Opens the Bug report dialog where you can report a bug or request a “wishlist” feature.
- →
Opens a dialog where you can edit the Primary language and Fallback language for this application.
- →
This will display version and author information for the running application.
- →
This displays the KDE Development Platform version and other basic information.

The KDE Plasma Workspaces provide keyboard shortcuts that allow you to perform many tasks without touching your mouse. If you use your keyboard frequently, using these can save you lots of time.
This list contains the most common shortcuts supported by the workspace itself and many applications available within. Every application also provides its own shortcuts, so be sure to check their manuals for a comprehensive listing.
Note
The Meta key described below is a generic name for the custom key found on many different keyboards. On keyboards designed for Microsoft® Windows®, this key is usually called the Windows key, and will have a picture of the Windows® logo. On keyboards designed for Mac® computers, this key is known as the Command key and will have a picture of the Apple® logo and/or the ⌘ symbol. On keyboards designed for UNIX® systems, this key is really known as the Meta key and is typically labeled with a diamond: ◆.
These shortcuts allow you to perform all kinds of operations with windows, whether it be opening, closing, moving, or switching between them.
These shortcuts make it easy to start and stop programs.
Shortcut | Description |
---|---|
Ctrl+Q | Quit |
Ctrl+Esc | System Activity |
Ctrl+Alt+Esc | Force Quit |
Alt+F2 | Run Command Interface |
Alt+F4 | Close |
These shortcuts allow you to navigate between windows, activities, and desktops efficiently.
Shortcut | Description |
---|---|
Ctrl+F10 | Present Windows |
Ctrl+F9 | Present Windows on current desktop |
Ctrl+F7 | Present Windows of current application only |
Ctrl+F11 | Desktop Cube |
Ctrl+F12 | Show Dashboard |
Ctrl+Alt+A | Activate Window Demanding Attention |
Alt+Tab | Walk through windows |
Alt+` | Walk through windows of the current application |
Alt+F3 | Open the Window Operations menu |
Meta+Alt+Up | Switch to Window Above |
Meta+Alt+Down | Switch to Window Below |
Meta+Alt+Left | Switch to Window to the Left |
Meta+Alt+Right | Switch to Window to the Right |
Need to get a closer look? The KDE Plasma Workspaces allow you to zoom in and out and move your entire desktop around, so you can zoom in even when the application you are using doesn't support it.
Shortcut | Description |
---|---|
Meta+= | Zoom In |
Meta+- | Zoom Out |
Meta+0 | Zoom Normal |
Meta+Up | Pan Up |
Meta+Down | Pan Down |
Meta+Left | Pan left |
Meta+Right | Pan Right |
These shortcuts allow you to switch between and manage Activities and virtual desktops.
Shortcut | Description |
---|---|
Ctrl+Q | View all your Activities |
Meta+Tab | Next Activity |
Meta+Shift+Tab | Previous Activity |
Alt+D R | Remove this Activity |
Alt+D S | Activities Settings |
Ctrl+F1 | Switch to Desktop 1 |
Ctrl+F2 | Switch to Desktop 2 |
Ctrl+F3 | Switch to Desktop 3 |
Ctrl+F4 | Switch to Desktop 4 |
These shortcuts allow you to work with the KDE Plasma Desktop and panels.
Shortcut | Description |
---|---|
Alt+D A | Add Widgets |
Alt+D R | Remove Widgets |
Alt+D L | Lock/Unlock Widgets |
Alt+D N | Next Widget |
Alt+D P | Previous Widget |
Alt+D S | Widget Settings |
Ctrl+F12 | Show Dashboard |
Alt+D T | Run the Associated Application |
Alt+Shift+F12 | Enable/Disable Desktop Effects |
Need some help? The manual for the current application is only a keypress away, and some programs even have additional help that explains the element in focus.
Shortcut | Description |
---|---|
F1 | Help |
Shift+F1 | What's This? |
Whether it's a text document, spreadsheet, or web site, these shortcuts make performing many kinds of tasks with them easy.
Shortcut | Description |
---|---|
F5 | Refresh |
Ctrl+A | Select All |
Ctrl+Z | Undo |
Ctrl+Shift+Z | Redo |
Ctrl+X | Cut |
Ctrl+C | Copy |
Ctrl+V | Paste |
Ctrl+N | New |
Ctrl+P | |
Ctrl+S | Save |
Ctrl+F | Find |
Ctrl+W | Close Document/Tab |
Whether your in an Open/Save dialog or the Dolphin file manager, these shortcuts save you time when performing operations on files. Note that some of the concepts used with files are the same as with documents, so several of the shortcuts are identical to their counterparts listed above.
Shortcut | Description |
---|---|
Ctrl+Z | Undo |
Ctrl+X | Cut |
Ctrl+C | Copy |
Ctrl+V | Paste |
Ctrl+A | Select All |
Ctrl+L | Replace Location |
Ctrl+Shift+A | Invert Selection |
Alt+Left | Back |
Alt+Right | Forward |
Alt+Up | Up (to folder that contains this one) |
Alt+Home | Home Folder |
Delete | Move to Trash |
Shift+Delete | Delete Permanently |
In addition to the standard keys, many computer keyboards and laptops nowadays have special keys or buttons to change the speaker volume, as well as the brightness of your monitor if applicable. If present, you can use these keys in the KDE Plasma Workspaces to perform those tasks.
If you do not have such keys, see the section called “Modifying Shortcuts” for information on how to assign keys for these tasks.
All done? Use these shortcuts and put your computer away!
Shortcut | Description |
---|---|
Ctrl+Alt+Insert | Switch User |
Ctrl+Alt+L | Lock Session |
Ctrl+Alt+Delete | Logout |
Ctrl+Alt+Shift+Delete | Logout without confirmation |
Ctrl+Alt+Shift+Page Down | Shut Down without confirmation |
Ctrl+Alt+Shift+Page Up | Reboot without confirmation |
The shortcuts described in Working With Windows, Leaving Your Computer, and Changing Volume and Brightness are called global shortcuts, since they work regardless of which window you have open on your screen. These can be modified in the Global Shortcuts panel of System Settings, where they are separated by KDE component.
The shortcuts described in Working with Activities and Virtual Desktops and Working with the Desktop can be modified by clicking on the Desktop Toolbox and selecting .
The shortcuts described in Working with Documents and Getting Help are set by individual programs. Most KDE programs allow you to use the common shortcut editing dialog to modify these. The shortcuts described in Working With Files can be edited in the same manner when used inside a file manager like Dolphin or Konqueror, but cannot be modified in the case of Open/Save dialogs, etc.

You're probably familiar with the scrollbar that appears on the right side (and sometimes the bottom) of documents, allowing you to move within documents. However, there are several other ways you can navigate documents, some of which are faster and easier.
Several mice have a wheel in the middle. You can move it up and down to scroll within a document. If you press the Shift key while using the mouse wheel, the document will scroll faster.
If you're using a portable computer like a laptop, you might also be able to scroll using the touchpad. Some computers allow you to scroll vertically by moving your finger up and down the rightmost side of the touchpad, and allow you to scroll horizontally by moving your finger across the bottommost side of the touchpad. Others let you scroll using two fingers: move both fingers up and down anywhere on the touchpad to scroll vertically, and move them left and right to scroll horizontally. Since this functionality emulates the mouse wheel functionality described above, you can also press the Shift key while you do this to scroll faster.
If you use the KDE Plasma Workspaces, you can control mouse wheel behavior in the Mouse module in System Settings, and you can control touchpad scrolling behavior in the Touchpad module in System Settings. Otherwise, look in the configuration area of your operating system or desktop environment.
Additionally, the scrollbar has several options in its context menu. You can access these by right-clicking anywhere on the scrollbar. The following options are available:
Scroll directly to the location represented by where you right-clicked on the scrollbar. This is the equivalent of simply clicking on that location on the scrollbar.
- (Ctrl+Home)
Go to the beginning of the document.
- (Ctrl+End)
Go to the end of the document.
- (PgUp)
Navigate to the previous page in a document that represents a printed document, or one screen up in other types of documents.
- (PgDown)
Navigate to the next page in a document that represents a printed document, or one screen down in other types of documents.
- Scroll up
Scroll up one unit (usually a line) in the document. This is the equivalent of clicking the up arrow at the top of the scrollbar.
- Scroll down
Scroll down one unit (usually a line) in the document. This is the equivalent of clicking the down arrow at the bottom of the scrollbar.
Many applications permit you to zoom. This makes the text or image you are viewing larger or smaller. You can generally find the zoom function in the View menu, and sometimes in the status bar of the application.
You can also zoom using the keyboard by pressing Ctrl++ to zoom in, or Ctrl+- to zoom out. If you can scroll with the mouse wheel or touchpad as described in the section called “Scrolling”, you can also zoom by pressing Ctrl and scrolling that way.

Many KDE applications work with files. Most applications have a menu with options that allow you to open and save files. For more information on that, see the section called “The File Menu”. However, there are lots of different operations that require selecting a file. Regardless of the method, all KDE applications generally use the same file selection window.

Opening a file in Konqueror.
- The Toolbar
This contains standard navigation tool buttons:
Causes the folder view to change to the previously displayed folder in its history. This button is disabled, if there is no previous item.
Causes the folder view to change to the next folder in its history. This button is disabled, if there is no next folder.
This will cause the folder view to change to the immediate parent of the currently displayed folder, if possible.
- (F5)
Reloads the folder view, displaying any changes that have been made since it was first loaded or last reloaded.
Displays a preview of each file inside the folder view.
- Zoom Slider
This allows you to change the size of the icon or preview shown in the folder view.
- →
- → →
Sort files listed in the folder view alphabetically by name.
- → →
Sort files listed in the folder view in order of their file size.
- → →
Sort files listed in the folder view by the date they were last modified.
- → →
Sort files listed in the folder view alphabetically by their file type.
- → →
When unchecked (the default), files in the folder view will be sorted in ascending order. (For instance, files sorted alphabetically will be sorted from A to Z, while files sorted numerically will be sorted from smallest to largest.) When checked, files in the folder will be sorted in descending order (in reverse).
- → →
When enabled (the default), folders will appear before regular files.
- →
- → (Alt+.)
Displays files or folders normally hidden by your operating system. The alternate shortcut for this action is F8.
- → (F9)
Displays the places panel which provides quick access to bookmarked locations and disks or other media.
- →
Displays an additional icon on the toolbar that provides access to “bookmarks”, a list of saved locations.
- →
Displays a preview of the currently highlighted file to the right of the folder view.
Opens a submenu to edit or add bookmarks and to add a new bookmark folder.
- Location Bar
The location bar, which can be found on top of the folder view, displays the path to the current folder. The location bar has two modes:
- Bread Crumb Mode
In the “bread crumb” mode, which is the default, each folder name in the path to the current folder is a button which can be clicked to quickly open that folder. Moreover, clicking the “>” sign to the right of a folder opens a menu which permits to quickly open a subfolder of that folder.
- Editable Mode
When in bread crumb mode, clicking in the gray area to the right of the path with the “editable” mode, in which the path can be edited using the keyboard. To switch back to bread crumb mode, click the check mark at the right of the location bar with the mouse button.
mouse button switches the location bar to theLocation bar in editable mode.
The context menu of the location bar offers action to switch between the modes and to copy and paste the path using the clipboard. Check the last option in this context menu to display either the full path starting with the root folder of the file system or to display the path starting with the current places entry.
- The Places List
This provides the standard KDE list of Places, shared with Dolphin and other file management tools.
- The Folder View
The largest part of the file selection window is the area that lists all items in the current directory. To select a file, you can double-click on it, or choose one and hit or .
You can also select multiple files at once. To select specific files, or to unselect specific files that are already selected, press and hold Ctrl, click on each file, then release Ctrl. To select a contiguous group of files, click the first file, press and hold Shift, click on the last file in the group, and release Shift.
The Folder View supports a limited set of file operations, which can be accessed by right-clicking on a file to access its context menu, or using keyboard shortcuts. The following items are available in the context menu:
Create a new file or folder.
- (Del)
Move the currently selected item to the trash.
This submenu can also be accessed from the toolbar, and is described in → .
This submenu can also be accessed from the toolbar, and is described in → .
Opens the current folder in your default file manager application.
- (Alt+Enter)
Open the Properties window that allows you to view and modify various types of metadata related to the currently selected file.
- The Preview Pane
If enabled, this displays a preview of the currently highlighted file.
- The Name Entry
When a file is selected, a name will appear in this text box. You may also manually enter a file name or path in this text box.
- The Filter Entry
When opening a file, the Filter entry allows you to enter a filter for the files displayed in the folder view. The filter uses standard globs; patterns must be separated by white space. For instance, you can enter
*.cpp *.h *.moc
to display several different common Qt™ programming files.To display all files, enter a single asterisk (
*
).The filter entry saves the last 10 filters entered between sessions. To use one, press the arrow button on the right of the entry and select the desired filter string. You can disable the filter by pressing the button to the left of the autocompletion arrow button.
When saving a file, the Filter entry will instead display a drop down box that allows you to select from all the file types the application supports. Select one to save a file in that format.
- Automatically select filename extension
When saving a file, this check box will appear. When selected (the default), the application will automatically append the default file extension for the selected file type to the end of the file name, if it does not already appear in the Name entry. The file extension that will be used is listed in parenthesis at the end of the check box label.
Saving a file in Konqueror.
- The or Button
Depending on the action being performed, an or button will be displayed. Clicking on this button will close the file selection window and perform the requested action.
- The Button
Clicking will close the file dialog without performing any action.

Sonnet is the spelling checker used by KDE applications such as Kate, KMail, and KWord. It is a GUI frontend to various free spell checkers.
To use Sonnet you need to install a spell checker like GNU Aspell, Enchant, Hspell, ISpell or Hunspell and additionally the corresponding dictionaries for the languages that you wish to use.
To check spelling, go to → .
If a word is possibly misspelled in your document, it is displayed in the top line in the dialog. Sonnet tries to appropriate word(s) for replacement. The best guess is displayed to the right of Replace with. To accept this replacement, click on .
Sonnet also allows you to select a word from the list of suggestions and replace the misspelled word with that selected word. With the help of the button, you can add more suggestions from the dictionary to the suggestions list.
Click on to keep your original spelling.
Click on to stop spellchecking and keep the changes made.
Click on to stop spellchecking and cancel the changes already made.
Click on to automatically replace the misspelled word(s) with the chosen replacement word, if they appear again in your document later.
Click on to ignore the spelling at that point and all the future occurrences of the word misspelled.
Click on to add the misspelled word to your personal dictionary.
The Personal Dictionary is a distinct dictionary from the system dictionary and the additions made by you will not be seen by others.
The drop down box Language at the bottom of this dialog allows you to switch to another dictionary temporarily.
In many applications, you can automatically check spelling as you type. To enable this feature, select → .
Potentially misspelled words will be underlined in red. To select a suggestion, right click on the word, select the submenu, and select the suggestion. You may also instruct Sonnet to ignore this spelling for this document by selecting , or you may select to save it in your personal dictionary.
To change your dictionary, go to → . A small window will appear at the bottom of the current document that will allow you to change your dictionary.
For more information on configuring Sonnet, see the Spell Checker System Settings module documentation

The Find function of many KDE Software Collection applications lets you find specific text in a document, while the Replace function allows you to replace text that is found with different text you provide.
You can find both these functions in the menu of many KDE applications. For more information on this menu, see the section called “The Edit Menu”.
The Find function searches for text in a document and selects it.

Searching for software
in
KMail's composer window.
To use Find in many applications, go to → or press Ctrl+F. Then, in the Text to find: text box, enter the text that you want to find.
If Regular expression is checked you will be able to search using regular expressions. Click on to select from and enter commonly used regular expression characters, like White Space or Start of Line. If Kate is installed, you can find more information on writing regular expressions in its documentation.
You can limit the found results by configuring these options:
- Case sensitive
Capital and lowercase characters are considered different. For example, if you search for “This”, results that contain “this” will not be returned.
- Whole words only
By default, when the application searches for text, it will return results even in the middle of other text. For instance, if you search for “is” it will stop on every word that contains that, like “this” or “history”. If you check this option, the application will only return results when the search text is a word by itself, that is, surrounded by whitespace.
- From cursor
The search will start from the location of the cursor and stop at the end of the text.
- Find backwards
By default, the application searches for the text starting at the beginning of the document, and move through it to the end. If you check this option, it will instead start at the end and work its way to the beginning.
- Selected text
Select this option to search only in the text that is currently selected, not the entire document. It is disabled when no text is selected.
The Find function only selects the first match that it finds. You can continue searching by selecting → or by pressing F3.
Applications which use the KDE text editor component show a search bar instead of the Find window. See KWrite documentation for additional information on the search bar.
The Replace function searches for text in a document and replaces it with other text. You can find it in many application at → or by pressing Ctrl+R.
The window of the Replace function is separated into 3 sections:
- Find
Here you may enter the text you wish to search for. See the section called “The Find Function” for more information on the options provided here.
- Replace
Here you may enter the text you wish to replace the found text with.
You can reuse the found text in the replacement text by selecting the Use placeholders checkbox. Placeholders, sometimes known as backreferences, are a special character sequence that will be replaced with all or part of the found text. For instance, “\0” represents the entire found string.
You may insert placeholders into the text box by clicking the button, then selecting an option from the menu like . For example, if you are searching for “message”, and you want to replace it with messages insert the placeholder and add an “s”. The replace field will then contain “\0s”.
If Kate is installed, you can learn more about placeholders in the Regular Expressions appendix of its documentation.
- Options
This contains all the same options that the Find function does, with one addition:
If the Prompt on replace option is checked a window will appear on every found word, allowing you to confirm whether you would like to replace the found text.
Applications which use the KDE text editor component show a search and replace bar instead of the Replace window. See KWrite documentation for additional information on the search and replace bar.

The font selector appears in many different KDE applications. It lets you select the font face, font style, and font size of the text that appears in your application.

Selecting a font in System Settings.
- Font
This is the leftmost selection box, and lets you choose the font face from a list of fonts on your system.
- Font style
This is the center selection box, and lets you choose the font style from the following choices:
Italic - this displays text in a cursive, or slanted fashion, and is commonly used for citations or to emphasize text.
Regular - the default. Text is displayed without any special appearance.
Bold Italic - a combination of both Bold and Italic
Bold - this displays text in a darker, thicker fashion, and is commonly used for titles of documents or to emphasize text.
- Size
This is the rightmost selection box, and lets you select the size of your text. Font size is measured in points, a standard unit of measure in typography. For more information on this, see the “Point (typography)” article on Wikipedia.
- Preview
The bottom of the font selector displays a preview of text using the font settings that are currently selected. You may change this text if you wish.

The color chooser appears in many KDE applications, whenever you need to select a color. It lets you pick from a “palette” consisting of many predefined colors or mix your own when you want a specific color.

Selecting a color in System Settings.
A palette is a set of predefined colors. You can find it on the right side of the color chooser window.
To select a color from a palette, simply click on it. The color will be displayed below the palette, along with its HTML hexadecimal code and name, if any.
To switch between them, use the drop down box above the color palette. Most palettes will display a grid consisting of the colors, except for the Named Colors, which lets you select from a list of names. Other special palettes include * Recent Colors *, which will display colors that you have recently selected, and * Custom Colors *, which will display custom colors that you have saved. For more information on setting custom colors, see the section called “Saving Custom Colors”
The color chooser also lets you mix your own colors. There are several ways to do this:
The left side of the color chooser contains a large box, and a thinner box immediately to its right. You can use the left box to select the Hue and Saturation of the desired color based on the visual guide provided in the box. The right bar adjusts the Value. Adjust these to select the desired color, which is displayed in the lower-right corner of the window.
For more information on Hue, Saturation, and Value, see the section called “Hue/Saturation/Value”
The eyedropper tool allows you to select a color from your screen. To use it, select the button to the right of the button, and then click anywhere on your screen to select that color.
The lower-left corner of the screen allows you to manually enter the coordinates of the desired color in the Hue/Saturation/Value (HSV) color space. For more information on this, see the “HSL and HSV” article on Wikipedia.
These values are also updated when selecting a color by other methods, so they always accurately represent the currently selected color.
The lower-left corner of the screen also allows you to manually enter the coordinates of the desired color in the Red/Green/Blue (RGB) color model. For more information on this, see the “RGB color model” article on Wikipedia.
These values are also updated when selecting a color by other methods, so they always accurately represent the currently selected color.
You may enter the HTML hexadecimal code representing the color in the lower-right corner of the screen. For more information on this, see the “Web colors” article on Wikipedia.
This value is also updated when selecting a color by other methods, so it always accurately represents the currently selected color.
After selecting a color, you may save it to the Custom Colors palette so you can find it later. To do so, click the button. You can then find it by selecting the * Custom Colors * palette from the drop down box in the upper-right corner of the screen. For more information on using palettes, see the section called “Using Palettes”.


The toolbar in Gwenview.
To customize an application's toolbars, go to → or right-click on a toolbar and select .
On the left side of the toolbar configuration panel, the available items that you can put in your toolbar are shown. On the right, the ones that already appear on the toolbar are shown. At the top, you can select the toolbar you wish to modify or view.
Above each side of the panel there is a Filter text box you can use to easily find items in the list.
You can add an item to your toolbar by selecting it from the left side and clicking on the right arrow button.
You can change the position of the items by moving them lower or higher in the list. To move items lower, press the down arrow button, while to move items higher press the up arrow button. You can also change items' position by dragging and dropping them.
On horizontal toolbars, the item that's on top will be the one on the left. On vertical toolbars, items are arranged as they appear in the toolbar.
You can add separator lines between items by adding a --- separator --- item to the toolbar.
You can restore your toolbar to the way it was when you installed the application by pressing the button at the bottom of the window and then confirming your decision.
You can change the appearance of toolbars by right-clicking on a toolbar to access it's context menu.
You can change the appearance of text on toolbars in the submenu of a toolbar's context menu.
You can choose from:
- only the icon for each toolbar item will appear.
- only the text label for each toolbar item will appear.
- the text label will appear to the right of each toolbar item's icon
- the text label will appear underneath each toolbar item's icon
You can also show or hide text for individual toolbar items by right-clicking on an item and checking or unchecking the item under Show Text.
You can change the size of toolbar items' icons by selecting from the toolbar's context menu.
You can choose from the following options: (each lists the icon size in pixels)
[the default value]
In order to move toolbars, you must “unlock” them. To do so, uncheck from a toolbar's context menu. To restore the lock, simply recheck this menu item.
You can change a toolbar's position from the submenu of its context menu.
You can choose from:
[the default in many applications]
You can also move a toolbar by clicking and holding onto the dotted line at the left of horizontal toolbars or the top of vertical toolbars and dragging it to your desired location.
If your application has only one toolbar, you can hide a toolbar by deselecting from either the toolbar's context menu or the menu. To restore the toolbar, select from the menu. Note that toolbars must be “unlocked” to hide them from their context menu; see the section called “Moving Toolbars” for more information.
If your application has more than one toolbar, a submenu called will appear in the context menu and menu instead of the above menu entry. From that menu you may select individual toolbars to hide and show.

Many KDE applications allow you to configure keyboard shortcuts. To open the standard keyboard shortcuts configuration panel, go to → .
In the Configure Shortcuts window, you will see a list of all the shortcuts available in the current application. You can use the search box at the top to search for the shortcut you want.

Searching for shortcuts with file
in
Dolphin.
To change a shortcut, first click on the name of a shortcut you want to change. You will see a radio group where you can choose whether to set the shortcut to its default value, or select a new shortcut for the selected action. To set a new shortcut, choose Custom and click on the button next to it. Then just type the shortcut you would like to use, and your changes will be saved.
There is a button at the bottom of the window, called . Clicking on this button will reset all your custom shortcuts to their default values.
You can also reset an individual shortcut to its default value by selecting it, and choosing the Default radio button.
To remove a shortcut, select it from the list, then click the remove icon (a black arrow with a cross) to the right of the button that allows you to select a shortcut.
Schemes are keyboard shortcuts configuration profiles, so you can create several profiles with different shortcuts and switch between these profiles easily.
Warning
This feature is under development. It is not possible to import schemes using a GUI at this time.
To see a menu allowing you to edit schemes, click on the button at the bottom of the form. The following options will appear:
- Current Scheme
Allows you to switch between your schemes.
Creates a new scheme. This opens a window that lets you select a name for your new scheme.
Deletes the current scheme.
Opens the following menu:
Sets the current scheme as the default for all new schemes.
Exports the current scheme to a file named
.applicationname
schemename
shortcuts.rcMove this file to the folder
$KDEDIR/apps/applicationname/
and the exported scheme will be available in the drop down box labelled Current Scheme
You can print out a list of shortcuts for easy reference by clicking the button at the bottom of the window.

The original idea for this guide was proposed by Chusslove Illich and brought to fruition with input from Burkhard Lück, Yuri Chornoivan, and T.C. Hollingsworth
Much of it was written by participants of Google Code-In 2011. Thanks to Google for sponsoring their excellent work!
This documentation is licensed under the terms of the GNU Free Documentation License.
This program is licensed under the terms of the GNU General Public License.