All versions since v1.0.2
v1.0.2
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.1...v1.0.2
v1.0.3
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.2...v1.0.3
v1.0.4
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.3...v1.0.4
v1.0.5
What’s Changed
- Focus-aware tiling by @arighi in https://github.com/Seafoam-Labs/Aqueous/pull/91
- Rotate built-in panels mounted sideways by default by @arighi in https://github.com/Seafoam-Labs/Aqueous/pull/88
- Let directional focus cross workspaces by @arighi in https://github.com/Seafoam-Labs/Aqueous/pull/93
- fix window rounding to be sized around actual window by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/94
- Xwayland scaling by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/100
- display configure update by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/101
New Contributors
- @arighi made their first contribution in https://github.com/Seafoam-Labs/Aqueous/pull/91
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.4...v1.0.5
v1.0.6
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.5...v1.0.6
v1.0.7
Fixed a bunch of memory leaks. Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.6...v1.0.7
v1.0.8
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.7...v1.0.8
v1.0.9
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.8...v1.0.9
v1.0.10
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.9...v1.0.10
v1.0.11
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.10...v1.0.11
v1.0.12
What’s Changed
- 111 raise on focus does not engage in floating mode by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/113
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.11...v1.0.12
v1.0.13
What’s Changed
- bumping zig version to 0.17 by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/120
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.12...v1.0.13
v1.0.14
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.13...v1.0.14
v1.0.15
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.14...v1.0.15
v1.0.16
What’s Changed
- fixed dwindle overflow by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/121
- added patch 0039 to adjust fifo pacing when occluded by @ZoeyErinBauer in https://github.com/Seafoam-Labs/Aqueous/pull/122
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.15...v1.0.16
v1.0.17
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.16...v1.0.17
v1.0.18
Fixed most of the biggest memory issues
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.17...v1.0.18
v1.0.19
🌊 Aqueous v1.0.19 — HDR Color, Live Slides, and Smarter Windows
Aqueous v1.0.19 is a color and motion release. HDR capture and Windows scRGB content arrive alongside a new 600-nit HDR preset, workspace and scrolling slides now move live client content, and window rules gain Once and Startup matching. Scrolling columns learn new placement options, output selection follows the pointer, and a batch of drag, focus, transition, and overflow fixes tightens the edges.
🌈 HDR and color management
- 🌕 600-nit HDR preset —
hdr_level = "600"joins 100, 400, and 1000. Automatic selection now chooses 100 up to 250 nits, 400 up to 500, 600 up to 800, and 1000 above that. - 🎥 HDR capture metadata — capture protocol
aqueous_capture-color-v1is now version 2. Sessions advertise per-format encoding, and the portal publishes PipeWiretransferFunctionandcolorPrimariesfor every offered format: SMPTE 2084/BT.2020 for native PQ, gamma 2.2/BT.709 for SDR and converted 8-bit output. - 🖼️ 8-bit destinations from PQ outputs — PQ output frames copied to 8-bit SHM or DMA-BUF destinations are decoded to SDR with BT.2020 mapped to sRGB. Native and 10-bit destinations keep their source encoding.
- 🪟 Windows scRGB snapshots — snapshot buffers now carry the fixed Windows-scRGB mapping (1.0 = 80 cd/m²), so live slides and other snapshot-based transitions match their source regardless of the SDR-white setting. This uses private wlroots patch 0043.
- 🔬 Extended target volume — Aqueous advertises
extended_target_volumeon its scRGB-capable Vulkan path, letting Mesa’s Wayland WSI enumerateVK_COLOR_SPACE_EXTENDED_SRGB_LINEAR_EXTfor Proton and Wine HDR. It does not change the fixed 80-nit predefined mapping. (#130)
🎞️ Live workspace and scrolling slides
Workspace and scrolling slides now display live client content while input geometry stays at its settled destination. (#133)
- 🎬 Live content in motion — preview callbacks, presentation, and captured explicit-sync lifetimes come from private wlroots patch 0045, with callback-paced content through transitions and reversals.
- 🧯 One-frame flash fixed — outgoing workspace trees are now disabled before the transition clears
prev_workspace, so finalizing a swap on one output can no longer flash the previous workspace on a neighboring output. (#106) - 🧪 More stress coverage — added probes for buffer retention and Xwayland resize churn alongside the live-slide harness.
🧩 Window rules
- ⏱️ Matching timing — new
matchingfield withalways,once, andstartupmodes (plus aliases). Aoncerule stays bound to the first window that claims it across title, tag, and content-type changes and survives hot reloads until its matcher is edited;startupapplies during the first 10 seconds after compositor startup. - 🛠️ Settings rule editor — Pearl exposes Matching timing as a first-class rule field with native edit, save, and reopen coverage.
- 🪟 Portal picker stays floating — the portal picker is now forced floating so it cannot be tiled. (#129)
🖱️ Focus, drag, and window switcher
- 🖱️ Pointer selects the output — physical pointer motion makes the output under the cursor the target for output, workspace, and window actions without enabling focus-follows-mouse. Hovering an empty output no longer steals keyboard focus.
- ↔️ Corner-aware resize — floating resize drags hit-test the pointer quadrant so the corner opposite the pointer stays anchored.
- ⌨️ Switcher commits on release — releasing the initiating modifier finishes the window switcher immediately. Shift is ignored so a reverse-cycle chord can release Shift without ending the presentation.
- 🍷 Wine/Wayland input fix — Xwayland focus and grab resync paths now skip redundant text-input focus calls when the target surface is already focused, avoiding an assertion that interrupted Wine sessions.
🧭 Layout and scrolling
- 📐 New window placement —
new_window_positionsupportsappend,right,left,above, andbelow. The deprecatedopen_new_windows_to_rightboolean still works and mapstruetorightandfalsetoappend; if both keys appear, the later one wins. - 👀 Vertical arrivals stay visible —
aboveandbelowarrivals pan within their column. - 🔲 Themeable snap zones — snap-zone preview colors now derive from the configured window border colors.
- 🧮 Overflow floor fixed — dwindle and reverse-dwindle minimum content size is now
max(client minimum, 320 x 200)logical pixels instead of scaling with output size, so larger displays fit more tiles instead of stretching a fixed handful.
🧰 Configuration and packaging
- 📄 Seeded templates —
input.tomlandlayout.tomlare packaged as inert, fully commented templates and copied to~/.config/aqueouson first login only when missing. The layout seed is skipped when$AQUEOUS_LAYOUTor an active[layout].pathis set. - 💾 Backups — both templates are included in package backup lists, and Gentoo installation seeds them too.
- 📏 Top strut default — the shipped
wm.tomlno longer adds a 32 px top strut on top of layer-shell exclusive zones. - ⚠️ Read-only default warning — Settings now warns when edits resolve to system defaults that the helper must refuse to write.
- 🌕 HDR 600 in configuration —
outputs.toml, display schemas, and the display preview include the 600-nit option.
🧪 Build and test updates
- 🧱 LLVM test steps — the GpuPin and ToplevelIcon test steps now receive
-Dllvm. (#115) - 🧪 New headless coverage — live-slide transitions, scRGB snapshots, Proton HDR color management, workspace transition finalization, and snapshot color checks.
- 🩹 Assertion fixes — cleaned up extra assertions in the test suite.
- 🧷 Private wlroots patches — the build hook and Nix packaging pin patches 0043, 0044, and 0045; rebuild the patched wlroots dependency before testing HDR or live slides.
🚀 Upgrade notes
open_new_windows_to_right is deprecated. Use new_window_position; true maps to right and false maps to append, so existing configurations keep working.
The first login seeds input.toml and layout.toml only when they are absent. Existing files are left alone, and the layout template is not seeded when an explicit sidecar is configured.
HDR 600 is opt-in through hdr_level = "600". Automatic selection chooses it for panels whose peak falls between 501 and 800 nits.
Capture clients should request frame information before capture. The portal handles the new session description, but 8-bit captures from PQ outputs will be delivered as SDR.
❤️ Thanks
❤️ Thanks to Kode54 for the scRGB fix and test tooling, and to everyone who tested HDR capture, live slides, and the new rule timing.
📋 Full Changelog: v1.0.18…8639e2c
🔀 Release commit: 8639e2c
v1.0.20
Full Changelog: https://github.com/Seafoam-Labs/Aqueous/compare/v1.0.19...v1.0.20
Aqueous v1.0.21 Latest
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.
