My KWIN fork where I work on features like per-output virtual desktops
Find a file
Nate Graham cc862fa674 [focuschain/task switcher] Remove special handling for minimized windows
Right now KWin moves minimized windows to the end of the task switcher's
ordering. However this is a rather confusing and undocumented behavior
that explicitly overrides the user's chosen sort ordering, be it
"Recently used" or "Stacking order". This makes it a hidden magic behavior
of the type that is at risk of being more annoying than useful.

This commit removes the special handling and lets minimized windows live
in the appropriate order in the task switcher.
2020-08-05 14:05:01 +00:00
3rdparty Synchronize xcursor.c 2020-07-27 15:00:13 +00:00
autotests Introduce X11 default screen property in Application 2020-08-05 08:48:00 +00:00
cmake/modules Add Findepoll.cmake 2020-06-05 12:41:24 +02:00
colorcorrection Revert "[kcm/effects] Clip ListView" 2020-02-22 11:53:59 +01:00
data screencast: Address minor issues 2020-07-28 18:38:49 +00:00
decorations [decorations] Fix rendering for depth 30 (10bpc) 2020-07-10 13:08:53 +00:00
doc Change CommandAllKey to Meta 2020-05-22 22:39:08 -04:00
effects Expose transientFor and only blur underneath when transientParent is dock 2020-08-02 10:25:28 +00:00
helpers
kcmkwin SVN_SILENT made messages (.desktop file) - always resolve ours 2020-07-28 06:11:46 +02:00
kconf_update [kwinrules] Add kconf_update script to fix placement rule 2020-05-27 18:13:00 +00:00
libinput Wayland: Allow to set a scroll Factor for input devices 2020-04-07 19:08:49 +02:00
libkwineffects Introduce X11 default screen property in Application 2020-08-05 08:48:00 +00:00
platformsupport screencasting: Expose necessary information to implement efficient screencasting 2020-07-23 13:14:22 +02:00
plugins Fix clipped shadows on useraction menus, when wayland and desktop scaling is enabled. 2020-08-05 11:54:54 +00:00
qml [virtualkeyboard] Fix the qtvirtualkeyboard with Qt 5.15 2020-07-14 14:40:11 +05:30
screencast screencast: Don't include platformsupport headers 2020-07-28 21:50:26 +03:00
scripting Emit clientAdded for wayland clients 2020-07-27 15:01:07 +00:00
scripts SVN_SILENT made messages (.desktop file) - always resolve ours 2020-07-28 06:11:46 +02:00
tabbox SVN_SILENT made messages (.desktop file) - always resolve ours 2020-07-23 06:10:20 +02:00
tests Remove orientation sensor 2020-02-29 09:59:30 +05:30
xwl Port Xwayland data bridge to xcbutils 2020-08-05 08:48:00 +00:00
abstract_client.cpp [focuschain/task switcher] Remove special handling for minimized windows 2020-08-05 14:05:01 +00:00
abstract_client.h Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
abstract_opengl_context_attribute_builder.cpp
abstract_opengl_context_attribute_builder.h
abstract_output.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
abstract_output.h screencasting: Expose necessary information to implement efficient screencasting 2020-07-23 13:14:22 +02:00
abstract_wayland_output.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
abstract_wayland_output.h screencasting: Expose necessary information to implement efficient screencasting 2020-07-23 13:14:22 +02:00
activation.cpp Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
activities.cpp Store normal clients and desktop clients in the same list 2020-05-14 16:21:47 +03:00
activities.h Rename Client to X11Client 2019-09-25 21:11:37 +03:00
appmenu.cpp Rename Client to X11Client 2019-09-25 21:11:37 +03:00
appmenu.h
atoms.cpp [x11] Add support for _GTK_FRAME_EXTENTS 2019-11-27 14:12:30 +02:00
atoms.h [x11] Add support for _GTK_FRAME_EXTENTS 2019-11-27 14:12:30 +02:00
client_machine.cpp
client_machine.h
CMakeLists.txt Lower message severity for KWIN_XWL 2020-08-05 08:48:00 +00:00
composite.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
composite.h Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
config-kwin.h.cmake Only define PipeWire_FOUND if it's found 2020-07-24 02:06:45 +02:00
COPYING
cursor.cpp Move inputConfig away from KWin::Application 2020-07-13 12:54:34 +02:00
cursor.h Move inputConfig away from KWin::Application 2020-07-13 12:54:34 +02:00
dbusinterface.cpp
dbusinterface.h
debug_console.cpp Emit clientAdded for wayland clients 2020-07-27 15:01:07 +00:00
debug_console.h Emit clientAdded for wayland clients 2020-07-27 15:01:07 +00:00
debug_console.ui
deleted.cpp Introduce the client geometry in Toplevel 2020-06-18 07:40:58 +00:00
deleted.h Introduce the client geometry in Toplevel 2020-06-18 07:40:58 +00:00
dmabuftexture.cpp screencasting: integrate zkde_screencast_unstable_v1 2020-07-23 13:14:22 +02:00
dmabuftexture.h screencasting: integrate zkde_screencast_unstable_v1 2020-07-23 13:14:22 +02:00
effectloader.cpp
effectloader.h
effects.cpp Expose transientFor and only blur underneath when transientParent is dock 2020-08-02 10:25:28 +00:00
effects.h Expose transientFor and only blur underneath when transientParent is dock 2020-08-02 10:25:28 +00:00
egl_context_attribute_builder.cpp
egl_context_attribute_builder.h
events.cpp Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
fixqopengl.h
focuschain.cpp [focuschain/task switcher] Remove special handling for minimized windows 2020-08-05 14:05:01 +00:00
focuschain.h [focuschain/task switcher] Remove special handling for minimized windows 2020-08-05 14:05:01 +00:00
geometrytip.cpp
geometrytip.h
gestures.cpp Discard sub-pixel movements in gestures 2020-08-04 13:52:16 +00:00
gestures.h
globalshortcuts.cpp
globalshortcuts.h
group.cpp Split group.cpp topic file 2019-12-03 19:43:47 +02:00
group.h Drop some custom list typedefs 2019-11-27 15:54:08 +02:00
HACKING.md Revert "[kcm/effects] Clip ListView" 2020-02-22 11:53:59 +01:00
idle_inhibition.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
idle_inhibition.h Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
input.cpp Move inputConfig away from KWin::Application 2020-07-13 12:54:34 +02:00
input.h Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
input_event.cpp Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
input_event.h Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
input_event_spy.cpp Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
input_event_spy.h Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
internal_client.cpp Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
internal_client.h Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
keyboard_input.cpp Move inputConfig away from KWin::Application 2020-07-13 12:54:34 +02:00
keyboard_input.h
keyboard_layout.cpp make keyboard layout DBus API more reliable 2020-07-17 12:42:28 +00:00
keyboard_layout.h
keyboard_layout_switching.cpp save default keyboard layout 2020-07-17 12:42:28 +00:00
keyboard_layout_switching.h save default keyboard layout 2020-07-17 12:42:28 +00:00
keyboard_repeat.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
keyboard_repeat.h
killwindow.cpp
killwindow.h
kwin.kcfg Change CommandAllKey to Meta 2020-05-22 22:39:08 -04:00
kwin.notifyrc SVN_SILENT made messages (.desktop file) - always resolve ours 2020-07-23 06:10:20 +02:00
kwinbindings.cpp
KWinDBusInterfaceConfig.cmake.in
layers.cpp Store normal clients and desktop clients in the same list 2020-05-14 16:21:47 +03:00
linux_dmabuf.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
linux_dmabuf.h Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
logind.cpp
logind.h
logo.png GIT_SILENT: add KWin icon as repository logo 2020-05-20 12:47:52 +00:00
main.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
main.h Introduce X11 default screen property in Application 2020-08-05 08:48:00 +00:00
main_wayland.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
main_wayland.h
main_x11.cpp Introduce X11 default screen property in Application 2020-08-05 08:48:00 +00:00
main_x11.h
Mainpage.dox
Messages.sh Extract messages from cpp files in colorcorrection/ 2020-01-12 21:24:17 +02:00
modifier_only_shortcuts.cpp Add support to keyboard shortcuts inhibitor 2020-05-29 08:49:11 +00:00
modifier_only_shortcuts.h
moving_client_x11_filter.cpp Rename Client to X11Client 2019-09-25 21:11:37 +03:00
moving_client_x11_filter.h
netinfo.cpp [x11] Add support for _GTK_FRAME_EXTENTS 2019-11-27 14:12:30 +02:00
netinfo.h Rename Client to X11Client 2019-09-25 21:11:37 +03:00
onscreennotification.cpp Move from Quad to Cubic 2020-03-04 19:40:35 +01:00
onscreennotification.h
options.cpp Change CommandAllKey to Meta 2020-05-22 22:39:08 -04:00
options.h [x11] Hold a passive grab on buttons only when needed 2020-06-24 13:48:54 +00:00
org.kde.kappmenu.xml
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
org.kde.kwin.Effects.xml
org.kde.KWin.Session.xml Remove QSessionManager usage 2020-04-06 11:51:47 +02:00
org.kde.KWin.VirtualDesktopManager.xml
org.kde.KWin.xml
osd.cpp
osd.h
outline.cpp
outline.h
outputscreens.cpp Associate output transforms and orientations 2019-11-26 22:29:40 +01:00
outputscreens.h Associate output transforms and orientations 2019-11-26 22:29:40 +01:00
overlaywindow.cpp
overlaywindow.h
placement.cpp Allow corner-tiling by quickly combining edge tiling shortcuts 2020-06-12 13:50:24 +00:00
placement.h
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 Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
platform.h screencasting: integrate zkde_screencast_unstable_v1 2020-07-23 13:14:22 +02:00
pointer_input.cpp Emit clientAdded for wayland clients 2020-07-27 15:01:07 +00:00
pointer_input.h Fix build with loadThemeCursor templates 2020-06-22 16:51:38 +01:00
popup_input_filter.cpp Emit clientAdded for wayland clients 2020-07-27 15:01:07 +00:00
popup_input_filter.h Use AbstractClient instead of XdgShellClient wherever possible 2020-03-04 09:57:13 +02:00
README.md Capstone commit to prevent force push reversed commits returning accidentally. 2020-06-03 09:54:00 +00:00
rootinfo_filter.cpp
rootinfo_filter.h
rulebooksettings.cpp Port kwinrules kcm to kconfigxt 2020-03-16 13:21:43 +01:00
rulebooksettings.h Port kwinrules kcm to kconfigxt 2020-03-16 13:21:43 +01: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 Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
rules.h Survive Xwayland crashes 2020-08-05 08:48:00 +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 screencasting: Expose necessary information to implement efficient screencasting 2020-07-23 13:14:22 +02:00
scene.h screencasting: Expose necessary information to implement efficient screencasting 2020-07-23 13:14:22 +02:00
screenedge.cpp The old behavior before D28224 was (X + Y) instead of (X + X) 2020-06-24 06:54:44 +00:00
screenedge.h
screenlockerwatcher.cpp
screenlockerwatcher.h
screens.cpp Make it possible to have a separate cursor for the tablet 2020-04-03 01:16:45 +02:00
screens.h Improve tests behaviour on set ups with high dpi 2020-03-24 00:16:04 +01:00
service_utils.cpp ScreenshotEffect: Use Service Property to authorize screenshot without confirmation 2020-06-16 19:00:04 +02:00
service_utils.h ScreenshotEffect: Use Service Property to authorize screenshot without confirmation 2020-06-16 19:00:04 +02:00
settings.kcfgc
shadow.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
shadow.h Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
shortcutdialog.ui
sm.cpp Remove QSessionManager usage 2020-04-06 11:51:47 +02:00
sm.h Remove QSessionManager usage 2020-04-06 11:51:47 +02:00
subsurfacemonitor.cpp [scene] Discard pixmaps on buffer size change 2020-07-01 09:43:27 +00:00
subsurfacemonitor.h [scene] Discard pixmaps on buffer size change 2020-07-01 09:43:27 +00:00
syncalarmx11filter.cpp [x11] Enable synchronized resizing for Xwayland clients 2020-04-29 16:37:23 +03:00
syncalarmx11filter.h [x11] Enable synchronized resizing for Xwayland clients 2020-04-29 16:37:23 +03:00
tablet_input.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
tablet_input.h Implement the tablet wayland protocol in kwin 2020-03-20 03:05:41 +01:00
tabletmodemanager.cpp Fix the tablet mode manager 2020-03-11 13:06:57 +05:30
tabletmodemanager.h
TESTING.md
thumbnailitem.cpp Use AbstractClient instead of XdgShellClient wherever possible 2020-03-04 09:57:13 +02:00
thumbnailitem.h
toplevel.cpp Update input transformation matrix when buffer geometry changes 2020-07-17 11:56:22 +00:00
toplevel.h Update input transformation matrix when buffer geometry changes 2020-07-17 11:56:22 +00:00
touch_hide_cursor_spy.cpp
touch_hide_cursor_spy.h
touch_input.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
touch_input.h
udev.cpp Handle differences in paths for Linux vs FreeBSD 2020-06-05 12:41:28 +02:00
udev.h
unmanaged.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
unmanaged.h Add a simple test to check Xwayland dying 2020-08-05 08:48:00 +00:00
useractions.cpp When maximizing a window raise client and gain focus 2020-07-27 09:26:25 +00:00
useractions.h Rename Client to X11Client 2019-09-25 21:11:37 +03:00
utils.cpp Reduce the amount of objects that are compiled several times 2020-04-02 00:41:55 +02:00
utils.h Reduce the amount of objects that are compiled several times 2020-04-02 00:41:55 +02:00
virtual_terminal.cpp Handle differences in paths for Linux vs FreeBSD 2020-06-05 12:41:28 +02:00
virtual_terminal.h
virtualdesktops.cpp [virtualdekstops] Drop multi-head from VirtualDesktopManagement 2020-07-23 22:33:14 +00:00
virtualdesktops.h Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
virtualdesktopsdbustypes.cpp
virtualdesktopsdbustypes.h
virtualkeyboard.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
virtualkeyboard.h
virtualkeyboard_dbus.cpp
virtualkeyboard_dbus.h
was_user_interaction_x11_filter.cpp
was_user_interaction_x11_filter.h
wayland_server.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
wayland_server.h Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
waylandclient.cpp [wayland] Rework xdg-shell implementation 2020-06-01 15:12:59 +03:00
waylandclient.h [wayland] Rework xdg-shell implementation 2020-06-01 15:12:59 +03:00
waylandshellintegration.cpp [wayland] Destroy XdgToplevelClient and XdgPopupClient on unmap 2020-06-01 15:13:03 +03:00
waylandshellintegration.h [wayland] Destroy XdgToplevelClient and XdgPopupClient on unmap 2020-06-01 15:13:03 +03:00
waylandxdgshellintegration.cpp Start accepting client connections after creating workspace 2020-07-17 09:10:51 +00:00
waylandxdgshellintegration.h [wayland] Destroy XdgToplevelClient and XdgPopupClient on unmap 2020-06-01 15:13:03 +03:00
window_property_notify_x11_filter.cpp Rename Client to X11Client 2019-09-25 21:11:37 +03:00
window_property_notify_x11_filter.h
workspace.cpp Introduce X11 default screen property in Application 2020-08-05 08:48:00 +00:00
workspace.h Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
x11client.cpp Survive Xwayland crashes 2020-08-05 08:48:00 +00:00
x11client.h Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
x11eventfilter.cpp
x11eventfilter.h
xcbutils.cpp Port Xwayland data bridge to xcbutils 2020-08-05 08:48:00 +00:00
xcbutils.h Port Xwayland data bridge to xcbutils 2020-08-05 08:48:00 +00:00
xcursortheme.cpp Provide hotspot in the device independent pixels 2020-07-27 15:00:13 +00:00
xcursortheme.h Provide hotspot in the device independent pixels 2020-07-27 15:00:13 +00:00
xdgshellclient.cpp make the panelAutoHideHideRequested callback also handle panels set to "windows can cover" 2020-07-29 11:25:43 +00:00
xdgshellclient.h Check if we successfully restored input focus 2020-07-22 12:29:41 +00:00
xkb.cpp Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
xkb.h Port KWin to KWaylandServer 2020-04-30 12:56:08 +02:00
xkb_qt_mapping.h Set Qt::KeypadModifier depending on current keysym 2019-12-30 14:41:26 +01:00
xwaylandclient.cpp [x11] Disable synchronized resizing for Xwayland < 1.21 2020-04-29 16:37:31 +03:00
xwaylandclient.h [x11] Disable synchronized resizing for Xwayland < 1.21 2020-04-29 16:37:31 +03: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.