Repository navigation
Tessa 0.2.4
Tessa 0.2.4 is the final planned .deb release built against Zig 0.16 and
wlroots 0.19, and it may be the last Debian package release. Subsequent
Tessa versions target Zig 0.17 and wlroots 0.20; source and Arch
packaging continue after that transition.
This release rolls up the customization work through the 0.7 roadmap and the
first reliability-focused 1.0 work.
Highlights
- Special workspaces: named hidden overlays independent of the scratchpad,
with rule assignment, toggle/move bindings, IPC control, and per-output
visibility. - Shell v2: composable bar modules and ordering, per-surface
bar/launcher/popover/toast fonts and colors, PPM wallpaper shader sources,
and layer-rule styling for the bar, popovers, and toasts. - Effect helper: a long-lived process protocol for per-window opacity,
corner radius, blur, shadow, and border-width overrides, with ID/range
validation, request coalescing, and fallback to rule visuals. - Config tooling:
tessa-ctl config-check,config-diff,config-edit,
and offlinetessa --check-config [file]. - Performance guardrails:
tessa-ctl perf,frame_time_budget, and
headless animation/full-effect benchmarks. - Reliability: pidfd-based built-in panel crash recovery with bounded
backoff, IPCHELLO/VERSION/CAPABILITIESnegotiation, strict 100 ms
layout / 200 ms effect helper timeouts, parser fuzzing, and an ASan runtime
pass. - Arch Linux validation: real eDP-1 DRM session, keyboard/mouse, IME, and
XWayland clients; touchpad tuning and VRR remain hardware-specific follow-ups.
Verification
- Full headless test suite passes, including the new panel recovery, IPC
version, helper timeout, fuzz, shell v2, effect helper, performance, and
config editor tests. - Plain and
-Dscenefx=truebuilds compile; the scenefx performance test
passes. tests/fuzz-parsers.shandtests/fuzz-asan.shpass. Zig 0.16 has no
compiler-level ASan instrumentation, so the ASan test is an allocator/
interceptor pass over the Debug-safety build.
Install (Ubuntu 26.04 amd64)
curl -fLO https://github.com/Keychrom/Tessa/releases/download/v0.2.4/tessa_0.2.4_amd64.deb
curl -fLO https://github.com/Keychrom/Tessa/releases/download/v0.2.4/SHA256SUMS
grep ' tessa_0.2.4_amd64.deb$' SHA256SUMS | sha256sum -c -
sudo apt install ./tessa_0.2.4_amd64.debThe binaries are unsigned; verify SHA256SUMS before installing.
Toolchain note
0.2.4 is the maintenance point for Zig 0.16 / wlroots 0.19. The next version
will update the build, packaging, CI, and compatibility matrix for Zig 0.17 and
wlroots 0.20. Users who need a newer toolchain after this release should build
from source or use the Arch package.
SHA-256:
4a4baabe05df23792294150eadf33ef8772bf87a98b7098135019b9bf0ee4486 tessa_0.2.4_amd64.deb