News

Release News

Previews in Motion

Halley v0.6.1 is a focused stability release for live Alt-Tab and Apogee previews, fullscreen restoration, mixed-refresh rendering, modal keyboard input, and rounded overlay clipping.

Halley v0.6.1 follows the rewrite with a tighter presentation path. Alt-Tab and Apogee now render mapped windows directly from their live surface trees, keeping previews current without repeatedly capturing full-window textures.

The patch also closes the first set of fullscreen, input, and damage-tracking regressions found after 0.6.0. The result is steadier motion across mixed-refresh outputs, more reliable restoration after rapid presentation changes, and cleaner overview cards.

Included

In This Release

Live surface-tree previews

Mapped Alt-Tab and Apogee entries render directly from client surface trees. Cached textures remain available for collapsed or temporarily unmapped windows.

Native output cadence

Every visible live preview follows its home output's presentation cadence, while mirrored Alt-Tab cards invalidate each output where they appear.

Smooth mixed-refresh overviews

Frame callbacks now reach every visible Alt-Tab entry instead of only the centered selection, removing lag from surrounding cards and mixed-refresh setups.

Reliable presentation restoration

Windowed and maximized restore endpoints survive client fullscreen, compositor fullscreen, maximize, and rapid repeated transitions.

Correct fullscreen state edges

Compositor-owned Mod+F stays protocol-windowed, allowing later client fullscreen requests to trigger the state change applications need to reflow nested content.

Cleaner translucent transitions

Fullscreen entry now blends translucent clients correctly even when they do not advertise opaque regions.

Fresh preview damage

Replacement preview textures receive new damage identities, preventing stale Apogee hover rectangles and square corruption.

Modal key releases fixed

Modifiers pressed before Apogee opens are released back to the client while intercepted key releases remain suppressed, preventing stuck modifiers after closing the overview.

Rounded preview clipping

Live and cached Alt-Tab, Apogee, and hover-preview content is clipped to the overlay card radius in output pixels.

glibc and musl portability

Ancillary socket-data length handling now compiles across glibc and musl by using platform field types and usize arithmetic.

Installation

Get v0.6.1

AUR

AUR 
yay -S halley
AUR 
yay -S halley-full
AUR 
yay -S halley-lift

Development Version

dev package 
yay -S halley-git

From Source

source build 
git clone https://github.com/saltnpepper97/halley\ncd halley\ngit checkout v0.6.1\ncargo build --release --workspace

Notes

Still Growing

  • The wiki now defaults to v0.6.1. v0.6.0 and earlier documentation remains available from the version picker.
  • This patch does not change the 0.6 configuration format or require a migration.
  • Users with mixed-refresh monitors, fullscreen-heavy workflows, or frequent Alt-Tab and Apogee use should update.

Thanks

To The Early Field

Thanks to everyone who tested the rewrite immediately and reported the first presentation and overview regressions with precise reproduction steps.

The mixed-refresh, fullscreen restoration, stuck-modifier, and preview-corruption reports kept this follow-up focused.

The field stays live, even in overview.