Skip to content

Aqueous Changelog

Version 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 Xwayland
keep_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 suspended state, 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_render on an override_redirect rule rejects the whole reload atomically. It is a client-buffer effect, so content_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_render as a boolean rule effect.
  • Coverage โ€” new compositor/scripts/test-keep-render.py integration suite, rule-engine/config unit tests, and full documentation in docs/rules.md and rules.toml.example.

๐Ÿ–ฅ๏ธ Adaptive sync (VRR) off by default

  • Outputs no longer inherit adaptive_sync from the hardware state left enabled by firmware or a previous compositor. VRR is now opt-in per output with adaptive_sync = true; wm.toml and outputs.toml comments document the new default.

๐Ÿš€ Upgrade notes

  • If you relied on VRR being inherited from hardware state, set adaptive_sync = true on each output where you want it.
  • keep_render is opt-in per rule and costs GPU power and battery while active; hidden FIFO clients stay capped at 40 Hz.
ยฉ 2026 Seafoam LabsShelly Chel