mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-16 05:41:16 +01:00
docs(kde): what the Plasma guest showed, and --probe-windows on KDE
This commit is contained in:
1 parent
bdd0a5593c
commit
df4e076e60
2 files changed
+19
-1
No files matched your search
+1
-1
@@ -162,7 +162,7 @@ KDE. What is written from the sources and has not been seen to work on a real Pl
|
||||
| komorebi's log | `~/.local/share/komorebi/komorebi_plaintext.log.<UTC date>`; the span of an event's handler is `handle_event` and of a command's `process_command` |
|
||||
| the program's own windows | left out of the video by a KWin window rule (`excludefromcapture`, forced for the window class `komorebi-recorder`), which `record` writes to `~/.config/kwinrulesrc` and has KWin read; komorebi is told to ignore them by their application id, `komorebic ignore-rule class komorebi-recorder`, run before the window exists. Whether KWin honours the rule for a screencast of an output is a check still to make (K3) |
|
||||
| the window's application id | the window's application id is `komorebi-recorder`, which is the `class` komorebi for KDE sees |
|
||||
| `--probe-windows` | Windows only |
|
||||
| `--probe-windows` | on by default, as on Windows: after each window event KWin is asked about the window (`org.kde.KWin.getWindowInfo`: the desktops it is on, minimized, its frame). komorebi's window is found by its class, title and frame through KWin's windows runner, because komorebi's ids are a count and not KWin's UUIDs. A window on a desktop that is not showing is `not visible`, one alone on `komorebi-park` is `cloaked` |
|
||||
| ghost tiles | found from the frames komorebi has in its state, as on a Mac (a window in front on a showing workspace that has no frame anyone can see). No rule is proposed for one: komorebi for KDE's rules are in its own repository |
|
||||
|
||||
komorebi for KDE's rules are checked against the log and the events of a running komorebi (`komorebi --fake-backend`, an
|
||||
|
||||
@@ -20,6 +20,24 @@ of WSLg (which has outputs and no screencast):
|
||||
- a made-up source of frames is written to an H.264 file, which the decoder reads back, at the size of the display and
|
||||
at an odd size.
|
||||
|
||||
And in the Plasma guest of komorebi for KDE (`nix run .#run-kde`, KWin 6.8.2, komorebi with windows, headless over ssh;
|
||||
the recorder from `nix build` runs in it, as the guest mounts the host's store):
|
||||
|
||||
- **K1:** `doctor` says `permitted: yes` and a recording works with no desktop file written. Whether KWin offers the
|
||||
screencast to every program, or this guest's configuration allows it, was not found out.
|
||||
- **K2:** a recording of the output is a playable H.264 file with the windows, the panel and the cursor in it, and its
|
||||
length is the recording's. The frames' times were wrong at first (the GStreamer pipeline took the clock of the
|
||||
PipeWire stream, which starts at zero) and are on the master clock now. The log, the events and their handlers line up.
|
||||
- **K3:** the rule that leaves the recorder's window out of the capture works: a window of the class
|
||||
`komorebi-recorder` that had the focus and was on top is not in the video, and one of another class is. KWin 6.8
|
||||
rewrites `kwinrulesrc` with `Order=` in place of `count=` and `rules=`, and the recorder extends whichever the file has.
|
||||
- **`--probe-windows`:** a window of an event is found in KWin and its facts are read: frame, minimized, the desktops. The
|
||||
probes of a recording with workspace switches, a new window, a stack and a closed window agree with komorebi, and the
|
||||
one of a window that was closed says it no longer exists. komorebi's workspaces are KWin's virtual desktops, so a
|
||||
window of another workspace is not on the desktop that shows; the park desktop holds only windows hidden behind a
|
||||
front one. What was not seen: a probe that disagrees with komorebi (nothing was broken), and a window that cannot be
|
||||
told from another by class, title and frame (it has no probe).
|
||||
|
||||
## Getting the binary
|
||||
|
||||
```sh
|
||||
|
||||
Reference in new issue
Block a user