You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

David Edmundson 260e75f6c9 Update systemd units By marking as part of graphical-session we get a more graceful shutdown. Also switched to explicit restart inside the unit. Originally I did this with drop-ins, but this complicates wayland for now.		4 years ago
3rdparty	…
LICENSES	Switch to SPDX license markers	4 years ago
autotests	Fix for PlasmaSurfaceTest broken in a3b50500	4 years ago
cmake/modules	…
colorcorrection	…
data	Expose KWIN_XWL logging category to kdebugsettings	4 years ago
decorations	Use Header color group for decoration colours	4 years ago
doc	…
effects	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
helpers	…
kcmkwin	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
kconf_update	…
libinput	…
libkwineffects	Remove unnecessary allocation in GLShader::setUniform(int, const QMatrix4x4 &)	4 years ago
platformsupport	Centralize WindowPixmap buffer updating code	4 years ago
plugins	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
qml	…
screencast	screencast: Ensure that there is current OpenGL context when recording a window	4 years ago
scripting	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
scripts	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
tabbox	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
tests	…
xwl	…
CMakeLists.txt	Bump up minimum C++ version to C++17	4 years ago
HACKING.md	…
KWinDBusInterfaceConfig.cmake.in	…
Mainpage.dox	…
Messages.sh	…
README.md	…
TESTING.md	…
abstract_client.cpp	…
abstract_client.h	[scripting] Make client.activities writable	4 years ago
abstract_opengl_context_attribute_builder.cpp	…
abstract_opengl_context_attribute_builder.h	…
abstract_output.cpp	…
abstract_output.h	…
abstract_wayland_output.cpp	…
abstract_wayland_output.h	…
activation.cpp	…
activities.cpp	…
activities.h	…
appmenu.cpp	…
appmenu.h	…
atoms.cpp	…
atoms.h	…
client_machine.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
client_machine.h	…
composite.cpp	Improve Compositor::performCompositing	4 years ago
composite.h	…
config-kwin.h.cmake	…
cursor.cpp	…
cursor.h	…
dbusinterface.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
dbusinterface.h	…
debug_console.cpp	Reduce resets in DebugConsole when viewing subsurfaces	4 years ago
debug_console.h	…
debug_console.ui	…
deleted.cpp	…
deleted.h	…
dmabuftexture.cpp	…
dmabuftexture.h	Prettify license headers	4 years ago
effectloader.cpp	…
effectloader.h	…
effects.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
effects.h	Have Toplevel::damage emit a QRegion	4 years ago
egl_context_attribute_builder.cpp	…
egl_context_attribute_builder.h	…
events.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
fixqopengl.h	…
focuschain.cpp	…
focuschain.h	…
geometrytip.cpp	…
geometrytip.h	…
gestures.cpp	…
gestures.h	…
globalshortcuts.cpp	…
globalshortcuts.h	…
group.cpp	…
group.h	…
idle_inhibition.cpp	…
idle_inhibition.h	…
input.cpp	…
input.h	…
input_event.cpp	…
input_event.h	…
input_event_spy.cpp	…
input_event_spy.h	…
inputpanelv1client.cpp	Enable shadow protocol support for all Wayland clients	4 years ago
inputpanelv1client.h	…
inputpanelv1integration.cpp	…
inputpanelv1integration.h	…
internal_client.cpp	Properly test internal window flags	4 years ago
internal_client.h	Use better window placement heuristics for internal clients	4 years ago
keyboard_input.cpp	…
keyboard_input.h	…
keyboard_layout.cpp	…
keyboard_layout.h	…
keyboard_layout_switching.cpp	…
keyboard_layout_switching.h	…
keyboard_repeat.cpp	…
keyboard_repeat.h	…
killwindow.cpp	…
killwindow.h	…
kwin.kcfg	…
kwin.notifyrc	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
kwinbindings.cpp	…
layers.cpp	Fix invalidation of cached x stacking order in wayland only mode	4 years ago
layershellv1client.cpp	Enable shadow protocol support for all Wayland clients	4 years ago
layershellv1client.h	…
layershellv1integration.cpp	…
layershellv1integration.h	…
linux_dmabuf.cpp	…
linux_dmabuf.h	…
logind.cpp	…
logind.h	…
logo.png	…
main.cpp	…
main.h	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
main_wayland.cpp	…
main_wayland.h	Prettify license headers	4 years ago
main_x11.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
main_x11.h	…
modifier_only_shortcuts.cpp	…
modifier_only_shortcuts.h	…
moving_client_x11_filter.cpp	…
moving_client_x11_filter.h	…
netinfo.cpp	…
netinfo.h	…
onscreennotification.cpp	…
onscreennotification.h	…
options.cpp	…
options.h	…
org.kde.KWin.Session.xml	…
org.kde.KWin.VirtualDesktopManager.xml	…
org.kde.KWin.xml	…
org.kde.kappmenu.xml	Restore global menu support	8 years ago
org.kde.kwin.ColorCorrect.xml	…
org.kde.kwin.Compositing.xml	…
org.kde.kwin.Effects.xml	…
osd.cpp	…
osd.h	…
outline.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
outline.h	…
outputscreens.cpp	…
outputscreens.h	…
overlaywindow.cpp	…
overlaywindow.h	…
placement.cpp	…
placement.h	…
plasma-kwin_wayland.service.in	Update systemd units	4 years ago
plasma-kwin_x11.service.in	Update systemd units	4 years ago
platform.cpp	…
platform.h	…
pointer_input.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
pointer_input.h	…
popup_input_filter.cpp	…
popup_input_filter.h	…
rootinfo_filter.cpp	…
rootinfo_filter.h	…
rulebooksettings.cpp	…
rulebooksettings.h	Prettify license headers	4 years ago
rulebooksettingsbase.kcfg	…
rulebooksettingsbase.kcfgc	…
rules.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
rules.h	…
rulesettings.kcfg	…
rulesettings.kcfgc	…
scene.cpp	Always include the window decoration's clipping	4 years ago
scene.h	Centralize WindowPixmap buffer updating code	4 years ago
screenedge.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
screenedge.h	Prettify license headers	4 years ago
screenlockerwatcher.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
screenlockerwatcher.h	…
screens.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
screens.h	…
service_utils.cpp	…
service_utils.h	Fix email address	4 years ago
settings.kcfgc	…
shadow.cpp	…
shadow.h	…
shortcutdialog.ui	…
sm.cpp	…
sm.h	…
subsurfacemonitor.cpp	…
subsurfacemonitor.h	…
syncalarmx11filter.cpp	…
syncalarmx11filter.h	…
tablet_input.cpp	…
tablet_input.h	…
tabletmodemanager.cpp	…
tabletmodemanager.h	…
thumbnailitem.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
thumbnailitem.h	…
toplevel.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
toplevel.h	Have Toplevel::damage emit a QRegion	4 years ago
touch_hide_cursor_spy.cpp	…
touch_hide_cursor_spy.h	…
touch_input.cpp	…
touch_input.h	…
udev.cpp	…
udev.h	…
unmanaged.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
unmanaged.h	…
useractions.cpp	…
useractions.h	…
utils.cpp	Implement the layer-shell v1 protocol	4 years ago
utils.h	…
virtual_terminal.cpp	…
virtual_terminal.h	…
virtualdesktops.cpp	…
virtualdesktops.h	…
virtualdesktopsdbustypes.cpp	…
virtualdesktopsdbustypes.h	…
virtualkeyboard.cpp	Remove unused things in VirtualKeyboard	4 years ago
virtualkeyboard.h	Remove unused things in VirtualKeyboard	4 years ago
virtualkeyboard_dbus.cpp	…
virtualkeyboard_dbus.h	…
was_user_interaction_x11_filter.cpp	…
was_user_interaction_x11_filter.h	…
wayland_server.cpp	Adjust kwin to recent window management interface changes	4 years ago
wayland_server.h	…
waylandclient.cpp	Enable shadow protocol support for all Wayland clients	4 years ago
waylandclient.h	…
waylandshellintegration.cpp	…
waylandshellintegration.h	…
window_property_notify_x11_filter.cpp	…
window_property_notify_x11_filter.h	…
workspace.cpp	Replace remaining usages of old connect syntax with new connect syntax	4 years ago
workspace.h	…
x11client.cpp	…
x11client.h	…
x11eventfilter.cpp	…
x11eventfilter.h	…
xcbutils.cpp	…
xcbutils.h	Correct typos in xcbutils.h	4 years ago
xcursortheme.cpp	…
xcursortheme.h	…
xdgshellclient.cpp	Enable shadow protocol support for all Wayland clients	4 years ago
xdgshellclient.h	…
xdgshellintegration.cpp	…
xdgshellintegration.h	…
xkb.cpp	…
xkb.h	…
xkb_qt_mapping.h	…
xwaylandclient.cpp	…
xwaylandclient.h	…

README.md

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

mailing list: kwin@kde.org
IRC: #kwin on freenode

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.