All versions since v1.0.20
v1.0.20
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.19...v1.0.20
Aqueous v1.0.21
Keep Rendering, and VRR Off by Default
Aqueous v1.0.21 adds the keep_render window rule so games and other callback-driven clients keep rendering while hidden, and stops outputs from inheriting VRR state left behind by firmware or a previous compositor.
๐ฎ New keep_render window rule
[[window]]app_id = "steam_app_*" # or class = "..." for Xwaylandkeep_render = true- ~60 Hz hidden pacing โ a single global compositor timer (16 ms) keeps frame callbacks flowing while the window is hidden: inactive workspace, minimized, overview-hidden, output powered off / soft-disabled / unplugged, or session locked or inactive. Pacing is independent of the panel refresh rate, and the timer only runs while a kept mapped window exists.
- No suspension โ kept windows never receive the xdg-toplevel
suspendedstate, so cooperative clients keep rendering instead of throttling to zero. Removing the rule restores normal suspension on the next manage cycle. - Callbacks only, not visibility โ scene nodes stay disabled: the window is never composited and gains no screencopy, mirror, overview-deck or overlay-plane eligibility. Only the root surface receives callbacks (popups/subsurfaces do not, matching the existing overview path).
- No double pacing โ visible windows on live outputs stay scene-paced at the output rate; the overview deck also skips kept windows so they are never driven at refresh rate plus 60 Hz.
- Rule semantics โ managed scope only;
keep_renderon anoverride_redirectrule rejects the whole reload atomically. It is a client-buffer effect, socontent_type = "game"rules keep it while still dropping placement edits. First-match-wins and reload clearing behave like other effects. - FIFO cap unchanged โ hidden FIFO clients remain throttled to 40 Hz by the patched wlroots pacing, so a kept FIFO client is effectively capped at ~40 fps.
- Cost warning โ kept clients render continuously by design, including while locked or with all outputs off. Scope matchers narrowly (e.g. one Steam app id).
- Settings support โ the settings backend schema recognizes
keep_renderas a boolean rule effect. - Coverage โ new
compositor/scripts/test-keep-render.pyintegration suite, rule-engine/config unit tests, and full documentation indocs/rules.mdandrules.toml.example.
๐ฅ๏ธ Adaptive sync (VRR) off by default
- Outputs no longer inherit
adaptive_syncfrom the hardware state left enabled by firmware or a previous compositor. VRR is now opt-in per output withadaptive_sync = true;wm.tomlandoutputs.tomlcomments document the new default.
๐ Upgrade notes
- If you relied on VRR being inherited from hardware state, set
adaptive_sync = trueon each output where you want it. keep_renderis opt-in per rule and costs GPU power and battery while active; hidden FIFO clients stay capped at 40 Hz.
v1.0.22 Latest
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.21...v1.0.22
