Difference between revisions of "KDE"

From ArchWiki
Jump to: navigation, search
(Adding a Global Menu to the desktop: Added warning about the deprecation of the firefox-extension-globalmenu and a possible solution)
m (Baloo: How to disable baloo_file - if anybody knows a better way feel free to replace what I wrote.)
 
(653 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
 
[[Category:KDE]]
 
[[Category:KDE]]
 +
[[ar:KDE]]
 
[[cs:KDE]]
 
[[cs:KDE]]
[[de:KDE]]
+
[[de:Plasma]]
 
[[es:KDE]]
 
[[es:KDE]]
 +
[[fa:KDE]]
 
[[fr:KDE]]
 
[[fr:KDE]]
 
[[it:KDE]]
 
[[it:KDE]]
Line 8: Line 10:
 
[[pl:KDE]]
 
[[pl:KDE]]
 
[[ru:KDE]]
 
[[ru:KDE]]
[[tr:KDE_Masaüstü_Ortamı]]
+
[[zh-hans:KDE]]
[[zh-CN:KDE]]
+
[[zh-hant:KDE]]
[[zh-TW:KDE]]
+
{{Related articles start}}
{{Article summary start}}
+
{{Related|Desktop environment}}
{{Article summary text|This article covers installation, configuration, and troubleshooting of KDE.}}
+
{{Related|Display manager}}
{{Article summary heading|Overview}}
+
{{Related|Window manager}}
{{Article summary text|{{Graphical user interface overview}}}}
+
{{Related|Qt}}
{{Article summary heading|Related}}
+
{{Related|SDDM}}
{{Article summary wiki|Plasma}}
+
{{Related|Dolphin}}
{{Article summary wiki|Qt}} - KDE uses the Qt toolkit
+
{{Related|KDE Wallet}}
{{Article summary wiki|KDM}}
+
{{Related|KDevelop}}
{{Article summary wiki|KDevelop 4}}
+
{{Related|Trinity}}
{{Article summary wiki|Uniform Look for Qt and GTK Applications}}
+
{{Related|Uniform Look for Qt and GTK Applications}}
{{Article summary end}}
+
{{Related articles end}}
  
From [http://www.kde.org/community/whatiskde/softwarecompilation.php KDE Software Compilation] and [http://www.kde.org/download/ Getting KDE Software]:
+
KDE is a software project currently comprising of a [[desktop environment]] known as Plasma, a collection of libraries and frameworks (KDE Frameworks) and several applications (KDE Applications) as well. KDE upstream has a well maintained [https://userbase.kde.org/ UserBase wiki]. Detailed information about most KDE applications can be found there.
 
 
:''The KDE Software Compilation is the set of frameworks, workspaces, and applications produced by KDE to create a beautiful, functional and free desktop computing environment for Linux and similar operating systems. It consists of a large number of individual applications and a desktop workspace as a shell to run these applications. ''
 
 
 
The KDE upstream has a well maintained [http://userbase.kde.org/ UserBase wiki]. Users can get detailed information about most KDE applications there.
 
  
 
== Installation ==
 
== Installation ==
  
KDE 4.x is '''modular'''. You can install an entire set of packages or only install your preferred KDE applications.
+
=== Plasma ===
 
 
{{Note|If you do not have [[Xorg#Installation|Xorg]] installed on your system, be sure to install it before KDE.}}
 
 
 
=== Full install ===
 
 
 
[[pacman|Install]] {{Grp|kde}} or {{Grp|kde-meta}} available in the [[official repositories]]. For differences between {{Grp|kde}} and {{Grp|kde-meta}} see the [[KDE Packages]] article.
 
 
 
=== Minimal install ===
 
 
 
If you want to have a minimal installation of the KDE SC, install:
 
* {{Grp|kdebase}}
 
 
 
=== Language pack ===
 
 
 
If you need language files, install {{ic|kde-l10n-yourlanguagehere}} (e.g. {{Pkg|kde-l10n-de}} for the German language).
 
 
 
For a full list of available languages see [https://www.archlinux.org/packages/extra/any/kde-l10n/ this link].
 
  
== Upgrading ==
+
Before installing Plasma, make sure you have a working [[Xorg]] installation on your system.
  
'''KDE 4.11''' Software Compilation is the current major [http://kde.org/announcements/ release of KDE]. Important hints for upgraders:
+
[[Install]] the {{Pkg|plasma-meta}} meta-package or the {{Grp|plasma}} group. For differences between {{Pkg|plasma-meta}} and {{Grp|plasma}} reference [[Creating packages#Meta packages and groups]]. Alternatively, for a more minimal Plasma installation, install the {{Pkg|plasma-desktop}} package.
* Always check if your mirror is '''up to date'''.
 
* '''Do not force an update using {{ic|# pacman --force}}'''. If pacman complains about conflicts please '''file a bug report'''.
 
* You can remove the meta packages and the sub packages you do not need after the update.
 
* If you do not like split packages just keep using the kde-meta packages.
 
  
== Starting KDE ==
+
To enable support for [[Wayland]] in Plasma, also install the {{Pkg|plasma-wayland-session}} package.
  
Starting KDE depends on your preferences. Basically there are two ways of starting KDE. Using '''KDM''' or '''xinitrc'''.
+
=== KDE applications ===
  
=== Using a Display Manager ===
+
To install the full set of KDE Applications, install the {{Grp|kde-applications}} group or the {{Pkg|kde-applications-meta}} meta-package. Note that this will only install applications, it will not install any version of Plasma.
''It is highly recommended to get familiar with the [[Display Manager|full article]] concerning display managers, before you make any changes.''
 
  
==== KDM (KDE Display Manager) ====
+
=== Unstable releases ===
  
''See also [[KDM]] Wiki page.''
+
See [[Official repositories#kde-unstable]]
  
[[Daemons|Enable/start]] {{ic|kdm.service}}.
+
== Starting Plasma ==
 +
{{Note|Although it is possible to launch Plasma under [[Wayland]], there are some missing features and known problems as of Plasma 5.12. See the [https://community.kde.org/Plasma/5.12_Errata#Wayland Plasma 5.12 Errata] for a list of issues and the [https://phabricator.kde.org/project/board/99/ Plasma on Wayland workboard] for the current state of development. Use [[Xorg]] for the most complete and stable experience.}}
  
=== Using xinitrc ===
+
Plasma can be started either using a [[display manager]], or from the console.
  
''The meaning and usage of '''xinitrc''' is very well described [[Xinitrc|here]].
+
=== Using a display manager ===
  
{{Pkg|kdebase-workspace}} provides startkde. Make sure it is installed then use:
+
* Select ''Plasma'' to launch a new session in [[Xorg]].
 +
* [[Install]] {{Pkg|plasma-wayland-session}} and select ''Plasma (Wayland)'' to launch a new session in [[Wayland]].
  
{{hc|~/.xinitrc|
+
{{Note|The [[NVIDIA]] proprietary driver implementation for Wayland requires EGLStreams. KDE have not implemented EGLStreams in their Wayland [https://blog.martin-graesslin.com/blog/2016/09/to-eglstream-or-not implementation]. The following workarounds are available:
exec startkde
+
*Using the [[Nouveau]] driver.
 +
*Using the (default) Xorg session.
 
}}
 
}}
  
After a reboot and/or log-in, each execution of Xorg ({{ic|startx}} or {{ic|xinit}}) will start KDE automatically.
+
=== From the console ===
  
{{Note|If you want to start Xorg at boot, please read [[Start X at Login]] article.}}
+
To start Plasma with [[xinit|xinit/startx]], append {{ic|exec startkde}} to your {{ic|.xinitrc}} file. If you want to start Xorg at login, please see [[Start X at login]]. To start a Plasma on Wayland session from a console, run {{ic|startplasmacompositor}}.
  
 
== Configuration ==
 
== Configuration ==
  
All KDE configuration is saved in the {{ic|~/.kde4}} folder. If your KDE is giving you a lot of trouble or if you ever want a fresh installation of KDE, just back this folder up and restart your X session. KDE will re-create this folder with all the default config files. If you want very fine-grained control over your KDE programs, then you may want to edit the files in this folder.
+
Most settings for KDE applications are stored in {{ic|~/.config}}. However, configuring KDE is primarily done through the '''System Settings''' application. It can be started from a terminal by executing {{ic|systemsettings5}}.
 
 
However, configuring KDE is primarily done in '''System Settings'''. There are also a few other options available for the desktop with '''Default Desktop Settings''' when you right click the desktop.
 
 
 
For other personalization options not covered below such as activities, different wallpapers on one cube, etc please refer to the [[Plasma]] wiki page.
 
  
 
=== Personalization ===
 
=== Personalization ===
 
How to set up the KDE desktop to your personal style; use different Plasma themes, window decorations and icon themes.
 
  
 
==== Plasma desktop ====
 
==== Plasma desktop ====
 
[[Plasma]] is a desktop integration technology that provides many functions from displaying the wallpaper, adding widgets to the desktop, and handling the panels or "taskbar".
 
  
 
===== Themes =====
 
===== Themes =====
  
[http://kde-look.org/index.php?xcontentmode=76 Plasma themes] can be installed through the Desktop Settings control panel. Plasma themes define how your panels and plasmoids look like. If you like to have them installed system-wide, themes can be found in both the official repositories and [https://aur.archlinux.org/packages.php?O=0&K=plasmatheme&do_Search=Go AUR].
+
[https://store.kde.org/browse/cat/104/ Plasma themes] define the look of panels and plasmoids. For easy system-wide installation, some themes are available in both the official repositories and the [https://aur.archlinux.org/packages.php?K=plasma+theme AUR].
  
===== Widgets =====
+
The easiest way to install themes is by going through the ''System Settings > Workspace Theme > Desktop Theme > Get new Themes''.
  
Plasmoids are little scripted or coded KDE apps that enhance the functionality of your desktop.  There are two kinds, plasmoid scripts and plasmoid binaries.
+
This will present a frontend for the [https://store.kde.org/ KDE-Store] that allows you to install, uninstall, or update third-party plasmoid scripts.
  
Plasmoid binaries must be installed using PKGBUILDS from [https://aur.archlinux.org/packages.php?O=0&K=plasmoid&do_Search=Go&PP=25&SO=d&SB=v AUR].  Or write your own PKGBUILD.
+
Splash and Lock screens are currently unavailable. To customize these screens, you have to modify the original theme found in {{ic|/usr/share/plasma/look-and-feel/}}.
 +
See [https://www.kubuntuforums.net/showthread.php?67599-Plasma-5-background-images&s=59832dc20e5bfc2948dbb591d8453f61 this thread] on the Kubuntu forums.
  
The easiest way to install plasmoid scripts is by right-clicking onto a panel or the desktop:
+
Note that the [[SDDM]] login screen is not part of this theme.
  
Add Widgets > Get new Widgets > Download Widgets
+
====== Qt and GTK+ Applications Appearance ======
  
This will present a nice frontend for [http://www.kde-look.org/ kde-look.org] and allows you to (un)install or update third-party plasmoid scripts with just one click.
+
{{Tip|For Qt and GTK theme consistency, see [[Uniform look for Qt and GTK applications]].}}
  
Most plasmoids are not created officially by KDE developers.  You can also try installing Mac OS X widgets, Microsoft Windows Vista/7 widgets, Google Widgets, and even SuperKaramba widgets.
+
; Qt4
  
===== Sound applet in the system tray =====
+
For Qt4 applications to have a consistent appearance, there are two options:
  
Install Kmix ({{Pkg|kdemultimedia-kmix}}) from the official repositories and start it from the application launcher. Since KDE autostarts programs from the previous session, the program need not be started manually every time one logs in.
+
Install {{Pkg|breeze-kde4}} and then pick Breeze as GUI Style in {{ic|qtconfig-qt4}}; or install {{Pkg|breeze-gtk}} and pick GTK+ as GUI Style.
  
===== Adding a Global Menu to the desktop =====
+
; GTK+
  
Install {{Pkg|appmenu-qt}} from the official repos and {{aur|appmenu-gtk}} and {{aur|appmenu-qt5}} from the AUR in order to complete the preliminaries for an always-on globalmenu (mac-style). To get firefox and libreoffice support as well, install {{aur|firefox-extension-globalmenu}} and {{aur|libreoffice-extension-menubar}} from the AUR.
+
The recommended theme for a pleasant appearance in GTK+ applications is {{Pkg|breeze-gtk}} or {{AUR|gnome-breeze-git}}, a GTK+ theme designed to mimic the appearance of Plasma's Breeze theme.
 +
Install {{Pkg|kde-gtk-config}} (part of the {{grp|plasma}} group) and select the installed GTK-theme for GTK2/GTK3-Theme in ''System Settings > Application Style > GNOME Application Style''.
  
{{Warning|{{aur|firefox-extension-globalmenu}} has been deprecated as of Firefox 25 and there is no other recommended method for getting the global menu. However, there is a patched package, namely {{aur|firefox-ubuntu}} available in the AUR which has canonical's patch for getting the globalmenu to work with the current version of Firefox (as of this writing).}}
+
In some themes, tooltips in GTK+ applications have white text on white backgrounds making it difficult to read. To change the colors in GTK2 applications, find the section for tooltips in the {{ic|.gtkrc-2.0}} file and change it. For GTK3 application two files need to be changed, {{ic|gtk.css}} and {{ic|settings.ini}}.
 +
It might also help to uncheck the option to ''Apply colors to non-Qt applications'' under ''System Settings'' > ''Colors''.
  
To actually get the globalmenu, install {{aur|kdeplasma-applets-menubar}} from the AUR. Create a plasma-panel on top of your screen and add the window menubar applet to the panel. To export the menus to your globalmenu, go to ''System Settings > Application Appearance > Style''. Now click the fine-tuning tab and use the drop-down list to select ''only export'' as your menubar style.
+
Some GTK2 programs like {{AUR|vuescan-bin}} still look hardly usable due to invisible checkboxes with the Breeze or Adwaita skin in a Plasma session. To workaround this, install and select e.g. the Numix-Frost-Light skin of the {{AUR|numix-frost-themes}} under ''System Settings'' > ''Application Style'' > ''GNOME Application Style (GTK)'' > ''Select a GTK2 Theme:''. Numix-Frost-Light looks similar to Breeze.
  
==== Window decorations ====
+
===== Widgets =====
  
[http://kde-look.org/index.php?xcontentmode=75 Window decorations] can be changed in:
+
Plasmoids are little scripted (plasmoid scripts) or coded (plasmoid binaries) KDE applications designed to enhance the functionality of your desktop.
System Settings > Workspace Appearance > Window Decorations
 
There you can also directly download and install more themes with one click and some are available on [https://aur.archlinux.org/packages.php?O=0&K=kdestyle&do_Search=Go&PP=25&SO=d&SB=v AUR].
 
  
==== Icon themes ====
+
The easiest way to install plasmoid scripts is by right-clicking onto a panel or the desktop and choosing ''Add Widgets > Get new Widgets > Download Widgets''.
 +
This will present a nice frontend for https://store.kde.org/ that allows you to install, uninstall, or update third-party plasmoid scripts with literally just one click.
  
Not many full system icons themes are available for KDE 4.  You can open up ''System Settings > Application Appearance > Icons'' and browse for new ones or install them manually. Many of them can be found on [http://www.kde-look.org/ kde-look.org].
+
Many Plasmoid binaries are available from the [https://aur.archlinux.org/packages.php?K=plasmoid AUR].
  
Official logos, icons, CD labels and other artwork for Arch Linux are provided in the {{AUR|archlinux-artwork}} package.  After installing you can find such artwork at {{ic|/usr/share/archlinux/}}.
+
===== Sound applet in the system tray =====
  
==== Fonts ====
+
[[Install]] {{Pkg|plasma-pa}} or {{Pkg|kmix}} (start Kmix from the Application Launcher). {{Pkg|plasma-pa}} is now installed by default with {{Grp|plasma}}, no further configuration needed.
  
===== Fonts in KDE look poor =====
+
{{Note|1=To adjust the [https://bugs.kde.org/show_bug.cgi?id=313579#c28 step size of volume increments/decrements], add e.g. {{ic|1=VolumePercentageStep=1}} in the {{ic|[Global]}} section of {{ic|~/.config/kmixrc}}.}}
  
Try installing the {{Pkg|ttf-dejavu}} and {{Pkg|ttf-liberation}} packages.
+
===== Disable panel shadow =====
  
After the installation, be sure to log out and back in. You should not have to modify anything in ''System Settings > Fonts''.
+
As the Plasma panel is on top of other windows, its shadow is drawn over them. [https://bbs.archlinux.org/viewtopic.php?pid=1228394#p1228394] To disable this behaviour without impacting other shadows, [[install]] {{Pkg|xorg-xprop}} and run:
  
If you have personally set up how your [[Fonts]] render, be aware that System Settings may alter their appearance. When you go ''System Settings > Appearance > Fonts'', System Settings will likely alter your font configuration file ({{ic|fonts.conf}}).
+
  $ xprop -remove _KDE_NET_WM_SHADOW
  
There is no way to prevent this but if you set the values to match your {{ic|fonts.conf}} file the expected font rendering will return (it will require you to restart your application or in a few cases for you to have to restart your desktop).
+
then select the panel with the plus-sized cursor. [https://forum.kde.org/viewtopic.php?f=285&t=121592] For automation, install {{Pkg|xorg-xwininfo}} and create the following script:
  
Note too that Gnomes' Font Preferences will also do this if you use both desktop environments.
+
{{hc|/usr/local/bin/kde-no-shadow|<nowiki>
 +
#!/bin/bash
 +
for WID in $(xwininfo -root -tree | sed '/"Plasma": ("plasmashell" "plasmashell")/!d; s/^  *\([^ ]*\) .*/\1/g'); do
 +
  xprop -id $WID -remove _KDE_NET_WM_SHADOW
 +
done
 +
</nowiki>}}
  
===== Fonts are huge or seems disproportional =====
+
Set execution permissions for the script:
  
Try to force fonts DPI to '''96''' on ''System Settings > Application Appearance > Fonts''.
+
# chmod 755 /usr/local/bin/kde-no-shadow
  
If it does not work try set DPI directly on Xorg configuration [[Xorg#Setting_DPI_manually|here]].
+
The script can be run on login with ''Add Script'' in ''Autostart'':
  
==== Space efficiency ====
+
$ kcmshell5 autostart
  
Users with small screens (eg Netbooks) can change some setting to make KDE more space efficient. See [http://userbase.kde.org/KWin#Using_with_small_screens_(eg_Netbooks) upstream wiki] for more info. Also you can use [http://www.kde.org/workspaces/plasmanetbook/ KDE's Plasma Netbook] which is a workspace made specifically for small, lightweight netbook devices.
+
==== Window decorations ====
  
=== Networking ===
+
[https://store.kde.org/browse/cat/114/ Window decorations] can be changed in ''System Settings > Application Style > Window Decorations''.
  
You can choose from the following tools:
+
There you can also directly download and install more themes with one click, and some are available in the [https://aur.archlinux.org/packages.php?K=kde+window+decoration AUR].
* NetworkManager. See [[NetworkManager#KDE4|NetworkManager]] for more information.
 
* Wicd. See [[Wicd]] for more information.
 
  
=== Printing ===
+
==== Icon themes ====
  
{{Tip|Use the [[CUPS]] web interface for faster configuration.}}
+
Icon themes can be installed and changed on ''System Settings > Icons''.
  
The printers are configured in this way can be found in applications KDE.  
+
{{Note|Although all modern Linux desktops share the same icon theme format, desktops like [[GNOME]] use fewer icons (esp. in menus and toolbars). Themes developed for such desktops usually lack icons required by Plasma and KDE apps. It is recommended to install Plasma compatible icon themes instead.}}
  
You can also choose the printer configuration through ''System Settings > Printer Configuration''. To use this method, you must first install the packages {{Pkg|kdeutils-print-manager}} and {{Pkg|cups}}.
+
{{Tip|Since some icon themes do not inherit from the default icon theme, some icons may be missing.  
 +
To inherit from the Breeze, add {{ic|breeze}} to the {{ic|1=Inherits=}} array in {{ic|/usr/share/icon/''theme-name''/index.theme}}, for example: {{ic|1=Inherits=breeze,hicolor}}. You need to reapply this patch after every update to the icon theme, consider using [[Pacman hooks]] to automate the process.}}
  
You need to start the {{ic|avahi-daemon}} and {{ic|cupsd}} daemons first or you will get the following error:
+
==== Fonts ====
The service 'Printer Configuration' does not provide an interface 'KCModule'
 
with keyword 'system-config- printer-kde/system-config-printer-kde.py'
 
The factory does not support creating components of the specified type.
 
  
If you are getting the following error, you need to give the user rights to manage printers:
+
===== Fonts in a Plasma session look poor =====
There was an error during CUPS operation: 'cups-authorization-canceled'
 
  
For CUPS, this is set in {{ic|/etc/cups/cupsd.conf}}.
+
Try installing the {{Pkg|ttf-dejavu}} and {{Pkg|ttf-liberation}} packages.
  
Adding {{ic|lp}} to {{ic|SystemGroup}} allows anyone who can print to configure printers. You can, of course, add another group instead of {{ic|lp}}.
+
After the installation, be sure to log out and back in. You should not have to modify anything in ''System Settings > Fonts''. If you are using {{Pkg|qt5ct}}, the settings in Qt5 Configuration Tool may override the font settings in System Settings.
{{hc|/etc/cups/cupsd.conf|# Administrator user group...
 
SystemGroup sys root lp}}
 
  
=== Samba/Windows support ===
+
If you have personally set up how your [[Fonts]] render, be aware that System Settings may alter their appearance. When you go ''System Settings > Fonts'' System Settings will likely alter your font configuration file ({{ic|fonts.conf}}).
  
If you want to have access to Windows services install [[Samba]] (package {{Pkg|samba}}).
+
There is no way to prevent this, but, if you set the values to match your {{ic|fonts.conf}} file, the expected font rendering will return (it will require you to restart your application or in a few cases restart your desktop). Note that Gnome's Font Preferences also does this.
  
You may then configure your Samba shares through:
+
===== Fonts are huge or seem disproportional =====
  
System Settings > Sharing > Samba
+
Try to force font DPI to {{ic|'''96'''}} in ''System Settings > Fonts''.
  
=== KDE Desktop activities ===
+
If that does not work, try setting the DPI directly in your Xorg configuration as documented in [[Xorg#Setting DPI manually]].
  
KDE Desktop Activities are Plasma based "virtual desktop"-like set of Plasma Widgets where you can independently configure widgets as if you had more than one screens/desktops.
+
==== Space efficiency ====
  
On your desktop, click the Cashew Plasmoid and on the pop-up window press "Activities".
+
The Plasma Netbook shell has been dropped from Plasma 5, see the following [https://forum.kde.org/viewtopic.php?f=289&t=126631&p=335947&hilit=plasma+netbook#p335899 KDE forum post]
 +
However, you can achieve something similar by editing the file {{ic|~/.config/kwinrc}} adding
 +
{{ic|1=BorderlessMaximizedWindows=true}} in the {{ic|[Windows]}} section.
  
A plasma bar will appear at the bottom of the screen which presents you the current Plasma Desktop Activities which exist. You can then navigate between them by pressing their correspondent icon.
+
==== Thumbnail generation ====
 +
To allow thumbnail generation for media or document files on the desktop and in Dolphin, install {{Pkg|kdegraphics-thumbnailers}}, {{Pkg|ffmpegthumbs}} and {{AUR|kde-thumbnailer-odf}}.
  
=== Power saving ===
+
Then enable the thumbnail categories for the desktop via ''right click'' on the ''desktop background'' > ''Configure Desktop'' > ''Icons'' > ''More Preview Options...''.
  
KDE has an integrated power saving service called "'''Powerdevil Power Management'''" that may adjust the power saving profile of the system and/or the brightness of the screen (if supported).
+
In ''Dolphin'', navigate to ''Control'' > ''General'' > ''Previews''.
  
Since KDE 4.6, CPU frequency scaling is no longer managed by KDE.  Instead it is assumed to be handled automatically by the the hardware and/or kernel.  Arch uses {{ic|ondemand}} as default CPU Frequency governor from kernel vesion 3.3. So nothing need to be done for most cases. For detaild fine tune of the governor, please see [[CPU Frequency Scaling]].
+
=== Printing ===
  
=== Monitoring changes on local files and directories ===
+
{{Tip|Use the [[CUPS]] web interface for faster configuration. Printers configured in this way can be used in KDE applications. }}
  
KDE now uses '''inotify''' directly from the kernel with '''kdirwatch''' (included in kdelibs), so Gamin or FAM are no longer needed. You may want to install this {{AUR|kdirwatch}} from AUR which is a GUI frontend for kdirwatch.
+
You can also configure printers in ''System Settings > Printers''. To use this method, you must first install {{Pkg|print-manager}} and {{Pkg|cups}}. See [[CUPS#Configuration]].
  
== System administration ==
+
=== Samba/Windows support ===
  
=== Set keyboard ===
+
If you want to have access to Windows services, install [[Samba]] (package {{Pkg|samba}}).
  
Navigate to:
+
The Dolphin share functionality requires the package {{Pkg|kdenetwork-filesharing}} and usershares, which the stock {{ic|smb.conf}} does not have enabled. Instructions to add them are in [[Samba#Enable usershares]], after which sharing in Dolphin should work out of the box after restarting Samba.
System Settings > Hardware > Input Devices > Keyboard
 
There you may choose your keyboard model at first.
 
  
In the "'''Layouts'''" tab, you choose the languages you may want to use by pressing the "Add Layout" button and therefore the variant and the language.
+
Plasma's abilities to access SMB shares are limited, though. Writing to Windows shares is problematic and opening files from such shares, e.g. large videos, makes Plasma copying the whole file to the local system first.
 +
To workaround this, you can install a GTK based file browser like {{Pkg|thunar}} with {{Pkg|gvfs}} and {{Pkg|gvfs-smb}} (and {{Pkg|gnome-keyring}} for saving login credentials) to access SMB shares in a more able way.
 +
Another possible workaround is to [[mount]] a Samba share via {{Pkg|cifs-utils}} to make it look to Plasma like if the SMB share was just a normal local folder and thus can be accessed normally.
 +
The mount command could look like the following for write access to a public share:
 +
# mount -t cifs -o username=*,password=*,uid=1000,gid=1000,file_mode=0660,dir_mode=0770 //networkhost/share/ /home/user/localmountpoint/
 +
Make it permanent:
 +
{{hc|/etc/fstab|<nowiki>
 +
//networkhost/share/ /home/user/localmountpoint/ cifs defaults,username=*,password=*,uid=1000,gid=1000,file_mode=0660,dir_mode=0770 0 2
 +
</nowiki>}}
 +
It might be necessary to append {{ic|.local}} to the hostname. For some NAS devices it might also be necessary to append {{ic|1=vers=1.0}} to the argument line to enforce SMB 1.0 compatibility.
  
In the "'''Advanced'''" tab, you can choose the keyboard combination you want in order to change the layouts in the "Key(s) to change layout" sub-menu.
+
An easier solution is to use {{AUR|samba-mounter-git}}, which offers basically the same functionality via an easy to use option located at ''System Settings'' > ''Network Drivers''.
  
=== Terminate Xorg-server through KDE system settings ===
+
=== KDE Desktop activities ===
  
Navigate to:
+
[https://userbase.kde.org/Plasma#Activities KDE Desktop Activities] are special workspaces where you can select specific settings for each activity that apply only when you are using said activity.
System Settings > Input Devices > Keyboard > Advanced (tab) > "Key Sequence to kill the X server" submenu
 
and tick the checkbox.
 
  
=== Useful KCM ===
+
=== Power saving ===
  
KCM means KConfig Module. This modules help you to configure you system providing a interface on System Settings.
+
[[Install]] {{Pkg|powerdevil}} for an integrated power saving service called "'''Powerdevil Power Management'''", that may adjust the power saving profile of the system and/or the brightness of the screen (if supported).
  
'''Configuration for look&feel of your GTK apps.'''
+
{{Accuracy|Regarding the note below, it might be that the problem is the logind setting ''LidSwitchIgnoreInhibited'' which defaults to ''yes''. [https://bbs.archlinux.org/viewtopic.php?pid&#61;1649022#p1649022]}}
* {{Pkg|kde-gtk-config}}
 
* {{AUR|kcm-gtk}}
 
* {{AUR|kcm-qt-graphicssystem}}
 
  
'''Configuration for the GRUB2 bootloader.'''
+
{{Note|Powerdevil may not [[Power management#Power managers|inhibit]] all logind settings (such as the lid close action for laptops). In these cases, the logind setting itself will need to be changed - see [[Power management#Power management with systemd]].}}
* {{AUR|grub2-editor}}
 
* {{AUR|kcm-grub2}}
 
  
'''Configuration for Synaptics driver based touchpads.'''
+
=== Autostart ===
* {{AUR|synaptiks}}
 
* {{AUR|kcm_touchpad}}
 
  
'''Configuration for [[Firewalls#ufw|UFW]]'''
+
Plasma can autostart applications and run scripts on startup and shutdown. To autostart an application, navigate to ''System Settings > Startup and Shutdown > Autostart'' and add the program or shell script of your choice. For applications, a ''.desktop'' file will be created, for shell scripts, a symlink will be created.
* {{AUR|kcm-ufw}}
 
  
'''Configuration for [[PolicyKit]]'''
+
{{Note|
* {{AUR|kcm-polkit-kde-git}}
+
* Programs can be autostarted on login only, whilst shell scripts can also be run on shutdown or even before Plasma itself starts.
 +
* Shell scripts will only be run if they are marked [[executable]].
 +
}}
  
'''Configuration for Wacom Tablet'''
+
* Place [[Desktop entries]] (i.e. ''.desktop'' files) in the appropriate [[XDG Autostart]] directory.
* {{AUR|kcm-wacomtablet}}
 
  
More KCM can be found [http://kde-apps.org/index.php?xcontentmode=273 here].
+
* Place or symlink shell scripts in one of the following directories:
  
== Desktop search and semantic desktop ==
+
:; {{ic|~/.config/plasma-workspace/env/}}: for executing scripts at login before launching Plasma.
 +
:; {{ic|~/.config/autostart-scripts/}}: for executing scripts at login.
 +
:; {{ic|~/.config/plasma-workspace/shutdown/}}: for executing scripts on shutdown.
  
According to [[wikipedia:Semantic_desktop|Wikipedia]], ''"the Semantic Desktop is a collective term for ideas related to changing a computer's user interface and data handling capabilities so that data is more easily shared between different applications or tasks and so that data that once could not be automatically processed by a computer can be (automatically processed)."''
+
=== Phonon ===
  
The KDE implementation of this concept is tied to (as of KDE 4.10) two major pieces of software, Akonadi and Nepomuk. Between the two of them, these programs look at your data and make an easily searchable index of it. The idea behind these pieces of software is to make your system "aware" of your data and give it context using meta-data and user-supplied tags.
+
From [[Wikipedia:Phonon (software)|Wikipedia]]:
  
Soprano and Virtuoso are two dependencies of the Nepomuk Semantic Desktop. Since the relationship between the two major components and their dependencies is not very clear, the following sections try to shed some light on their inner workings.
+
:Phonon is the multimedia API provided by KDE and is the standard abstraction for handling multimedia streams within KDE software and also used by several Qt applications.
  
=== Virtuoso and Soprano ===
+
:Phonon was originally created to allow KDE and Qt software to be independent of any single multimedia framework such as GStreamer or xine and to provide a stable API for a major version's lifetime.
  
The database used to store all the metadata used by the semantic desktop is a ''[[wikipedia:Resource_Description_Framework|Resource Description Framework (RDF)]]'' database called Virtuoso. Internally, Virtuoso may be looked as a relational database. (A [[wikipedia:Relational_model|relational database]] is different from a traditional single-table based database in the sense that it uses multiple tables related by a single key in order to store data.) It is currently controlled by OpenLink, and is available under commercial and an open source license.
+
Phonon is being widely used within KDE, for both audio (e.g., the System notifications or KDE audio apps) and video (e.g., the [[Dolphin]] video thumbnails).
  
From the [http://techbase.kde.org/Projects/Nepomuk/ComponentOverview#Soprano KDE Techbase], ''Soprano is a Qt abstraction over databases. It provides a friendly Qt-based API for accessing different RDF stores. It currently supports 3 database backends - Sesame, Redland and Virtuoso. The KDE Semantic Stack only works with Virtuoso. Soprano also provides additional features such as serializing, parsing RDF data, and a client server architecture that is heavily used in Nepomuk.''
+
==== Which backend should I choose? ====
  
=== Nepomuk ===
+
You can choose between backends based on [[GStreamer]] and [[VLC]] – each available in versions for Qt4 applications and Qt5 applications ({{Pkg|phonon-qt4-gstreamer}}, {{Pkg|phonon-qt5-gstreamer}} – {{Pkg|phonon-qt4-vlc}}, {{Pkg|phonon-qt5-vlc}}).
  
Nepomuk stands for "Networked Environment for Personal, Ontology-based Management of Unified Knowledge". It is what allows all the tagging and labeling of files as well to take place and also serves as the way to actually read the Virtuoso databases. It provides an API to application developers which allows them to read the data collected by it.
+
[https://www.phoronix.com/scan.php?page=news_item&px=MTUwNDM Upstream prefers VLC] but prominent Linux distributions (Kubuntu and Fedora-KDE for example) prefer GStreamer because that allows them to easily leave out patented MPEG codecs from the default installation. Both backends have a slightly different [https://community.kde.org/Phonon/FeatureMatrix features set].
  
In the past, the "Strigi" service was used to collect data about the various files present on the system. However, due to many reasons, the most important of them being CPU and Memory usage, Strigi was replaced by a homegrown indexing service which is integrated with Nepomuk-Core.
+
In the past other backends were developed as well but are no longer maintained and their AUR packages have been deleted.
  
For further information about Nepomuk, [http://techbase.kde.org/Projects/Nepomuk/ComponentOverview#Nepomuk_Components this page] is a good resource. However, some of the information in the previous page has been rendered outdated according to [http://vhanda.in/blog/2012/11/nepomuk-without-strigi/ this blog post].
+
{{Note|1=<br>
 +
* Multiple backends can be installed at once and prioritized at ''System Settings > Multimedia > Backend''.
 +
* According to the [https://forum.kde.org/viewtopic.php?f=250&t=126476&p=335080 KDE forums], the VLC backend lacks support for [[wikipedia:ReplayGain|ReplayGain]].
 +
* If you choose the vlc backend, you may experience crashes every time kde wants to send you a audible warning (and in quite a number of other cases as well, see [https://forum.kde.org/viewtopic.php?f=289&t=135956])
 +
* A possible fix is to run
 +
{{bc|# /usr/lib/vlc/vlc-cache-gen -f /usr/lib/vlc/plugins}}
 +
}}
  
==== Using and configuring Nepomuk ====
+
== Applications ==
  
In order to search using Nepouk on the KDE desktop, press {{ic|ALT+F2}} and type in your query. Nepomuk is enabled by default. It can be turned on and off in:
+
The KDE project provides a suite of applications that integrate with the Plasma desktop. See the {{Grp|kde-applications}} group for a full listing of the available applications. Also see [[:Category:KDE]] for related KDE application pages.
System Settings > Desktop Search
 
  
Nepomuk has to keep track of a lot of files. It is for this reason that it is recommended to increase the number of files that can be watched with inotify. In order to do that this command is a good option.
+
Aside from the programs provided in KDE Applications, there are many other applications available that can complement the Plasma desktop. Some of these are discussed below.
# sysctl fs.inotify.max_user_watches=524288
 
  
To do it persistently:
+
=== System administration ===
# echo "fs.inotify.max_user_watches = 524288" >> /etc/sysctl.d/99-inotify.conf
 
  
Restart Nepomuk to see the changes.
+
==== Terminate Xorg server through KDE System Settings ====
  
==== KDE without Nepomuk ====
+
Navigate to the submenu ''System Settings > Input Devices > Keyboard > Advanced (tab) > "Key Sequence to kill the X server"'' and ensure that the checkbox is ticked.
  
If you wish to run KDE without Nepomuk, there exists a {{AUR|nepomuk-core-fake}} package in the AUR.
+
==== KCM ====
{{Warning|As of now, Dolphin depends on {{Pkg|nepomuk-widgets}} and hence will break if used with the fake Nepomuk package.}}
 
  
=== Akonadi ===
+
KCM stands for '''KC'''onfig '''M'''odule. KCMs can help you configure your system by providing interfaces in System Settings, or through the command line with ''kcmshell5''.
  
Akonadi is a system meant to act as a local cache for PIM data, regardless of its origin, which can be then used by other applications. This includes the user's emails, contacts, calendars, events, journals, alarms, notes, and so on. It interfaces with the Nepomuk libraries to provide searching capabilities.
+
* {{App|kde-gtk-config|GTK2 and GTK3 Configurator for KDE.|https://cgit.kde.org/kde-gtk-config.git|{{Pkg|kde-gtk-config}}}}
 +
* {{App|KCM Qt Graphics System|This KCM allows you to easily configure the standard Qt graphics system.|https://www.linux-apps.com/p/1127857/|{{AUR|kcm-qt-graphicssystem}}}}
 +
* {{App|UFW KControl Module|KDE4 control module for UFW ([[Uncomplicated Firewall]]).|https://www.linux-apps.com/p/1127851/|{{AUR|kcm-ufw}}}}
 +
* {{App|System policies|Set of configuration modules which allows administrator to change [[PolicyKit]] settings.|https://cgit.kde.org/polkit-kde-kcmodules-1.git|{{AUR|kcm-polkit-kde-git}}}}
 +
* {{App|wacom tablet|KDE GUI for the Wacom Linux Drivers.|https://www.linux-apps.com/p/1127862/|{{Pkg|kcm-wacomtablet}}}}
 +
* {{App|Kcmsystemd|systemd control module for KDE.|https://github.com/rthomsen/kcmsystemd|{{Pkg|systemd-kcm}}}}
  
Akonadi does not store any data by itself: the storage format depends on the nature of the data (for example, contacts may be stored in vCard format).
+
More KCMs can be found at [https://www.linux-apps.com/search?projectSearchText=KCM linux-apps.com].
  
For more information on Akonadi and its relationship with Nepomuk, see [http://blogs.kde.org/node/4503] and [http://cmollekopf.wordpress.com/2013/02/13/kontact-nepomuk-integration-why-data-from-akonadi-is-indexed-in-nepomuk/].
+
=== Desktop search ===
  
==== Disabling Akonadi ====
+
KDE implements desktop search with a software called Baloo, a file indexing and searching solution.
  
See this [http://userbase.kde.org/Akonadi#Disabling_the_Akonadi_subsystem section in the KDE userbase].
+
==== Baloo ====
  
==== Database configuration ====
+
===== Using and configuring Baloo =====
  
Start {{ic|akonaditray}} from package {{Pkg|kdepim-runtime}}. Right click on it and select '''configure'''. In the Akonadi server configure tab, you can:
+
In order to search using Baloo on the Plasma desktop, start krunner (default keyboard shortcut {{ic|ALT+F2}}) and type in your query. Within Dolphin press {{ic|CTRL+F}}.
* Configuring Akonadi to use MySQL/MariaDB Server
 
* Configuring Akonadi to use PostgreSQL Server
 
* Configuring Akonadi to use SQLite
 
  
==== Running KDE without Akonadi ====
+
By default the Desktop Search KCM exposes only two options: A panel to blacklist folders and a way to disable it with one click.
  
The package {{AUR|akonadi-fake}} is a good option for those who wish to run KDE without Akonadi.
+
Alternatively you can edit your {{ic|~/.config/baloofilerc}} file ([https://community.kde.org/Baloo/Configuration info]). Additionally the {{ic|balooctl}} process can also be used. In order to disable Baloo run {{ic|balooctl stop}} and {{ic|balooctl disable}}.
  
== Phonon ==
+
Once you added additional folders to the blacklist or disabled Baloo entirely, a process named {{ic|baloo_file_cleaner}} removes all unneeded index files automatically. They are stored under {{ic|~/.local/share/baloo/}}.
  
=== What is Phonon? ===
+
===== How do I index a removable device? =====
  
From [[Wikipedia:Phonon|Wikipedia]]:
+
By default every removable device is blacklisted. You just have to remove your device from the blacklist in the KCM panel.
''Phonon is the multimedia API for KDE 4. Phonon was created to allow KDE 4 to be independent of any single multimedia framework such as GStreamer or xine and to provide a stable API for KDE 4's lifetime. It was done for various reasons: to create a simple KDE/Qt style multimedia API, to better support native multimedia frameworks on Windows and Mac OS X, and to fix problems of frameworks becoming unmaintained or having API or ABI instability.
 
''
 
  
'''Phonon''' is being widely used within KDE, for both audio (e.g., the System notifications or KDE audio apps) and video (e.g., the Dolphin video thumbnails).
+
===== How do I remove baloo_file =====
  
=== Which backend should I choose? ===
+
Baloo_file uses a lot of resources and slow down computers. It also increases power consumption on laptops. While it cannot be removed due to dependencies issues, it is however possible to deactivate it until the next update. As root, type
  
You can choose between various backends, like GStreamer ({{Pkg|phonon-gstreamer}}) or VLC ({{Pkg|phonon-vlc}}) available in the [[official repositories]] and MPlayer ({{AUR|phonon-mplayer-git}}), ({{AUR|phonon-quicktime-git}}) and ({{AUR|phonon-avkode-git}}) available on [[AUR]]. Most users will want GStreamer or VLC which have the best upstream support. Note that multiple backends can be installed at once and you can switch between them via ''System Settings > Multimedia > Phonon > Backend''.
+
killall baloo_file ; mv /usr/bin/baloo_file /usr/bin/baloo_file.bak ; echo '#!/bin/sh' > /usr/bin/baloo_file
  
{{Note|According to the [http://userbase.kde.org/Phonon#Backend_libraries KDE UserBase], Phonon-MPlayer is currently unmaintained}}
+
=== Web browsers ===
  
According to [http://lists.kde.org/?l=kde-multimedia&m=137994906723790&w=2 this mail in the KDE-Multimedia mailing list], users should prefer VLC over GStreamer.
+
* {{App|[[Wikipedia:Konqueror|Konqueror]]|Part of the KDE project, supports two rendering engines – KHTML and the [[Chromium]]-based Qt WebEngine.|https://konqueror.org/|{{Pkg|konqueror}}}}
 +
* {{App|[[Wikipedia:Falkon|Falkon]]|A Qt web browser with Plasma integration features, previously known as Qupzilla. It uses Qt WebEngine.|https://userbase.kde.org/Falkon/|{{Pkg|falkon}}}}
 +
* {{App|[[Chromium]]|Chromium and its proprietary variant Google Chrome have limited Plasma integration. [[KDE Wallet#KDE Wallet for Chrome and Chromium|They can use KWallet]] and KDE Open/Save windows.|https://www.chromium.org/|{{Pkg|chromium}}}}
 +
* {{App|[[Firefox]]|Firefox can be configured to better integrate with Plasma. See [[Firefox#KDE/GNOME integration|Firefox KDE integration]] for details.|https://mozilla.org/firefox|{{Pkg|firefox}}}}
  
== Useful applications ==
+
=== PIM ===
  
The official set of KDE applications may be found [http://www.kde.org/applications/ here].
+
KDE offers its own stack for personal information management. This includes emails, contacts, calendar, etc. To install all the PIM packages, you could use the meta-package {{Pkg|kdepim-meta}}.
  
=== Yakuake ===
+
==== Akonadi ====
  
[http://yakuake.kde.org/ This] application provides a Quake-like terminal emulator, which is toggled visible using the F12 key. It also has support for multiple tabs. Yakuake can be installed by package {{Pkg|yakuake}}.
+
Akonadi is a system meant to act as a local cache for PIM data, regardless of its origin, which can be then used by other applications. This includes the user's emails, contacts, calendars, events, journals, alarms, notes, and so on.
  
===  KDE Telepathy ===
+
Akonadi does not store any data by itself: the storage format depends on the nature of the data (for example, contacts may be stored in vCard format).
  
[http://community.kde.org/KTp KDE Telepathy] is a project with the goal to closely integrate Instant Messaging with the KDE desktop. It utilizes the Telepathy framework as a backend, and is intended to replace Kopete.
+
===== Installation =====
  
To install all Telepathy protocols install the {{Grp|telepathy}} group.
+
Install {{Pkg|akonadi}}. For additional addons, install {{Pkg|kdepim-addons}}.
To use the KDE Telepathy client, install the {{Pkg|kde-telepathy-meta}} package that includes all the packages contained in the {{Grp|kde-telepathy}} group .
 
  
== Tips and tricks ==
+
{{Note|If you wish to use a database engine other than [[MariaDB]] or [[MySQL]], then when installing the {{Pkg|akonadi}} package, use the following command to skip installing the {{Pkg|mariadb}} dependencies:
 +
# pacman -S akonadi --assume-installed mariadb
 +
}}
  
=== Configure KWin to use OpenGL ES ===
+
====== PostgreSQL ======
  
Beginning with KWin version 4.8 it is possible to use the separately built binary '''kwin_gles''' as a replacement for kwin. It behaves almost the same as the kwin executable in OpenGL2 mode with the slight difference that it uses ''egl'' instead of ''glx'' as the native platform interface. To test kwin_gles you just have to run {{ic|kwin_gles --replace}} in Konsole.
+
{{Out of date|Akonadi seems to spawn its own {{ic|postgres}} process. Some {{ic|~/.config/akonadi/akonadiserverrc}} settings need to be updated.|section=Akonadi & PostgreSQL}}
If you want to make this change permanent you have to create a script in {{ic|$(kde4-config --localprefix)/env/}} which exports {{ic|1=KDEWM=kwin_gles}}.
 
  
=== Enabling audio thumbnails under Konqueror/Dolphin file managers ===
+
Install and setup [[PostgreSQL]]. Make sure {{ic|postgresql.service}} is [[started]].
  
For thumbnails of audio files in Konqueror and Dolphin install {{AUR|audiothumbs}} from AUR.
+
Edit Akonadi configuration file so that it has the following contents:
  
=== Enabling video thumbnails under Konqueror/Dolphin file managers ===
+
{{hc|~/.config/akonadi/akonadiserverrc|<nowiki>
 +
[%General]
 +
Driver=QPSQL
  
For thumbnails of videos in konqueror and dolphin install {{Pkg|kdemultimedia-mplayerthumbs}} or {{Pkg|kdemultimedia-ffmpegthumbs}}.
+
[QPSQL]
 +
Host=/run/postgresql/
 +
InitDbPath=/usr/bin/initdb
 +
Name=akonadi
 +
Options=
 +
Password=
 +
Port=5432
 +
ServerPath=/usr/bin/pg_ctl
 +
StartServer=true
 +
User=postgres
 +
</nowiki>}}
  
=== Speed up application startup ===
+
{{Note|If your PostgreSQL database username, password, and port differ from {{ic|postgres}}, {{ic|}} (nothing), and {{ic|5432}}, then make sure you respectively change the configuration options, {{ic|1=User=}}, {{ic|1=Password=}}, and {{ic|1=Port=}}.}}
  
User Rob wrote on his blog this "[http://kdemonkey.blogspot.nl/2008/04/magic-trick.html magic trick]" to improve applications start up by 50-150ms.
+
Start Akonadi with {{ic|akonadictl start}}, and check its status: {{ic|akonadictl status}}.
To enable it, create this folder in your home:
 
$ mkdir -p ~/.compose-cache/
 
  
''For those curious about what is going on here, this enables an optimization which Lubos (of general KDE speediness fame) came up with some time ago and was then rewritten and integrated into libx11. Ordinarily on startup applications read input method information from {{ic|/usr/share/X11/locale/<your locale>/Compose}}. This Compose file is quite long (>5000 lines for the en_US.UTF-8 one) and takes some time to process. libX11 can create a cache of the parsed information which is much quicker to read subsequently, but it will only re-use an existing cache or create a new one in {{ic|~/.compose-cache}} if the directory already exists.''
+
====== SQLite ======
  
=== Hiding partitions ===
+
Edit Akonadi configuration file to match the configuration below:
  
In Dolphin, it is as simple as right-clicking on the partition in the {{ic|Places}} sidebar and selecting {{ic|Hide <partition>}}. Otherwise...
+
{{hc|~/.config/akonadi/akonadiserverrc|2=
 +
[%General]
 +
Driver=QSQLITE3
  
If you wish to prevent your internal partitions from appearing in your file manager, you can create an udev rule, e.g:
+
[QSQLITE3]
 
+
Name=/home/''username''/.local/share/akonadi/akonadi.db
{{hc|/etc/udev/rules.d/10-local.rules|2=
 
KERNEL=="sda[0-9]", ENV{UDISKS_IGNORE}="1"
 
 
}}
 
}}
  
The same thing for a certain partition:
+
===== Disabling Akonadi =====
  
KERNEL=="sda1", ENV{UDISKS_IGNORE}="1"
+
See this [https://userbase.kde.org/Akonadi#Disabling_the_Akonadi_subsystem section in the KDE userbase].
KERNEL=="sda2", ENV{UDISKS_IGNORE}="1"
 
  
=== Konqueror tips ===
+
=== KDE Telepathy ===
  
==== Disabling smart key tooltips (browser) ====
+
[https://community.kde.org/KTp KDE Telepathy] is a project with the goal to closely integrate Instant Messaging with the KDE desktop. It utilizes the Telepathy framework as a backend and is intended to replace Kopete.
  
To disable those smart key tooltips in Konqueror (pressing {{ic|Ctrl}} on a web page), use ''Settings > Configure Konqueror > Web Browsing'' and uncheck ''Enable Access Key activation with Ctrl key'' o
+
To install all Telepathy protocols, install the {{Grp|telepathy}} group.
 +
To use the KDE Telepathy client, install the {{Pkg|telepathy-kde-meta}} package that includes all the packages contained in the {{Grp|telepathy-kde}} group.
  
{{hc|~/.kde4/share/config/konquerorrc|2=
+
==== Use Telegram with KDE Telepathy ====
[Access Keys]
 
Enabled=false
 
}}
 
  
==== Using WebKit ====
+
[[Telegram]] protocol is available using {{pkg|telepathy-haze}}, installing {{aur|telegram-purple}} or {{aur|telegram-purple-git}} and {{aur|telepathy-morse-git}}. The username is the Telegram account telephone number (complete with the national prefix {{ic|+''xx''}}, e.g. {{ic|+49}} for Germany).
  
WebKit is an open source browser engine developed by Apple Inc. It is a derivative from the KHTML and KJS libraries and contains many improvements. WebKit is used by Safari, Google Chrome and rekonq.
+
The configuration through the GUI may be tricky: if the phone number is not accepted when configuring a new account in the KDE Telepathy client (with an error message complaining about an invalid parameter which prevents the account creation), insert it between single quotes and then remove the quotes manually from the configuration file ({{ic|~/.local/share/telepathy/mission-control/accounts.cfg}}) after the account creation (if the quotes are not removed after, an authentication error should rise).
  
It is possible to use WebKit in Konqueror instead of KHTML. First install the {{Pkg|kwebkitpart}} package.
+
{{Note|The configuration file should be edited manually when KDE Telepathy is not running, e.g. when there is no KDE desktop session active, otherwise manual changes may be overwritten by the software.}}
  
Then, after executing Konqueror, navigate to ''Settings > Configure Konqueror > General > Default web browser engine'' and set it as {{ic|WebKit}}.
+
=== KDE Connect ===
  
=== Firefox integration ===
+
[https://community.kde.org/KDEConnect KDE Connect] provides several features to connect your [[Android]] phone with your Linux desktop:
  
See [[Firefox#KDE_integration|Firefox]].
+
* Share files and URLs to/from KDE from/to any app, without wires.
 +
* Touchpad emulation: Use your phone screen as your computer's touchpad.
 +
* Notifications sync (4.3+): Read your Android notifications from the desktop.
 +
* Shared clipboard: copy and paste between your phone and your computer.
 +
* Multimedia remote control: Use your phone as a remote for Linux media players.
 +
* WiFi connection: no usb wire or bluetooth needed.
 +
* RSA Encryption: your information is safe.
  
=== Setting the screensaver background to the same as the current one ===
+
You will need to install KDE Connect both on your computer and on your Android. For PC side, [[install]] {{Pkg|kdeconnect}} package. For Android side, install KDE Connect from [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Google Play] or from [https://f-droid.org/repository/browse/?fdid=org.kde.kdeconnect_tp F-Droid].
  
For the beauty of a system you can placed your current background for your Kscreensaver instead of the default.
+
It is possible to use KDE Connect even if you do not use the Plasma desktop. For desktop environments that use AppIndicators, such as Unity, install {{AUR|indicator-kdeconnect}} package as well.
  
KDE by default is [https://bugs.kde.org/show_bug.cgi?id=312828 not able] to change this for the 'Simple Lock', but a [http://lists.opensuse.org/opensuse-kde/2013-02/msg00082.html workaround] [http://forum.kde.org/viewtopic.php?f=66&t=110039 exists]:
+
== Tips and tricks ==
  
{{hc|/usr/share/apps/ksmserver/screenlocker/org.kde.passworddialog/contents/ui/|
+
=== Use a different window manager ===
[...]
 
        ''#source: theme.wallpaperPathForSize(parent.width, parent.height)''
 
        source: "1920x1080.jpg"
 
[...]
 
}}
 
  
Now you copy your current background image to {{ic|"1920x1080.jpg"}}.  
+
The component chooser settings in Plasma does not allow changing the window manager anymore. [https://github.com/KDE/plasma-desktop/commit/2f83a4434a888cd17b03af1f9925cbb054256ade]
 +
In order to change the window manager used you need to set the {{ic|KDEWM}} [[environment variable]] before KDE startup. [https://wiki.haskell.org/Xmonad/Using_xmonad_in_KDE] To do that you can create a script called {{ic|set_window_manager.sh}} in {{ic|~/.config/plasma-workspace/env}} and export the {{ic|KDEWM}} variable there. For example to use the i3 window manager :
  
Note you have to redo this for each update of the package {{Pkg|kdebase-workspace}}.
+
{{hc|~/.config/plasma-workspace/env/set_window_manager.sh|2=
 +
export KDEWM=/usr/bin/i3
 +
}}
  
=== Setting lockscreen wallpaper to arbitrary image ===
+
And then make it executable :
  
Copy an existing wallpaper profile as a template:
+
{{bc|$ chmod +x ~/.config/plasma-workspace/env/set_window_manager.sh}}
$ cp -r /usr/share/wallpapers/''ExistingWallpaper'' ~/.kde4/share/wallpapers/
 
  
Change the name of the directory, and edit {{ic|metadata.desktop}}:
+
==== KDE/Openbox session ====
  
{{hc|~/.kde4/share/wallpapers/''MyWallpaper''/metadata.desktop|2=
+
The {{Pkg|openbox}} package provides a session for using KDE with [[Openbox]]. To make use of this session, select ''KDE/Openbox'' from the [[display manager]] menu.
[Desktop Entry]
 
Name=MyWallpaper
 
X-KDE-PluginInfo-Name=MyWallpaper
 
}}
 
  
Remove existing images ({{ic|contents/screenshot.png}} and {{ic|images/*}}):
+
For those starting the session manually, add the following line to your [[xinit]] configuration:
$ rm ~/.kde4/share/wallpapers/MyWallpaper/contents/screenshot.png
 
$ rm ~/.kde4/share/wallpapers/MyWallpaper/contents/images/*
 
  
Copy new image in:
+
{{hc|~/.xinitrc|
$ cp ''path/to/MyWallpaper.png'' MyWallpaper/contents/images/1920x1080.png
+
exec openbox-kde-session
 
 
Edit the metadata profile for the current theme:
 
{{hc|~/.kde4/share/apps/desktoptheme/MyTheme/metadata.desktop|2=
 
[Wallpaper]
 
defaultWallpaperTheme=NewWallpaper
 
defaultFileSuffix=.png
 
defaultWidth=1920
 
defaultHeight=1080
 
 
}}
 
}}
  
Lock the screen to check that it worked.
+
==== Re-enabling compositing effects ====
  
{{Note|This method allows you to set the lockscreen background, without changing any system-wide settings. For the change to be system-wide, create the new wallpaper profile in {{ic|/usr/share/wallpapers}}.}}
+
When replacing Kwin with a window manager which does not provide a Compositor (such as Openbox), any desktop compositing effects e.g. transparency will be lost. In this case, install and run a separate Composite manager to provide the effects such as [[Xcompmgr]] or [[Compton]].
 
 
== Troubleshooting ==
 
  
=== Configuration related ===
+
=== Configuring monitor resolution / multiple monitors ===
  
Many issues in KDE are related to configuration. One way to resolve upgrade problems is to start over with a fresh KDE config.  
+
To enable display resolution management and multiple monitors in Plasma, install {{Pkg|kscreen}}. This adds the additional options to ''Sytem Settings > Display and Monitor''.
  
==== Reset all KDE configuration ====
+
=== Disable opening application launcher with Super key (Windows key) ===
  
To test whether your config is the problem try quitting your KDE session by logging out and, in a tty, run
+
To disable this feature you currently can run the following command:
$ mv ~/.kde4 ~/.kde4.safekeeping
 
$ rm .kde4/{cache,socket,tmp}-$(hostname)
 
  
The rm command just removes symbolic links which will be recreated by KDE automatically. Now start a new KDE session to see the results.
+
$ kwriteconfig5 --file kwinrc --group ModifierOnlyShortcuts --key Meta ""
  
If the problem is resolved, you will have a fresh, problem-free {{ic|~/.kde4/}}. You can gradually move parts of your saved configuration back, restarting your session regularly to test, to identify the problematic parts of your config. Some files here are named after applications so you will probably be able to test these without needing to restart KDE.
+
== Troubleshooting ==
  
==== File Indexer Service not working even after enabling everything properly ====
+
=== Configuration related ===
  
This is caused due to a corrupted Nepomuk database. It may be remedied by moving the database or deleting it all together. Log out of KDE and issue this command from a virtual console:
+
Many problems in KDE are related to configuration.
 
 
$ mv ~/.kde4/share/apps/nepomuk ~/.kde4/share/apps/nepomuk_backup
 
 
 
to move your existing (and corrupt) nepomuk database. It will be recreated when you log in again.
 
  
 
==== Plasma desktop behaves strangely ====
 
==== Plasma desktop behaves strangely ====
  
Plasma issues are usually caused by unstable '''plasmoids''' or '''plasma themes'''. First, find which was the last plasmoid or plasma theme you had installed and disable it or uninstall it.  
+
Plasma problems are usually caused by unstable '''Plasma widgets''' (colloquially called ''plasmoids''or '''Plasma themes'''. First, find which was the last widget or theme you had installed and disable it or uninstall it.
  
So, if your desktop suddenly exhibits "locking up", this is likely caused by a faulty installed widget. If you cannot remember which widget you installed before the problem began (sometimes it can be an irregular problem), try to track it down by removing each widget until the problem ceases. Then you can uninstall the widget, and file a bug report (bugs.kde.org) '''only if it is an official widget'''. If it is not, it is recommended you find the entry on kde-look.org and inform the developer of that widget about the issue (detailing steps to reproduce, etc).
+
So, if your desktop suddenly exhibits "locking up", this is likely caused by a faulty installed widget. If you cannot remember which widget you installed before the problem began (sometimes it can be an irregular problem), try to track it down by removing each widget until the problem ceases. Then you can uninstall the widget, and file a bug report (https://bugs.kde.org/) '''only if it is an official widget'''. If it is not, it is recommended you find the entry on https://store.kde.org/ and inform the developer of that widget about the problem (detailing steps to reproduce, etc).
  
If you cannot find the problem, but you do not want ''all'' the KDE settings to be lost, do:
+
If you cannot find the problem, but you do not want ''all'' the settings to be lost, navigate to {{ic|~/.config}}:
  
  $ rm -r ~/.kde4/share/config/plasma*
+
  $ for j in plasma*; do mv -- "$j" "${j%}.bak"; done
  
This command will '''delete all plasma related configs''' of your user and when you will relogin into KDE, you will have the '''default''' settings back. You should know that this action '''cannot be undone'''. You ought to create a backup folder and copy all the plasma related configs in it.
+
This command will '''rename all Plasma related configs''' to *.bak (e.g. {{ic|plasmarc.bak}}) of your user and when you will relogin into Plasma, you will have the '''default''' settings back. To undo that action, remove the .bak file extension. If you already have *.bak files, rename, move, or delete them first. It is highly recommended that you create regular backups anyway. See [[Synchronization and backup programs]] for a list of possible solutions.
  
 
==== Clean cache to resolve upgrade problems ====
 
==== Clean cache to resolve upgrade problems ====
  
The [https://bbs.archlinux.org/viewtopic.php?id=135301 problem] may be caused by old cache. Sometimes after an upgrade, the old cache might introduce strange, hard to debug behaviour such as unkillable shells, hangs when changing various settings and several other problems such as ark being unable to unrar or unzip or amarok not recognizing any of your musics. This solution can also resolve problems with KDE and QT programmes looking bad following upgrade.
+
The [https://bbs.archlinux.org/viewtopic.php?id=135301 problem] may be caused by old cache. Sometimes after an upgrade, the old cache might introduce strange, hard to debug behaviour such as unkillable shells, hangs when changing various settings and several other problems such as ark being unable to unrar or unzip or amarok not recognizing any of your music. This solution can also resolve problems with KDE and Qt programmes looking bad following upgrade.
  
Rebuild your cache with the following commands:
+
Rebuild the cache use the following commands:
  
 
  $ rm ~/.config/Trolltech.conf
 
  $ rm ~/.config/Trolltech.conf
 +
$ kbuildsycoca5 --noincremental
 
  $ kbuildsycoca4 --noincremental
 
  $ kbuildsycoca4 --noincremental
  
Hopefully, your problems are now fixed.
+
Optional empty the {{ic|~/.cache}} folder contents, '''note''' this also clears cache of other applications:
 +
 +
$ rm -rf ~/.cache/*
  
=== Clean akonadi configuration to fix KMail ===
+
=== Graphical problems ===
  
First, make sure that KMail is not running. Then backup configuration:
+
Make sure you have the proper driver for your GPU installed. See [[Xorg#Driver installation]] for more information. If you have an older card, it might help to [[#Disable desktop effects manually or automatically for defined applications]] or [[#Disable compositing]].
$ mv ~/.local/share/akonadi ~/.local/share/akonadi-old
 
$ mv ~/.config/akonadi ~/.config/akonadi-old
 
  
Start ''SystemSettings > Personal'' and remove all the resources. Go back to Dolphin and remove the original {{ic|~/.local/share/akonadi}} and
+
==== Getting current state of KWin for support and debug purposes ====
{{ic|~/.config/akonadi}} - the copies you made ensure that you can back-track if necessary.
 
  
Now go back to the System Settings page and carefully add the necessary resources. You should see the resource reading in your mail folders. Then start Kontact/KMail to see if it work properly.
+
This command prints out a summary of the current state of KWin including used options, used compositing backend and relevant OpenGL driver capabilities. See more on [https://blog.martin-graesslin.com/blog/2012/03/on-getting-help-for-kwin-and-helping-kwin/ Martin's blog].
  
=== Getting current state of KWin for support and debug purposes ===
+
$ qdbus org.kde.KWin /KWin supportInformation
  
This command prints out a wonderful summary of the current state of KWin including used options, used compositing backend and relevant OpenGL driver capabilities. [http://blog.martin-graesslin.com/blog/2012/03/on-getting-help-for-kwin-and-helping-kwin/ See more at Martin's blog]
+
==== Disable desktop effects manually or automatically for defined applications ====
  
$ qdbus org.kde.kwin /KWin supportInformation
+
Plasma has desktop effects enabled by default and e.g. not every game will disable them automatically. You can disable desktop effects in ''System Settings > Desktop Effects'' and you can toggle desktop effects with {{ic|Alt+Shift+F12}}. Additionally, you can create custom KWin rules to automatically disable/enable compositing when a certain application/window starts under ''System Settings > Window Management > Window Rules''.
  
=== KDE4 does not finish loading ===
+
==== Disable compositing ====
  
There might be a situation in which the graphic driver might create a conflict when starting KDE4. This situation happens after the login but before finishing loading the desktop, making the user wait indefinitely at the loading screen. Until now the only users confirmed to be affected by this are the ones that use Nvidia drivers and KDE4.
+
In ''Sytem Settings > Display and Monitor'', uncheck ''Enable compositor on startup'' and restart Plasma.
  
A solution for Nvidia users:
+
==== Flickering in fullscreen when compositing is enabled ====
  
{{hc|~/.kde4/share/config/kwinrc|2=
+
In ''Sytem Settings > Display and Monitor'', uncheck ''Allow applications to block compositing''. This may harm performance.
[Compositing]
 
Enabled=false
 
}}
 
For more information look at this [https://bbs.archlinux.org/viewtopic.php?pid=932598 thread].
 
  
If a minimal install was done, make sure you installed the required font by your phonon backend listed here: [[#Minimal install]]
+
==== Screen tearing with NVIDIA ====
  
=== KDE and Qt programs look bad when in a different window manager ===
+
See [[NVIDIA/Troubleshooting#Avoid screen tearing in KDE (KWin)]].
  
If you are using KDE or Qt programs but not in a full KDE session (specifically, you did not run {{ic|startkde}}), then as of KDE 4.6.1 you will need to tell Qt how to find KDE's styles (Oxygen, QtCurve etc.)
+
==== Plasma cursor sometimes shown incorrecty ====
  
You just need to set the environment variable {{ic|QT_PLUGIN_PATH}}. E.g. put:
+
Create the directory {{ic|~/.icons/default}} and inside a file named {{ic|index.theme}} with the following contents:
  
export QT_PLUGIN_PATH=$HOME/.kde4/lib/kde4/plugins/:/usr/lib/kde4/plugins/
+
{{hc|/home/''archie''/.icons/default/index.theme|2=
 +
[Icon Theme]
 +
Inherits=breeze_cursors
 +
}}
  
into your {{ic|/etc/profile}} (or {{ic|~/.profile}} if you do not have root access). qtconfig should then be able to find your KDE styles and everything should look nice again!
+
Execute the following command:
  
Alternatively, you can symlink the Qt styles directory to the KDE styles one:
+
  $ ln -s /usr/share/icons/breeze_cursors/cursors ~/.icons/default/cursors
  # ln -s /usr/lib/kde4/plugins/styles/ /usr/lib/qt/plugins/styles
 
  
Under Gnome you can try to install the package libgnomeui.
+
=== Sound problems ===
  
=== Graphical related issues ===
+
{{Note|First make sure you have {{Pkg|alsa-utils}} installed.}}
  
==== Low 2D desktop performance (or) artifacts appear when on 2D ====
+
==== No sound after suspend ====
  
===== GPU driver problem =====
+
If there is no sound after suspending and if KMix does not show audio devices which should be there, restarting plasmashell and pulseaudio may help:
  
Make sure you have the proper driver for your card installed, so that your desktop is at least 2D accelerated. Follow these articles for more information: [[ATI]], [[NVIDIA]], [[Intel]] for more information, in order to make sure that everything is all right.
+
$ killall plasmashell
The open-source ATI and Intel drivers and the proprietary (binary) Nvidia driver should theoretically provide the best 2D and 3D acceleration.
+
$ systemctl --user restart pulseaudio.service
 +
$ plasmashell
  
===== The Raster engine workaround =====
+
Some applications may also need to be restarted in order for sound to play from them again.
  
If this does not solve your problems, maybe your driver does not provide a good '''XRender''' acceleration which the current Qt painter engine relies on by default.
+
==== "Falling back to default" messages when trying to listen to any sound ====
  
You can change the painter engine to software based only by invoking the application with the {{ic|-graphicssystem raster}} command line. This rendering engine can be set as the default one by recompiling Qt with the same as configure option, {{ic|-graphicssystem raster}}.
+
When you encounter such messages:
  
The raster paint engine enables the CPU to do the majority of the painting, as opposed to the GPU. You may get better performance, depending on your system. This is basically a work-around for the terrible Linux driver stack, since the CPU should obviously not be doing graphical computations since it is designed for fewer threads of greater complexity, as opposed to the GPU which is many threads but lesser computational strength. So, only use Raster engine if you are having problems or your GPU is much slower than you CPU, otherwise is better to use XRender.
+
The audio playback device ''name_of_the_sound_device'' does not work.
 
+
  Falling back to default
Since Qt 4.7+, recompiling Qt is not needed. Simply export {{ic|1=QT_GRAPHICSSYSTEM=raster}}, or {{ic|opengl}}, or  {{ic|native}} (for the default). Raster depends on the CPU, OpenGL depends on the GPU and high driver support, and Native is just using the X11 rendering (mixture, usually).
 
  
'''The best and automatic way to do that''' is to install {{AUR|kcm-qt-graphicssystem}} from AUR and configure this particular Qt setting through:
+
Go to ''System Settings > Multimedia > Phonon'' and set the device named {{ic|default}} above all the other devices in each box you see.
  
System Settings > Qt Graphics System
+
==== MP3 files cannot be played when using the GStreamer Phonon backend ====
  
For more information, consult this [http://apachelog.wordpress.com/2010/09/05/qt-graphics-system-kcm/ KDE Developer blog entry] and/or this [http://labs.trolltech.com/blogs/2009/12/18/qt-graphics-and-performance-the-raster-engine/ Qt Developer blog entry].
+
This can be solved by installing the GStreamer libav plugin (package {{Pkg|gst-libav}}). If you still encounter problems, you can try changing the Phonon backend used by installing another such as {{Pkg|phonon-qt4-vlc}} or {{Pkg|phonon-qt5-vlc}}.
 +
Then, make sure the backend is preferred via ''System Settings > Multimedia > Backend''.
  
==== Low 3D desktop performance====
+
=== Power management ===
  
KDE begins with desktop effects enabled.  Older cards may be insufficient for 3D desktop acceleration.  You can disable desktop effects in:
+
==== No Suspend/Hibernate options ====
System Settings > Desktop Effects
 
or you can toggle desktop effects with {{ic|Alt+Shift+F12}}.
 
  
{{Note| You may encounter such problems with 3D desktop performance even when using a more powerful graphics card, especially the catalyst proprietary driver ({{ic|fglrx}}). This driver is known for having issues with 3D acceleration. Visit [[ATI|the ATi Wiki page]] for more troubleshooting.}}
+
If your system is able to suspend or hibernate using [[systemd]] but do not have these options shown in KDE, make sure {{Pkg|powerdevil}} is installed.
  
==== Desktop compositing is disabled on my system with a modern Nvidia GPU ====
+
=== Baloo ===
  
Sometimes, KWin may have settings in its configuration file ({{ic|kwinrc}}) that ''may'' cause a problem on re-activating the 3D desktop {{ic|OpenGL}} compositing. That could be caused randomly (for example, due to a sudden Xorg crash or restart, and it gets corrupted), so, in case that happens, delete your {{ic|~/.kde4/share/config/kwinrc}} file and relogin. The KWin settings will turn to the KDE default ones and the problem should be probably gone.
+
==== Inotify folder watch limit error ====
  
==== Flickering in fullscreen when compositing is enabled ====
+
If you get the following error:
  
As of KDE SC 4.6.0, there is an option in ''Sytem Settings > Desktop Effect > Advanced > Suspend desktop effects for fullscreen windows''. Uncheck it would tell kwin to disable unredirect fullscren.
+
KDE Baloo Filewatch service reached the inotify folder watch limit. File changes may be ignored.
  
==== Screen Tearing with desktop compositing enabled ====
+
Then you will need to increase the inotify folder watch limit:
  
{{Note|With the recent update of KDE to 4.11, several new Vsync options have been added, which may help with screen tearing.}}
+
# echo 524288 > /proc/sys/fs/inotify/max_user_watches
  
KWin may suffer from screen tearing while desktop effects are enabled. Uncheck the VSync option under ''System Settings > Desktop Effects > Advanced > Use Vsync''.
+
To make changes permanent, create a {{ic|40-max-user-watches.conf}} file:
  
For proprietary driver users, ensure that the driver's VSync option is enabled ({{ic|amdccle}} for [[Catalyst]] users, and nvidia-settings for [[NVIDIA]] users).
+
{{hc|/etc/sysctl.d/40-max-user-watches.conf|2=
 +
fs.inotify.max_user_watches=524288
 +
}}
  
=== Sound problems under KDE ===
+
=== Akonadi ===
 
 
==== ALSA related problems ====
 
  
{{Note|First make sure you have {{Pkg|alsa-lib}} and {{Pkg|alsa-utils}} installed.}}
+
==== OS error 22 when running on ZFS ====
  
===== "Falling back to default" messages when trying to listen to any sound in KDE =====
+
If your home directory is on a [[ZFS]] pool, create a {{ic|~/.config/akonadi/mysql-local.conf}} file with the following contents:
 
 
When you encounter such messages:
 
The audio playback device ''name_of_the_sound_device'' does not work.
 
Falling back to default
 
Go to:
 
System Settings > Multimedia > Phonon
 
and set the device named {{ic|default}} above all the other devices in each box you see.
 
  
===== I cannot play MP3 files when using the GStreamer Phonon backend =====
+
[mysqld]
 +
innodb_use_native_aio = 0
  
That can be solved by installing the GStreamer plugins (package group {{Grp|gstreamer0.10-plugins}}). If you still encounter problems, you can try changing the Phonon backend used by installing another such as {{Pkg|phonon-vlc}}.
+
See [[MySQL#OS error 22 when running on ZFS]].
Then make sure the backend is preferred via:
 
  
System Settings > Multimedia > Phonon > Backend (tab)
+
=== KMail ===
  
=== Konsole does not save commands' history ===
+
==== Clean akonadi configuration to fix KMail ====
  
By default console commands' history is saved only when you type 'exit' in console. When you close Konsole with 'x' in the corner it does not happen.
+
First, make sure that KMail is not running. Then backup configuration:
To enable autosaving after every command execution:
 
  
{{hc|~/.bashrc|<nowiki>
+
$ cp -a ~/.local/share/akonadi ~/.local/share/akonadi-old
shopt -s histappend
+
$ cp -a ~/.config/akonadi ~/.config/akonadi-old
[[ "${PROMPT_COMMAND}" ]] && PROMPT_COMMAND="$PROMPT_COMMAND;history -a" || PROMPT_COMMAND="history -a"
 
</nowiki>}}
 
  
=== KDE password prompts display three bullets per char ===
+
Start ''SystemSettings > Personal'' and remove all the resources. Go back to Dolphin and remove the original {{ic|~/.local/share/akonadi}} and
 +
{{ic|~/.config/akonadi}} - the copies you made ensure that you can back-track if necessary.
  
You can change it under ''System Settings > Account Details > Password & User Account'':
+
Now go back to the System Settings page and carefully add the necessary resources. You should see the resource reading in your mail folders. Then start Kontact/KMail to see if it work properly.
* Show one bullet for each letter
 
* Show three bullets for each letter
 
* Show nothing
 
  
=== Nepomukserver process still autostart even with semantic desktop disabled ===
+
==== Empty IMAP inbox in KMail ====
  
Go to ''System Settings > Startup and Shutdown > Service Manager > Startup Services'' and uncheck the Nepomuk Search Module.
+
For some IMAP accounts, kmail will show the inbox as a container with all other folders of this account inside. Kmail does not show messages in the inbox container but in all other subfolders, see [https://bugs.kde.org/show_bug.cgi?id=284172 KDE Bug 284172]. To solve this problem simply disable the server side subscription in the kmail account settings.
  
=== Dolphin and File Dialogs are extremely slow to start everytime ===
+
=== Networking ===
  
May be caused by the upower service. If the upower service is not needed on your system, it can be disabled:
+
==== Freezes when using Automount on a NFS volume  ====
  
# systemctl disable upower
+
Using [[Fstab#Automount with systemd]] on a [[NFS]] volume may cause freezes, see [https://bugs.kde.org/show_bug.cgi?id=354137 bug report upstream].
# systemctl mask upower
 
 
 
Obviously this will not have any side effect on a desktop system.
 
 
 
=== Default PDF viewer in GTK applications under KDE ===
 
 
 
In some cases when you have installed [[Inkscape]], [[Gimp]] or other graphic programs, GTK applications ([[Firefox]] among all) might not select Okular as the default PDF application, and they are not going to follow the KDE settings on default applications. You can use the following user command to make Okular the default application again.
 
 
 
$ xdg-mime default kde4-okularApplication_pdf.desktop application/pdf
 
 
 
If you are using a different PDF viewer application, or a different mime-type is misbehaving, you should change {{ic|kde4-okularApplication_pdf.desktop}} and {{ic|application/pdf}} respectively according to your needs.
 
 
 
For more information, consult [[Default Applications]] wiki page.
 
 
 
== Unstable releases ==
 
 
 
When KDE is reaching beta or RC milestone, KDE "unstable" packages are uploaded to the [kde-unstable] repo. They stay there until KDE is declared stable and passes to [extra].
 
 
 
You may add it with:
 
 
 
{{hc|/etc/pacman.conf|2=
 
[kde-unstable]
 
Include = /etc/pacman.d/mirrorlist
 
}}
 
  
# [kde-unstable] is based upon testing. Therefore, you need to enable the repositories in the following order: [kde-unstable], [testing], [core], [extra], [community-testing], [community].
+
=== Aggressive QXcbConnection journal logging ===
# To update from a previous KDE installation, run: {{ic|# pacman -Syu}} or {{ic|# pacman -S kde-unstable/kde}}
 
# If you do not have KDE installed, you might have difficulties to install it by using groups (limitation of pacman)
 
# '''Subscribe and read the [https://mailman.archlinux.org/pipermail/arch-dev-public/ arch-dev-public] mailing list'''
 
# Make sure [[#Distro_and_Upstream_bug_report|you make bug reports]] if you find any issues.
 
  
== Other KDE projects ==
+
See [[Qt#Disable/Change Qt journal logging behaviour]].
  
=== Trinity ===
+
=== KF5/Qt5 applications do not display icons in i3/fvwm/awesome ===
  
From the release of KDE 4.x, the developers dropped support for KDE 3.5.x. Trinity Desktop Environment is a fork of KDE3 developed by Timothy Pearson ([http://trinitydesktop.org/ trinitydesktop.org]). This project aims to keep the KDE3.5 computing style alive, as well as polish off any rough edges that were present as of KDE 3.5.10. See [[Trinity]] for more info.
+
See [[Qt#Configuration of Qt5 apps under environments other than KDE Plasma]].
  
{{Warning|KDE 3 is no longer maintained and supported by the KDE developers. The "Trinity KDE" is maintained by the Trinity project commmunity. Use KDE 3 on your own risk, regarding any bugs, performance issues or security risks.}}
+
=== Problems with saving credentials and persistently occurring KWallet dialogs ===
 +
It is not recommended to turn off the [[KWallet]] password saving system in the user settings as it is required to save encrypted credentials like WiFi passphrases for each user. Persistently occuring KWallet dialogs can be the consequence of turning it off.
 +
In case you find the dialogs to unlock the wallet annoying when applications want to access it, you can let the login managers {{ic|SDDM}} and {{ic|LightDM}} unlock the wallet at login automatically, see [[KDE_Wallet#Unlock_KDE_Wallet_automatically_on_login|KDE Wallet]]. The first wallet needs to be generated by KWallet (and not user-generated) in order to be usable for system program credentials.
 +
In case you want the wallet credentials not to be opened in memory for every application, you can restrict applications from accessing it with {{Pkg|kwalletmanager}} in the KWallet settings.
 +
If you do not care for credential encryption at all, you can simply leave the password forms blank when KWallet asks for the password while creating a wallet. In this case, applications can access passwords without having to unlock the wallet first.
  
== Bugs ==
+
=== Weird "q" symbol in konsole  ===
  
It is preferrable that if you find a minor or serious bug, you should visit [https://bugs.archlinux.org the Arch Bug Tracker] or/and [http://bugs.kde.org KDE Bug Tracker] in order to report that. Make sure that you be clear on what you want to report.
+
If you get a weird "q" symbols in programs such as vim[https://github.com/vim/vim/issues/2008] or neovim[https://github.com/neovim/neovim/issues/7002], it is because they use cursor shape changing escape sequences (DECSCUSR) which konsole does not support. See [https://bugs.kde.org/show_bug.cgi?id=347323 KDE Bug 347323].
  
If you have any issue and you write about in on the Arch forums, first make sure that you have '''fully''' updated your system using a good sync mirror (check [https://www.archlinux.de/?page=MirrorStatus here]) or try [[Reflector]].
+
You will need to disable these escape sequences in the programs that use them. See [https://github.com/neovim/neovim/wiki/FAQ#nvim-shows-weird-symbols-2-q-when-changing-modes neovim FAQ] for a workaround for neovim.
  
 
== See also ==
 
== See also ==
  
* [http://www.kde.org] - KDE homepage
+
* [https://www.kde.org/ KDE homepage]
* [https://bugs.kde.org] - KDE bug tracker
+
* [https://bugs.kde.org/ KDE bug tracker]
* [https://bugs.archlinux.org] - Arch Linux bug tracker
+
* [https://blog.martin-graesslin.com/blog/kategorien/kde/ Martin Graesslin's blog]
* [https://projects.kde.org] - KDE Projects
 

Latest revision as of 14:37, 18 April 2018

KDE is a software project currently comprising of a desktop environment known as Plasma, a collection of libraries and frameworks (KDE Frameworks) and several applications (KDE Applications) as well. KDE upstream has a well maintained UserBase wiki. Detailed information about most KDE applications can be found there.

Contents

Installation

Plasma

Before installing Plasma, make sure you have a working Xorg installation on your system.

Install the plasma-meta meta-package or the plasma group. For differences between plasma-meta and plasma reference Creating packages#Meta packages and groups. Alternatively, for a more minimal Plasma installation, install the plasma-desktop package.

To enable support for Wayland in Plasma, also install the plasma-wayland-session package.

KDE applications

To install the full set of KDE Applications, install the kde-applications group or the kde-applications-meta meta-package. Note that this will only install applications, it will not install any version of Plasma.

Unstable releases

See Official repositories#kde-unstable

Starting Plasma

Note: Although it is possible to launch Plasma under Wayland, there are some missing features and known problems as of Plasma 5.12. See the Plasma 5.12 Errata for a list of issues and the Plasma on Wayland workboard for the current state of development. Use Xorg for the most complete and stable experience.

Plasma can be started either using a display manager, or from the console.

Using a display manager

Note: The NVIDIA proprietary driver implementation for Wayland requires EGLStreams. KDE have not implemented EGLStreams in their Wayland implementation. The following workarounds are available:
  • Using the Nouveau driver.
  • Using the (default) Xorg session.

From the console

To start Plasma with xinit/startx, append exec startkde to your .xinitrc file. If you want to start Xorg at login, please see Start X at login. To start a Plasma on Wayland session from a console, run startplasmacompositor.

Configuration

Most settings for KDE applications are stored in ~/.config. However, configuring KDE is primarily done through the System Settings application. It can be started from a terminal by executing systemsettings5.

Personalization

Plasma desktop

Themes

Plasma themes define the look of panels and plasmoids. For easy system-wide installation, some themes are available in both the official repositories and the AUR.

The easiest way to install themes is by going through the System Settings > Workspace Theme > Desktop Theme > Get new Themes.

This will present a frontend for the KDE-Store that allows you to install, uninstall, or update third-party plasmoid scripts.

Splash and Lock screens are currently unavailable. To customize these screens, you have to modify the original theme found in /usr/share/plasma/look-and-feel/. See this thread on the Kubuntu forums.

Note that the SDDM login screen is not part of this theme.

Qt and GTK+ Applications Appearance
Tip: For Qt and GTK theme consistency, see Uniform look for Qt and GTK applications.
Qt4

For Qt4 applications to have a consistent appearance, there are two options:

Install breeze-kde4 and then pick Breeze as GUI Style in qtconfig-qt4; or install breeze-gtk and pick GTK+ as GUI Style.

GTK+

The recommended theme for a pleasant appearance in GTK+ applications is breeze-gtk or gnome-breeze-gitAUR, a GTK+ theme designed to mimic the appearance of Plasma's Breeze theme. Install kde-gtk-config (part of the plasma group) and select the installed GTK-theme for GTK2/GTK3-Theme in System Settings > Application Style > GNOME Application Style.

In some themes, tooltips in GTK+ applications have white text on white backgrounds making it difficult to read. To change the colors in GTK2 applications, find the section for tooltips in the .gtkrc-2.0 file and change it. For GTK3 application two files need to be changed, gtk.css and settings.ini. It might also help to uncheck the option to Apply colors to non-Qt applications under System Settings > Colors.

Some GTK2 programs like vuescan-binAUR still look hardly usable due to invisible checkboxes with the Breeze or Adwaita skin in a Plasma session. To workaround this, install and select e.g. the Numix-Frost-Light skin of the numix-frost-themesAUR under System Settings > Application Style > GNOME Application Style (GTK) > Select a GTK2 Theme:. Numix-Frost-Light looks similar to Breeze.

Widgets

Plasmoids are little scripted (plasmoid scripts) or coded (plasmoid binaries) KDE applications designed to enhance the functionality of your desktop.

The easiest way to install plasmoid scripts is by right-clicking onto a panel or the desktop and choosing Add Widgets > Get new Widgets > Download Widgets. This will present a nice frontend for https://store.kde.org/ that allows you to install, uninstall, or update third-party plasmoid scripts with literally just one click.

Many Plasmoid binaries are available from the AUR.

Sound applet in the system tray

Install plasma-pa or kmix (start Kmix from the Application Launcher). plasma-pa is now installed by default with plasma, no further configuration needed.

Note: To adjust the step size of volume increments/decrements, add e.g. VolumePercentageStep=1 in the [Global] section of ~/.config/kmixrc.
Disable panel shadow

As the Plasma panel is on top of other windows, its shadow is drawn over them. [1] To disable this behaviour without impacting other shadows, install xorg-xprop and run:

$ xprop -remove _KDE_NET_WM_SHADOW

then select the panel with the plus-sized cursor. [2] For automation, install xorg-xwininfo and create the following script:

/usr/local/bin/kde-no-shadow
#!/bin/bash
for WID in $(xwininfo -root -tree | sed '/"Plasma": ("plasmashell" "plasmashell")/!d; s/^  *\([^ ]*\) .*/\1/g'); do
   xprop -id $WID -remove _KDE_NET_WM_SHADOW
done

Set execution permissions for the script:

# chmod 755 /usr/local/bin/kde-no-shadow

The script can be run on login with Add Script in Autostart:

$ kcmshell5 autostart

Window decorations

Window decorations can be changed in System Settings > Application Style > Window Decorations.

There you can also directly download and install more themes with one click, and some are available in the AUR.

Icon themes

Icon themes can be installed and changed on System Settings > Icons.

Note: Although all modern Linux desktops share the same icon theme format, desktops like GNOME use fewer icons (esp. in menus and toolbars). Themes developed for such desktops usually lack icons required by Plasma and KDE apps. It is recommended to install Plasma compatible icon themes instead.
Tip: Since some icon themes do not inherit from the default icon theme, some icons may be missing. To inherit from the Breeze, add breeze to the Inherits= array in /usr/share/icon/theme-name/index.theme, for example: Inherits=breeze,hicolor. You need to reapply this patch after every update to the icon theme, consider using Pacman hooks to automate the process.

Fonts

Fonts in a Plasma session look poor

Try installing the ttf-dejavu and ttf-liberation packages.

After the installation, be sure to log out and back in. You should not have to modify anything in System Settings > Fonts. If you are using qt5ct, the settings in Qt5 Configuration Tool may override the font settings in System Settings.

If you have personally set up how your Fonts render, be aware that System Settings may alter their appearance. When you go System Settings > Fonts System Settings will likely alter your font configuration file (fonts.conf).

There is no way to prevent this, but, if you set the values to match your fonts.conf file, the expected font rendering will return (it will require you to restart your application or in a few cases restart your desktop). Note that Gnome's Font Preferences also does this.

Fonts are huge or seem disproportional

Try to force font DPI to 96 in System Settings > Fonts.

If that does not work, try setting the DPI directly in your Xorg configuration as documented in Xorg#Setting DPI manually.

Space efficiency

The Plasma Netbook shell has been dropped from Plasma 5, see the following KDE forum post However, you can achieve something similar by editing the file ~/.config/kwinrc adding BorderlessMaximizedWindows=true in the [Windows] section.

Thumbnail generation

To allow thumbnail generation for media or document files on the desktop and in Dolphin, install kdegraphics-thumbnailers, ffmpegthumbs and kde-thumbnailer-odfAUR.

Then enable the thumbnail categories for the desktop via right click on the desktop background > Configure Desktop > Icons > More Preview Options....

In Dolphin, navigate to Control > General > Previews.

Printing

Tip: Use the CUPS web interface for faster configuration. Printers configured in this way can be used in KDE applications.

You can also configure printers in System Settings > Printers. To use this method, you must first install print-manager and cups. See CUPS#Configuration.

Samba/Windows support

If you want to have access to Windows services, install Samba (package samba).

The Dolphin share functionality requires the package kdenetwork-filesharing and usershares, which the stock smb.conf does not have enabled. Instructions to add them are in Samba#Enable usershares, after which sharing in Dolphin should work out of the box after restarting Samba.

Plasma's abilities to access SMB shares are limited, though. Writing to Windows shares is problematic and opening files from such shares, e.g. large videos, makes Plasma copying the whole file to the local system first. To workaround this, you can install a GTK based file browser like thunar with gvfs and gvfs-smb (and gnome-keyring for saving login credentials) to access SMB shares in a more able way. Another possible workaround is to mount a Samba share via cifs-utils to make it look to Plasma like if the SMB share was just a normal local folder and thus can be accessed normally. The mount command could look like the following for write access to a public share:

# mount -t cifs -o username=*,password=*,uid=1000,gid=1000,file_mode=0660,dir_mode=0770 //networkhost/share/ /home/user/localmountpoint/

Make it permanent:

/etc/fstab
//networkhost/share/ /home/user/localmountpoint/ cifs defaults,username=*,password=*,uid=1000,gid=1000,file_mode=0660,dir_mode=0770 0 2

It might be necessary to append .local to the hostname. For some NAS devices it might also be necessary to append vers=1.0 to the argument line to enforce SMB 1.0 compatibility.

An easier solution is to use samba-mounter-gitAUR, which offers basically the same functionality via an easy to use option located at System Settings > Network Drivers.

KDE Desktop activities

KDE Desktop Activities are special workspaces where you can select specific settings for each activity that apply only when you are using said activity.

Power saving

Install powerdevil for an integrated power saving service called "Powerdevil Power Management", that may adjust the power saving profile of the system and/or the brightness of the screen (if supported).

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Regarding the note below, it might be that the problem is the logind setting LidSwitchIgnoreInhibited which defaults to yes. [3] (Discuss in Talk:KDE#)
Note: Powerdevil may not inhibit all logind settings (such as the lid close action for laptops). In these cases, the logind setting itself will need to be changed - see Power management#Power management with systemd.

Autostart

Plasma can autostart applications and run scripts on startup and shutdown. To autostart an application, navigate to System Settings > Startup and Shutdown > Autostart and add the program or shell script of your choice. For applications, a .desktop file will be created, for shell scripts, a symlink will be created.

Note:
  • Programs can be autostarted on login only, whilst shell scripts can also be run on shutdown or even before Plasma itself starts.
  • Shell scripts will only be run if they are marked executable.
  • Place or symlink shell scripts in one of the following directories:
~/.config/plasma-workspace/env/
for executing scripts at login before launching Plasma.
~/.config/autostart-scripts/
for executing scripts at login.
~/.config/plasma-workspace/shutdown/
for executing scripts on shutdown.

Phonon

From Wikipedia:

Phonon is the multimedia API provided by KDE and is the standard abstraction for handling multimedia streams within KDE software and also used by several Qt applications.
Phonon was originally created to allow KDE and Qt software to be independent of any single multimedia framework such as GStreamer or xine and to provide a stable API for a major version's lifetime.

Phonon is being widely used within KDE, for both audio (e.g., the System notifications or KDE audio apps) and video (e.g., the Dolphin video thumbnails).

Which backend should I choose?

You can choose between backends based on GStreamer and VLC – each available in versions for Qt4 applications and Qt5 applications (phonon-qt4-gstreamer, phonon-qt5-gstreamerphonon-qt4-vlc, phonon-qt5-vlc).

Upstream prefers VLC but prominent Linux distributions (Kubuntu and Fedora-KDE for example) prefer GStreamer because that allows them to easily leave out patented MPEG codecs from the default installation. Both backends have a slightly different features set.

In the past other backends were developed as well but are no longer maintained and their AUR packages have been deleted.

Note:
  • Multiple backends can be installed at once and prioritized at System Settings > Multimedia > Backend.
  • According to the KDE forums, the VLC backend lacks support for ReplayGain.
  • If you choose the vlc backend, you may experience crashes every time kde wants to send you a audible warning (and in quite a number of other cases as well, see [4])
  • A possible fix is to run
# /usr/lib/vlc/vlc-cache-gen -f /usr/lib/vlc/plugins

Applications

The KDE project provides a suite of applications that integrate with the Plasma desktop. See the kde-applications group for a full listing of the available applications. Also see Category:KDE for related KDE application pages.

Aside from the programs provided in KDE Applications, there are many other applications available that can complement the Plasma desktop. Some of these are discussed below.

System administration

Terminate Xorg server through KDE System Settings

Navigate to the submenu System Settings > Input Devices > Keyboard > Advanced (tab) > "Key Sequence to kill the X server" and ensure that the checkbox is ticked.

KCM

KCM stands for KConfig Module. KCMs can help you configure your system by providing interfaces in System Settings, or through the command line with kcmshell5.

  • kde-gtk-config — GTK2 and GTK3 Configurator for KDE.
https://cgit.kde.org/kde-gtk-config.git || kde-gtk-config
  • KCM Qt Graphics System — This KCM allows you to easily configure the standard Qt graphics system.
https://www.linux-apps.com/p/1127857/ || kcm-qt-graphicssystemAUR
https://www.linux-apps.com/p/1127851/ || kcm-ufwAUR
  • System policies — Set of configuration modules which allows administrator to change PolicyKit settings.
https://cgit.kde.org/polkit-kde-kcmodules-1.git || kcm-polkit-kde-gitAUR
  • wacom tablet — KDE GUI for the Wacom Linux Drivers.
https://www.linux-apps.com/p/1127862/ || kcm-wacomtablet
  • Kcmsystemd — systemd control module for KDE.
https://github.com/rthomsen/kcmsystemd || systemd-kcm

More KCMs can be found at linux-apps.com.

Desktop search

KDE implements desktop search with a software called Baloo, a file indexing and searching solution.

Baloo

Using and configuring Baloo

In order to search using Baloo on the Plasma desktop, start krunner (default keyboard shortcut ALT+F2) and type in your query. Within Dolphin press CTRL+F.

By default the Desktop Search KCM exposes only two options: A panel to blacklist folders and a way to disable it with one click.

Alternatively you can edit your ~/.config/baloofilerc file (info). Additionally the balooctl process can also be used. In order to disable Baloo run balooctl stop and balooctl disable.

Once you added additional folders to the blacklist or disabled Baloo entirely, a process named baloo_file_cleaner removes all unneeded index files automatically. They are stored under ~/.local/share/baloo/.

How do I index a removable device?

By default every removable device is blacklisted. You just have to remove your device from the blacklist in the KCM panel.

How do I remove baloo_file

Baloo_file uses a lot of resources and slow down computers. It also increases power consumption on laptops. While it cannot be removed due to dependencies issues, it is however possible to deactivate it until the next update. As root, type

killall baloo_file ; mv /usr/bin/baloo_file /usr/bin/baloo_file.bak ; echo '#!/bin/sh' > /usr/bin/baloo_file

Web browsers

  • Konqueror — Part of the KDE project, supports two rendering engines – KHTML and the Chromium-based Qt WebEngine.
https://konqueror.org/ || konqueror
  • Falkon — A Qt web browser with Plasma integration features, previously known as Qupzilla. It uses Qt WebEngine.
https://userbase.kde.org/Falkon/ || falkon
  • Chromium — Chromium and its proprietary variant Google Chrome have limited Plasma integration. They can use KWallet and KDE Open/Save windows.
https://www.chromium.org/ || chromium
https://mozilla.org/firefox || firefox

PIM

KDE offers its own stack for personal information management. This includes emails, contacts, calendar, etc. To install all the PIM packages, you could use the meta-package kdepim-meta.

Akonadi

Akonadi is a system meant to act as a local cache for PIM data, regardless of its origin, which can be then used by other applications. This includes the user's emails, contacts, calendars, events, journals, alarms, notes, and so on.

Akonadi does not store any data by itself: the storage format depends on the nature of the data (for example, contacts may be stored in vCard format).

Installation

Install akonadi. For additional addons, install kdepim-addons.

Note: If you wish to use a database engine other than MariaDB or MySQL, then when installing the akonadi package, use the following command to skip installing the mariadb dependencies:
# pacman -S akonadi --assume-installed mariadb
PostgreSQL

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: Akonadi seems to spawn its own postgres process. Some ~/.config/akonadi/akonadiserverrc settings need to be updated. (Discuss in Talk:KDE#Akonadi & PostgreSQL)

Install and setup PostgreSQL. Make sure postgresql.service is started.

Edit Akonadi configuration file so that it has the following contents:

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QPSQL

[QPSQL]
Host=/run/postgresql/
InitDbPath=/usr/bin/initdb
Name=akonadi
Options=
Password=
Port=5432
ServerPath=/usr/bin/pg_ctl
StartServer=true
User=postgres
Note: If your PostgreSQL database username, password, and port differ from postgres, (nothing), and 5432, then make sure you respectively change the configuration options, User=, Password=, and Port=.

Start Akonadi with akonadictl start, and check its status: akonadictl status.

SQLite

Edit Akonadi configuration file to match the configuration below:

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QSQLITE3

[QSQLITE3]
Name=/home/username/.local/share/akonadi/akonadi.db
Disabling Akonadi

See this section in the KDE userbase.

KDE Telepathy

KDE Telepathy is a project with the goal to closely integrate Instant Messaging with the KDE desktop. It utilizes the Telepathy framework as a backend and is intended to replace Kopete.

To install all Telepathy protocols, install the telepathy group. To use the KDE Telepathy client, install the telepathy-kde-meta package that includes all the packages contained in the telepathy-kde group.

Use Telegram with KDE Telepathy

Telegram protocol is available using telepathy-haze, installing telegram-purpleAUR or telegram-purple-gitAUR and telepathy-morse-gitAUR. The username is the Telegram account telephone number (complete with the national prefix +xx, e.g. +49 for Germany).

The configuration through the GUI may be tricky: if the phone number is not accepted when configuring a new account in the KDE Telepathy client (with an error message complaining about an invalid parameter which prevents the account creation), insert it between single quotes and then remove the quotes manually from the configuration file (~/.local/share/telepathy/mission-control/accounts.cfg) after the account creation (if the quotes are not removed after, an authentication error should rise).

Note: The configuration file should be edited manually when KDE Telepathy is not running, e.g. when there is no KDE desktop session active, otherwise manual changes may be overwritten by the software.

KDE Connect

KDE Connect provides several features to connect your Android phone with your Linux desktop:

  • Share files and URLs to/from KDE from/to any app, without wires.
  • Touchpad emulation: Use your phone screen as your computer's touchpad.
  • Notifications sync (4.3+): Read your Android notifications from the desktop.
  • Shared clipboard: copy and paste between your phone and your computer.
  • Multimedia remote control: Use your phone as a remote for Linux media players.
  • WiFi connection: no usb wire or bluetooth needed.
  • RSA Encryption: your information is safe.

You will need to install KDE Connect both on your computer and on your Android. For PC side, install kdeconnect package. For Android side, install KDE Connect from Google Play or from F-Droid.

It is possible to use KDE Connect even if you do not use the Plasma desktop. For desktop environments that use AppIndicators, such as Unity, install indicator-kdeconnectAUR package as well.

Tips and tricks

Use a different window manager

The component chooser settings in Plasma does not allow changing the window manager anymore. [5] In order to change the window manager used you need to set the KDEWM environment variable before KDE startup. [6] To do that you can create a script called set_window_manager.sh in ~/.config/plasma-workspace/env and export the KDEWM variable there. For example to use the i3 window manager :

~/.config/plasma-workspace/env/set_window_manager.sh
export KDEWM=/usr/bin/i3

And then make it executable :

$ chmod +x ~/.config/plasma-workspace/env/set_window_manager.sh

KDE/Openbox session

The openbox package provides a session for using KDE with Openbox. To make use of this session, select KDE/Openbox from the display manager menu.

For those starting the session manually, add the following line to your xinit configuration:

~/.xinitrc
exec openbox-kde-session

Re-enabling compositing effects

When replacing Kwin with a window manager which does not provide a Compositor (such as Openbox), any desktop compositing effects e.g. transparency will be lost. In this case, install and run a separate Composite manager to provide the effects such as Xcompmgr or Compton.

Configuring monitor resolution / multiple monitors

To enable display resolution management and multiple monitors in Plasma, install kscreen. This adds the additional options to Sytem Settings > Display and Monitor.

Disable opening application launcher with Super key (Windows key)

To disable this feature you currently can run the following command:

$ kwriteconfig5 --file kwinrc --group ModifierOnlyShortcuts --key Meta ""

Troubleshooting

Configuration related

Many problems in KDE are related to configuration.

Plasma desktop behaves strangely

Plasma problems are usually caused by unstable Plasma widgets (colloquially called plasmoids) or Plasma themes. First, find which was the last widget or theme you had installed and disable it or uninstall it.

So, if your desktop suddenly exhibits "locking up", this is likely caused by a faulty installed widget. If you cannot remember which widget you installed before the problem began (sometimes it can be an irregular problem), try to track it down by removing each widget until the problem ceases. Then you can uninstall the widget, and file a bug report (https://bugs.kde.org/) only if it is an official widget. If it is not, it is recommended you find the entry on https://store.kde.org/ and inform the developer of that widget about the problem (detailing steps to reproduce, etc).

If you cannot find the problem, but you do not want all the settings to be lost, navigate to ~/.config:

$ for j in plasma*; do mv -- "$j" "${j%}.bak"; done

This command will rename all Plasma related configs to *.bak (e.g. plasmarc.bak) of your user and when you will relogin into Plasma, you will have the default settings back. To undo that action, remove the .bak file extension. If you already have *.bak files, rename, move, or delete them first. It is highly recommended that you create regular backups anyway. See Synchronization and backup programs for a list of possible solutions.

Clean cache to resolve upgrade problems

The problem may be caused by old cache. Sometimes after an upgrade, the old cache might introduce strange, hard to debug behaviour such as unkillable shells, hangs when changing various settings and several other problems such as ark being unable to unrar or unzip or amarok not recognizing any of your music. This solution can also resolve problems with KDE and Qt programmes looking bad following upgrade.

Rebuild the cache use the following commands:

$ rm ~/.config/Trolltech.conf
$ kbuildsycoca5 --noincremental
$ kbuildsycoca4 --noincremental

Optional empty the ~/.cache folder contents, note this also clears cache of other applications:

$ rm -rf ~/.cache/*

Graphical problems

Make sure you have the proper driver for your GPU installed. See Xorg#Driver installation for more information. If you have an older card, it might help to #Disable desktop effects manually or automatically for defined applications or #Disable compositing.

Getting current state of KWin for support and debug purposes

This command prints out a summary of the current state of KWin including used options, used compositing backend and relevant OpenGL driver capabilities. See more on Martin's blog.

$ qdbus org.kde.KWin /KWin supportInformation

Disable desktop effects manually or automatically for defined applications

Plasma has desktop effects enabled by default and e.g. not every game will disable them automatically. You can disable desktop effects in System Settings > Desktop Effects and you can toggle desktop effects with Alt+Shift+F12. Additionally, you can create custom KWin rules to automatically disable/enable compositing when a certain application/window starts under System Settings > Window Management > Window Rules.

Disable compositing

In Sytem Settings > Display and Monitor, uncheck Enable compositor on startup and restart Plasma.

Flickering in fullscreen when compositing is enabled

In Sytem Settings > Display and Monitor, uncheck Allow applications to block compositing. This may harm performance.

Screen tearing with NVIDIA

See NVIDIA/Troubleshooting#Avoid screen tearing in KDE (KWin).

Plasma cursor sometimes shown incorrecty

Create the directory ~/.icons/default and inside a file named index.theme with the following contents:

/home/archie/.icons/default/index.theme
[Icon Theme]
Inherits=breeze_cursors

Execute the following command:

$ ln -s /usr/share/icons/breeze_cursors/cursors ~/.icons/default/cursors

Sound problems

Note: First make sure you have alsa-utils installed.

No sound after suspend

If there is no sound after suspending and if KMix does not show audio devices which should be there, restarting plasmashell and pulseaudio may help:

$ killall plasmashell
$ systemctl --user restart pulseaudio.service
$ plasmashell

Some applications may also need to be restarted in order for sound to play from them again.

"Falling back to default" messages when trying to listen to any sound

When you encounter such messages:

The audio playback device name_of_the_sound_device does not work.
Falling back to default

Go to System Settings > Multimedia > Phonon and set the device named default above all the other devices in each box you see.

MP3 files cannot be played when using the GStreamer Phonon backend

This can be solved by installing the GStreamer libav plugin (package gst-libav). If you still encounter problems, you can try changing the Phonon backend used by installing another such as phonon-qt4-vlc or phonon-qt5-vlc. Then, make sure the backend is preferred via System Settings > Multimedia > Backend.

Power management

No Suspend/Hibernate options

If your system is able to suspend or hibernate using systemd but do not have these options shown in KDE, make sure powerdevil is installed.

Baloo

Inotify folder watch limit error

If you get the following error:

KDE Baloo Filewatch service reached the inotify folder watch limit. File changes may be ignored.

Then you will need to increase the inotify folder watch limit:

# echo 524288 > /proc/sys/fs/inotify/max_user_watches

To make changes permanent, create a 40-max-user-watches.conf file:

/etc/sysctl.d/40-max-user-watches.conf
fs.inotify.max_user_watches=524288

Akonadi

OS error 22 when running on ZFS

If your home directory is on a ZFS pool, create a ~/.config/akonadi/mysql-local.conf file with the following contents:

[mysqld]
innodb_use_native_aio = 0

See MySQL#OS error 22 when running on ZFS.

KMail

Clean akonadi configuration to fix KMail

First, make sure that KMail is not running. Then backup configuration:

$ cp -a ~/.local/share/akonadi ~/.local/share/akonadi-old
$ cp -a ~/.config/akonadi ~/.config/akonadi-old

Start SystemSettings > Personal and remove all the resources. Go back to Dolphin and remove the original ~/.local/share/akonadi and ~/.config/akonadi - the copies you made ensure that you can back-track if necessary.

Now go back to the System Settings page and carefully add the necessary resources. You should see the resource reading in your mail folders. Then start Kontact/KMail to see if it work properly.

Empty IMAP inbox in KMail

For some IMAP accounts, kmail will show the inbox as a container with all other folders of this account inside. Kmail does not show messages in the inbox container but in all other subfolders, see KDE Bug 284172. To solve this problem simply disable the server side subscription in the kmail account settings.

Networking

Freezes when using Automount on a NFS volume

Using Fstab#Automount with systemd on a NFS volume may cause freezes, see bug report upstream.

Aggressive QXcbConnection journal logging

See Qt#Disable/Change Qt journal logging behaviour.

KF5/Qt5 applications do not display icons in i3/fvwm/awesome

See Qt#Configuration of Qt5 apps under environments other than KDE Plasma.

Problems with saving credentials and persistently occurring KWallet dialogs

It is not recommended to turn off the KWallet password saving system in the user settings as it is required to save encrypted credentials like WiFi passphrases for each user. Persistently occuring KWallet dialogs can be the consequence of turning it off. In case you find the dialogs to unlock the wallet annoying when applications want to access it, you can let the login managers SDDM and LightDM unlock the wallet at login automatically, see KDE Wallet. The first wallet needs to be generated by KWallet (and not user-generated) in order to be usable for system program credentials. In case you want the wallet credentials not to be opened in memory for every application, you can restrict applications from accessing it with kwalletmanager in the KWallet settings. If you do not care for credential encryption at all, you can simply leave the password forms blank when KWallet asks for the password while creating a wallet. In this case, applications can access passwords without having to unlock the wallet first.

Weird "q" symbol in konsole

If you get a weird "q" symbols in programs such as vim[7] or neovim[8], it is because they use cursor shape changing escape sequences (DECSCUSR) which konsole does not support. See KDE Bug 347323.

You will need to disable these escape sequences in the programs that use them. See neovim FAQ for a workaround for neovim.

See also