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

Vlad Zahorodnii 44176c6a8c Lower default severity of logging categories Warning messages are not the kind of messages that should be ignored, they indicate that something is off or wrong. Also, this makes triaging bugs easier as we no longer have to ask people to run kwin with the QT_LOGGING_RULES environment variable set.		4 years ago
3rdparty	…
LICENSES	…
autotests	Lower default severity of logging categories	4 years ago
cmake/modules	…
data	Lower default severity of logging categories	4 years ago
decorations	Lower default severity of logging categories	4 years ago
doc	…
effects	Lower default severity of logging categories	4 years ago
helpers	Include <fcntl.h> for open()	4 years ago
kcmkwin	kcm/kwinrules: Add hint about ignore geometry	4 years ago
kconf_update	…
libinput	Lower default severity of logging categories	4 years ago
libkwineffects	Lower default severity of logging categories	4 years ago
platformsupport	…
plugins	Lower default severity of logging categories	4 years ago
qml	…
scripting	Lower default severity of logging categories	4 years ago
scripts	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
tabbox	Lower default severity of logging categories	4 years ago
tests	…
xwl	…
.gitignore	…
CMakeLists.txt	Update version number for 5.21.80	4 years ago
HACKING.md	…
KWinDBusInterfaceConfig.cmake.in	…
Mainpage.dox	…
Messages.sh	…
README.md	…
TESTING.md	…
abstract_client.cpp	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
abstract_client.h	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
abstract_opengl_context_attribute_builder.cpp	…
abstract_opengl_context_attribute_builder.h	…
abstract_output.cpp	wayland: Close layer-shell clients when associated output is disabled	4 years ago
abstract_output.h	wayland: Close layer-shell clients when associated output is disabled	4 years ago
abstract_wayland_output.cpp	wayland: Close layer-shell clients when associated output is disabled	4 years ago
abstract_wayland_output.h	wayland: Close layer-shell clients when associated output is disabled	4 years ago
activation.cpp	…
activities.cpp	If include is define in .h remove it if it's defined in .cpp too (scripted)	4 years ago
activities.h	…
appmenu.cpp	…
appmenu.h	…
atoms.cpp	…
atoms.h	…
client_machine.cpp	…
client_machine.h	…
colordevice.cpp	…
colordevice.h	…
colormanager.cpp	…
colormanager.h	…
composite.cpp	Add ftrace markers	4 years ago
composite.h	…
config-kwin.h.cmake	…
cursor.cpp	…
cursor.h	…
dbusinterface.cpp	…
dbusinterface.h	…
debug_console.cpp	…
debug_console.h	…
debug_console.ui	…
deleted.cpp	Don't use "no border" property to determine if Deleted was decorated	4 years ago
deleted.h	Don't use "no border" property to determine if Deleted was decorated	4 years ago
dmabuftexture.cpp	…
dmabuftexture.h	…
effectloader.cpp	…
effectloader.h	…
effects.cpp	…
effects.h	…
egl_context_attribute_builder.cpp	…
egl_context_attribute_builder.h	…
events.cpp	…
focuschain.cpp	…
focuschain.h	…
ftrace.cpp	Minor pedantic include fixes in FTraceLogger	4 years ago
ftrace.h	Minor pedantic include fixes in FTraceLogger	4 years ago
geometrytip.cpp	…
geometrytip.h	…
gestures.cpp	…
gestures.h	…
globalshortcuts.cpp	…
globalshortcuts.h	…
group.cpp	…
group.h	…
idle_inhibition.cpp	…
idle_inhibition.h	…
input.cpp	Add test for TouchInputRedirection::m_touches	4 years ago
input.h	Add test for TouchInputRedirection::m_touches	4 years ago
input_event.cpp	…
input_event.h	…
input_event_spy.cpp	…
input_event_spy.h	…
inputmethod.cpp	…
inputmethod.h	…
inputpanelv1client.cpp	…
inputpanelv1client.h	…
inputpanelv1integration.cpp	…
inputpanelv1integration.h	…
internal_client.cpp	…
internal_client.h	…
keyboard_input.cpp	fix: keyboard layout applet: no flag if Display Name is set	4 years ago
keyboard_input.h	…
keyboard_layout.cpp	Register unique service name when wayland keyboard interface is in use	4 years ago
keyboard_layout.h	refactor: keyboard layout applet: return to Properties-based QML API	4 years ago
keyboard_layout_switching.cpp	fix: Clazy detached QVector warning [clazy-range-loop]	4 years ago
keyboard_layout_switching.h	refactor: pass layout in KeyboardLayout::layoutChanged() signal argument	4 years ago
keyboard_repeat.cpp	…
keyboard_repeat.h	…
killwindow.cpp	…
killwindow.h	…
kwin.kcfg	Introduce a setting to specify an input method	4 years ago
kwin.notifyrc	SVN_SILENT made messages (.desktop file) - always resolve ours	4 years ago
kwinbindings.cpp	…
layers.cpp	…
layershellv1client.cpp	wayland: Close layer-shell clients when associated output is disabled	4 years ago
layershellv1client.h	wayland: Close layer-shell clients when associated output is disabled	4 years ago
layershellv1integration.cpp	wayland: Arrange layer shell surfaces only on enabled outputs	4 years ago
layershellv1integration.h	…
linux_dmabuf.cpp	…
linux_dmabuf.h	…
logind.cpp	…
logind.h	…
logo.png	…
main.cpp	…
main.h	…
main_wayland.cpp	wayland: fix check for creating input method connection	4 years ago
main_wayland.h	Restart the input method if it crashes	4 years ago
main_x11.cpp	Lower default severity of logging categories	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.Plugins.xml	…
org.kde.KWin.Session.xml	…
org.kde.KWin.VirtualDesktopManager.xml	…
org.kde.KWin.xml	…
org.kde.kappmenu.xml	…
org.kde.kwin.Compositing.xml	…
org.kde.kwin.Effects.xml	…
osd.cpp	…
osd.h	…
outline.cpp	…
outline.h	…
overlaywindow.cpp	…
overlaywindow.h	…
placement.cpp	…
placement.h	…
plasma-kwin_wayland.service.in	…
plasma-kwin_x11.service.in	…
platform.cpp	Add test for TouchInputRedirection::m_touches	4 years ago
platform.h	Add test for TouchInputRedirection::m_touches	4 years ago
plugin.cpp	…
plugin.h	…
pluginmanager.cpp	…
pluginmanager.h	…
pointer_input.cpp	…
pointer_input.h	…
popup_input_filter.cpp	…
popup_input_filter.h	…
renderjournal.cpp	…
renderjournal.h	…
renderloop.cpp	Properly schedule repaints with premature presentation timestamps	4 years ago
renderloop.h	…
renderloop_p.h	…
rootinfo_filter.cpp	…
rootinfo_filter.h	Prettify license headers	4 years ago
rulebooksettings.cpp	…
rulebooksettings.h	…
rulebooksettingsbase.kcfg	…
rulebooksettingsbase.kcfgc	…
rules.cpp	…
rules.h	…
rulesettings.kcfg	…
rulesettings.kcfgc	…
scene.cpp	wayland: Fix crash when all outputs are disconnected	4 years ago
scene.h	…
screenedge.cpp	…
screenedge.h	…
screenlockerwatcher.cpp	…
screenlockerwatcher.h	…
screens.cpp	Prevent unused variable warnings when building for tests	4 years ago
screens.h	…
service_utils.cpp	…
service_utils.h	…
settings.kcfgc	…
shadow.cpp	…
shadow.h	…
shortcutdialog.ui	…
sm.cpp	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
sm.h	…
subsurfacemonitor.cpp	…
subsurfacemonitor.h	…
syncalarmx11filter.cpp	…
syncalarmx11filter.h	…
tablet_input.cpp	…
tablet_input.h	tablet_v2: Use libinput device groups to deduce the device's tablet	4 years ago
tabletmodemanager.cpp	…
tabletmodemanager.h	…
thumbnailitem.cpp	…
thumbnailitem.h	…
toplevel.cpp	Simplify Toplevel::addRepaintFull()	4 years ago
toplevel.h	…
touch_hide_cursor_spy.cpp	…
touch_hide_cursor_spy.h	…
touch_input.cpp	Process TOUCH_CANCEL events from libinput individually	4 years ago
touch_input.h	Add test for TouchInputRedirection::m_touches	4 years ago
udev.cpp	…
udev.h	…
unmanaged.cpp	…
unmanaged.h	…
useractions.cpp	…
useractions.h	…
utils.cpp	Lower default severity of logging categories	4 years ago
utils.h	…
virtual_terminal.cpp	…
virtual_terminal.h	…
virtualdesktops.cpp	…
virtualdesktops.h	…
virtualdesktopsdbustypes.cpp	…
virtualdesktopsdbustypes.h	…
virtualkeyboard_dbus.cpp	…
virtualkeyboard_dbus.h	…
was_user_interaction_x11_filter.cpp	…
was_user_interaction_x11_filter.h	…
wayland_server.cpp	…
wayland_server.h	…
waylandclient.cpp	…
waylandclient.h	…
waylandshellintegration.cpp	…
waylandshellintegration.h	…
window_property_notify_x11_filter.cpp	…
window_property_notify_x11_filter.h	…
workspace.cpp	wayland: Prevent snapping normal windows to notifications and OSDs	4 years ago
workspace.h	…
x11client.cpp	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
x11client.h	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
x11eventfilter.cpp	…
x11eventfilter.h	…
xcbutils.cpp	…
xcbutils.h	…
xcursortheme.cpp	…
xcursortheme.h	…
xdgshellclient.cpp	wayland: Update decoration on surface commit	4 years ago
xdgshellclient.h	Fix fullscreen moveresize and set geometry restore to the screen a fullscreen client gets moved to	4 years ago
xdgshellintegration.cpp	…
xdgshellintegration.h	…
xkb.cpp	Lower default severity of logging categories	4 years ago
xkb.h	fix: KeyboardLayoutTest fails on updated DBus API	4 years ago
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.