monolith

Test checklist for M5 to M7

Everything below landed while you were away and was only smoke-tested nested. Bare metal, multi-monitor and real apps are still unverified.

Build and run from the repo root in nushell.

nix develop -c cargo build --release -p monolith
nix develop -c sh -c 'RUST_LOG=monolith=debug target/release/monolith run --backend drm 2> monolith.log'

M5

• VRR. The log line output connected should say vrr_capable=true for DP-2. Fullscreen vkcube and look for adaptive sync vrr=true, and check the monitor’s OSD shows a varying refresh rate. Leaving fullscreen should log vrr=false. The default is [output] vrr = "fullscreen", and "on" and "off" also work.
• VRR cursor cap. With a fullscreen game below 165 fps, moving the mouse should not push the refresh rate up. Cursor-only frames are capped at 60 Hz.
• Hotplug, a second monitor and the Intel pass, still open from before.

M6

• layer-shell. waybar reserves its strip and tiles stay clear of it. A fullscreen window covers it. Its workspaces module should list the tags through ext-workspace.
• Launchers. fuzzel takes the keyboard while open and gives it back on close. The launched app should land on the tag you were on when you launched it.
• Session lock. swaylock hides everything, takes input and unlocks with your password. VT switching still works while locked. Killing swaylock leaves the session locked, which is what the protocol wants. Unlock it by starting swaylock again from a VT.
• Idle. swayidle -w timeout 10 'notify-send idle' fires after 10 s without input. A playing mpv should hold it off while visible and stop holding it off once its tag is hidden.
• Clipboard. wl-copy and wl-paste work both ways with foot or beer. Middle-click paste uses the primary selection.
• Screenshots. grim and grim -g (slurp).
• Portals. Needs xdg-desktop-portal-wlr installed and monolith’s package in your profile so share/xdg-desktop-portal/monolith-portals.conf is found. Screen sharing a whole output from a browser should work. Window sharing does not exist yet.
• Xwayland. Run an X app, like xeyes, Steam or a Proton game. The log shows starting Xwayland on its first connection. Check keyboard input, fullscreen and menu placement. Dialogs should float. After the last X client closes, Xwayland exits and should start again for the next one.
• Activation. Launch something slow from fuzzel on tag 2, switch to tag 3 before it appears. It should land on tag 2 and mark it urgent.

M7

• Submit stall. It used to drop one frame every 6.2 s at 165 Hz. With vkcube running, the frame rate debug lines should read 165 of 165 indefinitely, with no frame missed its vblank in steady state.
• vkcube black start. Is the half second of black at launch gone?
• Fullscreen switches. Toggle fullscreen on vkcube a few times and look for slow frame lines. First-time imports now run on a worker thread.
• Realtime, optional. SCHED_RR and the realtime Vulkan queue need CAP_SYS_NICE. To try them, wrap the binary with security.wrappers and capabilities = "cap_sys_nice+ep", then look for compositor thread runs SCHED_RR and queue global priority priority=Some(REALTIME). File capabilities make the loader ignore variables like VK_DRIVER_FILES.

Known

• Nested monolith stops redrawing when the host compositor stops sending it frame callbacks, for example while its window is hidden. Clients inside then freeze until it is shown again.
• See parked.md for what is left over.