Files
komorebi/docs/usage/managing-windows.md
T
LGUG2Z 56294e1cd3 feat(wm): manage, minimize and close
Every normal window KWin reports is tiled, and the only way to take one out of
the layout was to float it, which keeps it a window komorebi manages. `komorebic
unmanage` takes the focused window out of the layout, and komorebi leaves it
alone until `komorebic manage` takes it back or the window closes. Both are
events komorebi raises itself on the channel KWin's events go through, so they
are handled in order with what KWin reports. `komorebic minimize` and `close`
ask KWin to minimize or close the focused window, which leaves the layout when
KWin reports that it did.

`komorebic toggle-pause` pauses the daemon: it acts on no event, and takes only
`toggle-pause`, `state` and `stop` on its socket until it is resumed. With
`unmanaged-window-operation-behaviour no-op`, the daemon refuses every message
while the focused window is not one it tiles.

The vm-commands sweep pauses and resumes, sets the operation behavior, manages
and closes the focused window, and a section of its own minimizes, unmanages and
manages a window.
2026-10-28 07:20:37 -07:00

2.8 KiB

Managing windows

komorebi tiles every normal application window that KWin reports, and leaves dialogs, splash screens and other windows that are not for tiling alone. The commands here act on the window that has the focus in KWin, take a window out of the layout or back into it, and pause the daemon.

Minimizing and closing

komorebic minimize asks KWin to minimize the window that has the focus, and komorebic close asks it to close the window, as the buttons of its title bar do.

komorebic minimize
komorebic close

The window leaves the layout when KWin reports that it was minimized or closed, and the other windows of the workspace share the work area. A minimized window comes back into the layout, in a container of its own, when it is restored.

Taking a window out of the layout

komorebic unmanage takes the window that has the focus out of the layout. It stays open, in the middle of the work area with the size it had, and komorebi leaves it alone from then on: it does not tile it again, and it does not move it. komorebic manage, with that window focused, puts it back in the layout, after the focused window.

komorebic unmanage
komorebic manage

komorebic manage also takes in a window komorebi missed, such as one that opened while the daemon was paused. The daemon forgets an unmanaged window when it closes, and when the daemon stops.

Commands while the focused window is not tiled

By default, a command acts on the workspace whatever window has the focus. With komorebic unmanaged-window-operation-behaviour no-op, the daemon ignores every command while the window that has the focus is not one of the windows it tiles: a floating window, a window it does not manage, or one taken out with komorebic unmanage. The daemon logs "ignoring commands while active window is not managed by komorebi" for each.

komorebic unmanaged-window-operation-behaviour no-op
komorebic unmanaged-window-operation-behaviour op

The commands that are ignored include komorebic state, komorebic stop and the command that sets the behavior back to op: give the focus to a tiled window first.

Pausing

komorebic toggle-pause pauses the daemon, and the same command resumes it. While it is paused, komorebi does not act on what KWin reports, so it moves no window, and of its commands it carries out only toggle-pause, state and stop. The daemon's state says whether it is paused, as is_paused.

komorebic toggle-pause

What KWin reported while the daemon was paused is not acted on afterwards: a window that opened in the meantime is not tiled until it is managed with komorebic manage.