feat(wm): ignore, manage and float rules

komorebi managed every normal window that is alive, and there was no way to keep
an application out of the layout. The rule engine decides whether a window is
managed: an ignore rule keeps the windows it matches out, unless a manage rule
matches them too, and a float rule puts a window in the floating windows of its
workspace when it opens. A rule matches a window by its title, its executable,
its class or the path of its executable. Plasma's shell and KRunner are ignored
from the start.

`komorebic ignore-rule` and `manage-rule` add a rule, `session-float-rule`
floats the focused window and the windows like it until the daemon stops,
`clear-session-float-rules` removes those rules, and `global-state` shows the
rules. The `DebugWindow` message says why a window is managed or not.

Applications often open a window before they give it its title, so the bridge
now reports a title change, and a window komorebi does not have is asked about
again when its title changes, for a rule on the title to decide.

The vm-commands sweep adds and shows rules, and a section of its own checks that
a window an ignore rule matches by its first title is tiled once it has another.
vm-kwin-events checks that a window giving itself another title reaches the
daemon as a title update.
This commit is contained in:
LGUG2Z committed 2026-10-28 07:20:37 -07:00
1 parent c95be9391e
commit 1b10611022
32 files changed
+1755 -57

No files matched your search

+10
View File
@@ -0,0 +1,10 @@
```text
Clear all session float rules
Usage: clear-session-float-rules
Options:
-h, --help
Print help
```
+10
View File
@@ -0,0 +1,10 @@
```text
Show a JSON representation of the current global state
Usage: global-state
Options:
-h, --help
Print help
```
+21
View File
@@ -0,0 +1,21 @@
```text
Add a rule to ignore the specified application
Usage: ignore-rule <IDENTIFIER> <ID>
Arguments:
<IDENTIFIER>
Possible values:
- exe: Executable name
- class: Role or subrole
- title: Window title
- path: Executable path
<ID>
Identifier as a string
Options:
-h, --help
Print help (see a summary with '-h')
```
+21
View File
@@ -0,0 +1,21 @@
```text
Add a rule to always manage the specified application
Usage: manage-rule <IDENTIFIER> <ID>
Arguments:
<IDENTIFIER>
Possible values:
- exe: Executable name
- class: Role or subrole
- title: Window title
- path: Executable path
<ID>
Identifier as a string
Options:
-h, --help
Print help (see a summary with '-h')
```
+10
View File
@@ -0,0 +1,10 @@
```text
Add a rule to float the foreground window for the rest of this session
Usage: session-float-rule
Options:
-h, --help
Print help
```
+10
View File
@@ -0,0 +1,10 @@
```text
Show all session float rules
Usage: session-float-rules
Options:
-h, --help
Print help
```