Files
komorebi/docs/usage/floating-windows.md
T
LGUG2Z 331db681e2 feat(wm): stack out of sight on a parking desktop
A container has one tile, so the windows of a stack that are not in front have
to be out of sight. KWin has nothing a script can set to hide a window except a
virtual desktop nobody looks at, which the first spike measured to cost no focus
change where minimizing a window cost two. Backend::hide takes a window out of
sight and Backend::restore brings it back; the KWin backend parks the window on
a desktop named komorebi-park, which the table keeps out of the workspaces, and
remembers where each hidden window came from so that it is still on its
workspace.

KWin saves a desktop in kwinrc as soon as it is made, so komorebi removes the
parking desktop when it stops, after the windows are back, and the first
snapshot of the next run finds one a killed run left, sends its windows home and
removes it. The windows komorebi hid are recorded, so that a minimize the
compositor reports for one is not mistaken for the user's.

komorebic stack, unstack, stack-all and unstack-all stack and unstack windows.
The window container behavior and the float override decide whether a window
that opens joins the focused container or floats, for every workspace or for
one. vm-stacks stacks windows in a headless KWin, shows a workspace and goes
back, stops, and kills the daemon with a window parked.
2026-10-28 07:20:37 -07:00

1.3 KiB

Floating windows

A floating window is one of a workspace's windows that is not in its layout: komorebi gives it no tile and does not move it, and it stays where it is put by hand.

komorebic toggle-float takes the window that has the focus out of the layout, and the other windows of the workspace share the work area. The same command on a floating window puts it back in the layout, at the place of the focused window.

komorebic toggle-float

A floated window keeps its size and position by default. The floating windows of a workspace are in the daemon's state as floating_windows, next to its containers.

Windows that open floating

With the float override on, every window that opens floats instead of getting a tile. komorebic toggle-float-override turns it on and off for every workspace, and komorebic toggle-workspace-float-override for the focused workspace only: the first time it takes the opposite of what every workspace has, and from then on it follows its own setting.

komorebic toggle-float-override
komorebic toggle-workspace-float-override

The override is in the daemon's state, as float_override for every workspace and in each workspace that has one of its own.