My KWIN fork where I work on features like per-output virtual desktops
Find a file
Vlad Zahorodnii 2691b84c99 autotests: Introduce helper classes for testing xdg-shell clients
After splitting out the server part of KWayland into a separate repo,
all non-core protocol wrappers in KWayland::Client had become obsolete
and using them in new projects is highly discouraged.
2020-09-09 15:23:05 +00:00
3rdparty Synchronize xcursor.c 2020-07-27 15:00:13 +00:00
autotests autotests: Introduce helper classes for testing xdg-shell clients 2020-09-09 15:23:05 +00:00
cmake/modules Switch to SPDX license markers 2020-08-07 19:57:56 +00:00
colorcorrection Prettify license headers 2020-08-07 19:57:56 +00:00
data Prettify license headers 2020-08-07 19:57:56 +00:00
decorations Prettify license headers 2020-08-07 19:57:56 +00:00
doc Change CommandAllKey to Meta 2020-05-22 22:39:08 -04:00
effects SVN_SILENT made messages (.desktop file) - always resolve ours 2020-09-09 06:33:22 +02:00
helpers Prettify license headers 2020-08-07 19:57:56 +00:00
kcmkwin kcmkwin/tabbox: Port away from deprecated KTitleWidget::setPixmap() 2020-09-09 13:53:26 +00:00
kconf_update [kwinrules] Add kconf_update script to fix placement rule 2020-05-27 18:13:00 +00:00
libinput Fix Build Warning 2020-08-26 19:24:02 +02:00
libkwineffects Fix Build Warning 2020-08-26 19:24:02 +02:00
LICENSES Switch to SPDX license markers 2020-08-07 19:57:56 +00:00
platformsupport Implement EGL_KHR_partial_update and EGL_EXT_swap_buffers_with_damage 2020-08-19 14:51:42 +00:00
plugins qpa: remove unused override for the inputcontext 2020-09-03 12:29:57 +00:00
qml Remove embedded implementation of the Virtual Keyboard 2020-08-18 10:55:21 +00:00
screencast screencast: Switch to new outputScreencastRequested() signal 2020-09-04 08:49:52 +00:00
scripting Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
scripts Drop empty X-KDE-PluginInfo-Depends 2020-09-01 09:11:48 +00:00
tabbox Fix Build Warning 2020-08-26 19:24:02 +02:00
tests Prettify license headers 2020-08-07 19:57:56 +00:00
xwl xwayland: Properly handle xcb_connect_to_fd() failures 2020-09-02 12:49:44 +00:00
abstract_client.cpp Introduce a property to indicate if client is placeable 2020-09-03 18:11:44 +00:00
abstract_client.h Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
abstract_opengl_context_attribute_builder.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
abstract_opengl_context_attribute_builder.h Prettify license headers 2020-08-07 19:57:56 +00:00
abstract_output.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
abstract_output.h Move AbstractWaylandOutput::geometryChanged() to AbstractOutput 2020-09-03 18:11:44 +00:00
abstract_wayland_output.cpp Adapt to XdgOutputManagerV1 changes 2020-08-20 17:53:10 +03:00
abstract_wayland_output.h Move AbstractWaylandOutput::geometryChanged() to AbstractOutput 2020-09-03 18:11:44 +00:00
activation.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
activities.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
activities.h Prettify license headers 2020-08-07 19:57:56 +00:00
appmenu.cpp Use namespace kwin only in autotests 2020-08-21 22:06:36 +00:00
appmenu.h Prettify license headers 2020-08-07 19:57:56 +00:00
atoms.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
atoms.h Prettify license headers 2020-08-07 19:57:56 +00:00
client_machine.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
client_machine.h Prettify license headers 2020-08-07 19:57:56 +00:00
CMakeLists.txt Use consistent naming pattern for wayland shell integrations 2020-09-04 16:51:25 +03:00
composite.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
composite.h Prettify license headers 2020-08-07 19:57:56 +00:00
config-kwin.h.cmake Only define PipeWire_FOUND if it's found 2020-07-24 02:06:45 +02:00
cursor.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
cursor.h Prettify license headers 2020-08-07 19:57:56 +00:00
dbusinterface.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
dbusinterface.h Prettify license headers 2020-08-07 19:57:56 +00:00
debug_console.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
debug_console.h Prettify license headers 2020-08-07 19:57:56 +00:00
debug_console.ui fixuifiles 2018-09-18 07:52:44 +02:00
deleted.cpp Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
deleted.h Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
dmabuftexture.cpp Use namespace kwin only in autotests 2020-08-21 22:06:36 +00:00
dmabuftexture.h Prettify license headers 2020-08-07 19:57:56 +00:00
effectloader.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
effectloader.h Prettify license headers 2020-08-07 19:57:56 +00:00
effects.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
effects.h Prettify license headers 2020-08-07 19:57:56 +00:00
egl_context_attribute_builder.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
egl_context_attribute_builder.h Prettify license headers 2020-08-07 19:57:56 +00:00
events.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
fixqopengl.h Prettify license headers 2020-08-07 19:57:56 +00:00
focuschain.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
focuschain.h Prettify license headers 2020-08-07 19:57:56 +00:00
geometrytip.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
geometrytip.h Prettify license headers 2020-08-07 19:57:56 +00:00
gestures.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
gestures.h Prettify license headers 2020-08-07 19:57:56 +00:00
globalshortcuts.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
globalshortcuts.h Prettify license headers 2020-08-07 19:57:56 +00:00
group.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
group.h Prettify license headers 2020-08-07 19:57:56 +00:00
HACKING.md Introduce coding-conventions.md 2020-02-03 12:45:47 +02:00
idle_inhibition.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
idle_inhibition.h Prettify license headers 2020-08-07 19:57:56 +00:00
input.cpp Avoid QPointer in return types of Input methods 2020-09-08 08:04:13 +00:00
input.h Avoid QPointer in return types of Input methods 2020-09-08 08:04:13 +00:00
input_event.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
input_event.h Prettify license headers 2020-08-07 19:57:56 +00:00
input_event_spy.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
input_event_spy.h Prettify license headers 2020-08-07 19:57:56 +00:00
inputpanelv1client.cpp Port InputPanelV1Client to WaylandClient's geometry helpers 2020-09-03 18:11:44 +00:00
inputpanelv1client.h Port InputPanelV1Client to WaylandClient's geometry helpers 2020-09-03 18:11:44 +00:00
inputpanelv1integration.cpp wayland: Refactor creation of input panel clients 2020-09-04 13:08:34 +00:00
inputpanelv1integration.h wayland: Refactor creation of input panel clients 2020-09-04 13:08:34 +00:00
internal_client.cpp Remove InternalClient::isInputMethod() 2020-09-04 06:47:38 +00:00
internal_client.h Remove InternalClient::isInputMethod() 2020-09-04 06:47:38 +00:00
keyboard_input.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
keyboard_input.h Prettify license headers 2020-08-07 19:57:56 +00:00
keyboard_layout.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
keyboard_layout.h fix: keyboard layout applet doesn't show actual layout 2020-08-20 16:09:43 +00:00
keyboard_layout_switching.cpp fix: keyboard layout applet doesn't show actual layout 2020-08-20 16:09:43 +00:00
keyboard_layout_switching.h Prettify license headers 2020-08-07 19:57:56 +00:00
keyboard_repeat.cpp Don't leak QTimer 2020-08-14 16:49:33 +02:00
keyboard_repeat.h Prettify license headers 2020-08-07 19:57:56 +00:00
killwindow.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
killwindow.h Prettify license headers 2020-08-07 19:57:56 +00:00
kwin.kcfg xwayland: Restart the Xwayland server after it has crashed 2020-09-01 06:16:02 +00:00
kwin.notifyrc SVN_SILENT made messages (.desktop file) - always resolve ours 2020-09-07 06:05:30 +02:00
kwinbindings.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
KWinDBusInterfaceConfig.cmake.in Add path to kwin_wayland binary to KWin's installed CMakeConfig 2015-11-19 09:28:16 +01:00
layers.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
layershellv1client.cpp Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
layershellv1client.h Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
layershellv1integration.cpp Slightly improve code readability 2020-09-09 17:05:34 +03:00
layershellv1integration.h Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
linux_dmabuf.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
linux_dmabuf.h Prettify license headers 2020-08-07 19:57:56 +00:00
logind.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
logind.h Prettify license headers 2020-08-07 19:57:56 +00:00
logo.png GIT_SILENT: add KWin icon as repository logo 2020-05-20 12:47:52 +00:00
main.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
main.h Prettify license headers 2020-08-07 19:57:56 +00:00
main_wayland.cpp Kill the input method process when terminating the session 2020-08-18 10:55:21 +00:00
main_wayland.h Prettify license headers 2020-08-07 19:57:56 +00:00
main_x11.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
main_x11.h Prettify license headers 2020-08-07 19:57:56 +00:00
Mainpage.dox Apidocs mainpage work. Just got Plasma and Solid to do here. 2007-07-24 18:30:36 +00:00
Messages.sh Extract messages from cpp files in colorcorrection/ 2020-01-12 21:24:17 +02:00
modifier_only_shortcuts.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
modifier_only_shortcuts.h Prettify license headers 2020-08-07 19:57:56 +00:00
moving_client_x11_filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
moving_client_x11_filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
netinfo.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
netinfo.h Prettify license headers 2020-08-07 19:57:56 +00:00
onscreennotification.cpp Use namespace kwin only in autotests 2020-08-21 22:06:36 +00:00
onscreennotification.h Prettify license headers 2020-08-07 19:57:56 +00:00
options.cpp xwayland: Restart the Xwayland server after it has crashed 2020-09-01 06:16:02 +00:00
options.h xwayland: Restart the Xwayland server after it has crashed 2020-09-01 06:16:02 +00:00
org.kde.kappmenu.xml Restore global menu support 2017-01-11 10:21:03 +01:00
org.kde.kwin.ColorCorrect.xml [nightcolor] Expose transition timings to d-bus 2020-01-15 21:15:26 +02:00
org.kde.kwin.Compositing.xml [kcmkwin/compositing] Hide config options which don't make sense if Compositing is required 2016-09-13 15:47:42 +02:00
org.kde.kwin.Effects.xml [kwin] Add a new EffectLoader 2014-03-28 14:04:55 +01:00
org.kde.KWin.Session.xml Remove QSessionManager usage 2020-04-06 11:51:47 +02:00
org.kde.KWin.VirtualDesktopManager.xml [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
org.kde.KWin.xml Add a dbus method getWindowInfo returning same data as queryWindowInfo 2018-12-17 18:12:17 +01:00
osd.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
osd.h Prettify license headers 2020-08-07 19:57:56 +00:00
outline.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
outline.h Prettify license headers 2020-08-07 19:57:56 +00:00
outputscreens.cpp Introduce Platform::findOutput(int) overload 2020-09-03 18:11:44 +00:00
outputscreens.h Prettify license headers 2020-08-07 19:57:56 +00:00
overlaywindow.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
overlaywindow.h Prettify license headers 2020-08-07 19:57:56 +00:00
placement.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
placement.h Prettify license headers 2020-08-07 19:57:56 +00:00
plasma-kwin_wayland.service.in Install service files for kwin 2020-07-30 15:02:08 +01:00
plasma-kwin_x11.service.in Install service files for kwin 2020-07-30 15:02:08 +01:00
platform.cpp Introduce Platform::findOutput(int) overload 2020-09-03 18:11:44 +00:00
platform.h Introduce Platform::findOutput(int) overload 2020-09-03 18:11:44 +00:00
pointer_input.cpp Avoid QPointer in return types of Input methods 2020-09-08 08:04:13 +00:00
pointer_input.h Prettify license headers 2020-08-07 19:57:56 +00:00
popup_input_filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
popup_input_filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
README.md Capstone commit to prevent force push reversed commits returning accidentally. 2020-06-03 09:54:00 +00:00
rootinfo_filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
rootinfo_filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
rulebooksettings.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
rulebooksettings.h Prettify license headers 2020-08-07 19:57:56 +00:00
rulebooksettingsbase.kcfg Port kwinrules kcm to kconfigxt 2020-03-16 13:21:43 +01:00
rulebooksettingsbase.kcfgc Port kwinrules kcm to kconfigxt 2020-03-16 13:21:43 +01:00
rules.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
rules.h Prettify license headers 2020-08-07 19:57:56 +00:00
rulesettings.kcfg Fix minor typo: inital -> initial 2020-03-17 09:41:12 +02:00
rulesettings.kcfgc Port kwinrules kcm to kconfigxt 2020-03-16 13:21:43 +01:00
scene.cpp Fix Build Warning 2020-08-26 19:24:02 +02:00
scene.h Implement EGL_KHR_partial_update and EGL_EXT_swap_buffers_with_damage 2020-08-19 14:51:42 +00:00
screenedge.cpp fix(space): check edges for nearly complete screen overlap 2020-09-01 14:39:36 +00:00
screenedge.h Prettify license headers 2020-08-07 19:57:56 +00:00
screenlockerwatcher.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
screenlockerwatcher.h Prettify license headers 2020-08-07 19:57:56 +00:00
screens.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
screens.h Prettify license headers 2020-08-07 19:57:56 +00:00
service_utils.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
service_utils.h Prettify license headers 2020-08-07 19:57:56 +00:00
settings.kcfgc Use KConfigXT in KWin::Options 2013-02-14 08:29:03 +01:00
shadow.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
shadow.h Prettify license headers 2020-08-07 19:57:56 +00:00
shortcutdialog.ui [kwin] Use ui-file for ShortcutDialog 2014-02-27 10:18:37 +01:00
sm.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
sm.h Prettify license headers 2020-08-07 19:57:56 +00:00
subsurfacemonitor.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
subsurfacemonitor.h Prettify license headers 2020-08-07 19:57:56 +00:00
syncalarmx11filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
syncalarmx11filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
tablet_input.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
tablet_input.h Prettify license headers 2020-08-07 19:57:56 +00:00
tabletmodemanager.cpp Use namespace kwin only in autotests 2020-08-21 22:06:36 +00:00
tabletmodemanager.h Prettify license headers 2020-08-07 19:57:56 +00:00
TESTING.md [platform/virtual] Drop support for vgem and rendernode 2019-01-12 07:37:25 +01:00
thumbnailitem.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
thumbnailitem.h Prettify license headers 2020-08-07 19:57:56 +00:00
toplevel.cpp Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
toplevel.h Expose the toplevel's pid in the scripting API 2020-08-21 15:44:52 +02:00
touch_hide_cursor_spy.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
touch_hide_cursor_spy.h Prettify license headers 2020-08-07 19:57:56 +00:00
touch_input.cpp Avoid QPointer in return types of Input methods 2020-09-08 08:04:13 +00:00
touch_input.h Prettify license headers 2020-08-07 19:57:56 +00:00
udev.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
udev.h Prettify license headers 2020-08-07 19:57:56 +00:00
unmanaged.cpp Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
unmanaged.h Use universal helper for writing toplevels to QDebug streams 2020-08-21 11:42:53 +00:00
useractions.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
useractions.h Prettify license headers 2020-08-07 19:57:56 +00:00
utils.cpp Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
utils.h Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
virtual_terminal.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
virtual_terminal.h Prettify license headers 2020-08-07 19:57:56 +00:00
virtualdesktops.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
virtualdesktops.h Prettify license headers 2020-08-07 19:57:56 +00:00
virtualdesktopsdbustypes.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
virtualdesktopsdbustypes.h Prettify license headers 2020-08-07 19:57:56 +00:00
virtualkeyboard.cpp Unset virtual keyboard geometry when the input panel surface is unmapped 2020-09-04 13:08:34 +00:00
virtualkeyboard.h virtualkeyboard: update the input panel state when textinput requests it 2020-09-03 09:08:54 +00:00
virtualkeyboard_dbus.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
virtualkeyboard_dbus.h Prettify license headers 2020-08-07 19:57:56 +00:00
was_user_interaction_x11_filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
was_user_interaction_x11_filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
wayland_server.cpp Use consistent naming pattern for wayland shell integrations 2020-09-04 16:51:25 +03:00
wayland_server.h wayland: Refactor creation of input panel clients 2020-09-04 13:08:34 +00:00
waylandclient.cpp Remove WaylandClient::isInputMethod() 2020-09-04 06:47:38 +00:00
waylandclient.h Remove WaylandClient::isInputMethod() 2020-09-04 06:47:38 +00:00
waylandshellintegration.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
waylandshellintegration.h Prettify license headers 2020-08-07 19:57:56 +00:00
window_property_notify_x11_filter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
window_property_notify_x11_filter.h Prettify license headers 2020-08-07 19:57:56 +00:00
workspace.cpp Initialize fields of the Workspace class in correct order 2020-09-09 14:16:02 +00:00
workspace.h Move struts logic to AbstractClient 2020-09-03 18:11:44 +00:00
x11client.cpp Move struts logic to AbstractClient 2020-09-03 18:11:44 +00:00
x11client.h Move struts logic to AbstractClient 2020-09-03 18:11:44 +00:00
x11eventfilter.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
x11eventfilter.h Prettify license headers 2020-08-07 19:57:56 +00:00
xcbutils.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
xcbutils.h Prettify license headers 2020-08-07 19:57:56 +00:00
xcursortheme.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
xcursortheme.h Prettify license headers 2020-08-07 19:57:56 +00:00
xdgshellclient.cpp Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
xdgshellclient.h Implement the layer-shell v1 protocol 2020-09-03 18:11:44 +00:00
xdgshellintegration.cpp Use consistent naming pattern for wayland shell integrations 2020-09-04 16:51:25 +03:00
xdgshellintegration.h Use consistent naming pattern for wayland shell integrations 2020-09-04 16:51:25 +03:00
xkb.cpp Clean xkb debug output of empty lines 2020-08-11 13:57:13 +02:00
xkb.h Prettify license headers 2020-08-07 19:57:56 +00:00
xkb_qt_mapping.h Prettify license headers 2020-08-07 19:57:56 +00:00
xwaylandclient.cpp Prettify license headers 2020-08-07 19:57:56 +00:00
xwaylandclient.h Prettify license headers 2020-08-07 19:57:56 +00:00

KWin

KWin is an easy to use, but flexible, composited Window Manager for Xorg windowing systems (Wayland, X11) on Linux. Its primary usage is in conjunction with a Desktop Shell (e.g. KDE Plasma Desktop). KWin is designed to go out of the way; users should not notice that they use a window manager at all. Nevertheless KWin provides a steep learning curve for advanced features, which are available, if they do not conflict with the primary mission. KWin does not have a dedicated targeted user group, but follows the targeted user group of the Desktop Shell using KWin as it's window manager.

KWin is not...

  • a standalone window manager (c.f. openbox, i3) and does not provide any functionality belonging to a Desktop Shell.
  • a replacement for window managers designed for use with a specific Desktop Shell (e.g. GNOME Shell)
  • a minimalistic window manager
  • designed for use without compositing or for X11 network transparency, though both are possible.

Contacting KWin development team

Support

Application Developer

If you are an application developer having questions regarding windowing systems (either X11 or Wayland) please do not hesitate to contact us. Preferable through our mailing list. Ideally subscribe to the mailing list, so that your mail doesn't get stuck in the moderation queue.

End user

Please contact the support channels of your Linux distribution for user support. The KWin development team does not provide end user support.

Reporting bugs

Please use KDE's bugtracker and report for product KWin.

Developing on KWin

Please refer to hacking documentation for how to build and start KWin. Further information about KWin's test suite can be found in TESTING.md.

Guidelines for new features

A new Feature can only be added to KWin if:

  • it does not violate the primary missions as stated at the start of this document
  • it does not introduce instabilities
  • it is maintained, that is bugs are fixed in a timely manner (second next minor release) if it is not a corner case.
  • it works together with all existing features
  • it supports both single and multi screen (xrandr)
  • it adds a significant advantage
  • it is feature complete, that is supports at least all useful features from competitive implementations
  • it is not a special case for a small user group
  • it does not increase code complexity significantly
  • it does not affect KWin's license (GPLv2+)

All new added features are under probation, that is if any of the non-functional requirements as listed above do not hold true in the next two feature releases, the added feature will be removed again.

The same non functional requirements hold true for any kind of plugins (effects, scripts, etc.). It is suggested to use scripted plugins and distribute them separately.