Plugin based library to create window decorations.


KDecoration2 is a library to create window decorations. These window decorations can be used by for example an X11 based window manager which re-parents a Client window to a window decoration frame.

The library consists of two parts:

  • Decoration API for implementing a Decoration theme
  • Private API to implement the backend part (e.g. from Window Manager side)

Providing a Decoration

To provide a custom decoration one needs to create a plugin and provide an own implementation of KDecoration2::Decoration. For a framework to load and find the plugin it needs to be compiled with the proper json metadata. An example for such metadata (deco.json):

"KPlugin": {
"Id": "org.kde.myAweseomeDecoration",
"ServiceTypes": [
"org.kde.kdecoration2": {
"blur": false, /* blur behind not needed */
"kcmodule": true /* comes with a configuration module */

To simplify one can use the KPluginFactory macro from the KCoreAddons framework:


The plugin needs to get installed to ${KDE_INSTALL_PLUGINDIR}/org.kde.kdecoration2.

#define K_PLUGIN_FACTORY_WITH_JSON(name, jsonFile, pluginRegistrations)
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Wed Jun 7 2023 04:06:18 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.