Skip to content

Tessa 0.2.4

Latest

Choose a tag to compare

@Keychrom Keychrom released this 31 Oct 16:57
· 105 commits to main since this release

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 offline tessa --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, IPC HELLO/VERSION/CAPABILITIES negotiation, 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=true builds compile; the scenefx performance test
    passes.
  • tests/fuzz-parsers.sh and tests/fuzz-asan.sh pass. 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.deb

The 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