Repository navigation
Releases
v0.57.2+1
Optional app icons now identify windows inside workspace previews. They are disabled by default; position, size, padding and background settings are documented in Window Icons. The release preserves background images and includes the filesystem, app-ID path and padded-corner hardening from the review.
What's Changed
- Add app icons to window previews (
window_icon_*) by @Papieog in #185 - Deliver window icons through supported pins in v0.57.2+1 by @dskvr in #190
New Contributors
Full Changelog: v0.57.2...v0.57.2+1
Compatibility and verification
- Source pins cover Hyprland 0.57.0, 0.57.1 and 0.57.2. The three current mappings select retained source
d54a70dcb75bd6812dc4609815e57943eafa8f51; all sixteen older mappings are unchanged. - The prebuilt
hyprexpo.sois Arch Linux x86_64 / Hyprland 0.57.2, source11cbc6c577b84ffb1edf4df3fc5b6128c3ae6947, with Lua 5.5. Use a matching build for another compositor ABI. - Exact three-target builds, forced rebuilds, 67 generated-header records per target, matching KVM/VirGL rendering/interaction/lifecycle tests, and public GitHub Nix follows consumers pass. Normal no-revision Nix-assisted HyprPM selected the intended retained source and passed actual-cache rendering, physical unload/reload and clean exit on all three targets.
- The actual downloaded Arch binary and provenance were independently checked against tag/source/VERSION and GitHub asset digests. Those unchanged bytes passed the full 0.57.2 runtime, background/icon pixel, reload and lifecycle suites; physical mappings were 5 → 0 → 5, and the compositor exited 0 while the plugin was loaded.
Release source: f538f62e17c167eeb2a513998c9c92a648ea30dc.
Release workflow · Three-target release gate · Validation receipt.
| Asset | SHA256 |
|---|---|
hyprexpo.so |
3ea74e106fefe8738887f806978feb4351038d46995b4cab7374eb0c30a41e51 |
release-provenance.txt |
83e36ae5a4e539f85c79bb4591547afc4cc478b6e6ffaaf83376730550955409 |
Runtime evidence uses disposable KVM/VirGL and Nix-assisted consumers. Source tests additionally cover mixed virtual resolutions/scales; physical touchpad, HDR, rotated outputs, physical mixed-DPI hardware and an unprepared generic distro installation are outside coverage. The daily desktop installation was unchanged.
v0.57.2
Custom overview backgrounds
Configure an image behind grid and native scrolling overviews using bg_image,
bg_image_fit (cover, contain, or stretch), and bg_image_blur (0..64).
Textures are cached across openings, refreshed on config reload or output-size
changes, and released on unload. Unreadable paths retain the existing background.
Default Make and unconfigured CMake plugin builds now optimize cold image
filtering. Initial decoding/filtering still runs synchronously; cached reopenings
avoid that work.
Compatibility
Supports Hyprland v0.57.0, v0.57.1 and v0.57.2 with an exact v0.57.2 Nix input.
Current-release HyprPM pins include the background-image feature; all older
mappings remain unchanged. Rebuild for the compositor revision and dependency ABI
that will load the plugin. The downloadable binary targets the Arch Hyprland
version recorded in release-provenance.txt; it is not a universal plugin binary.
Validation
Exact three-target builds, forced rebuilds, regression suites, and disposable
rendering/lifecycle/consumer checks are recorded in the release receipt.
Physical touchpad gestures, HDR, rotated/fractional outputs and generic distro
HyprPM installations are outside the disposable validation scope.
Thanks to @Rana718 for the background-image feature in #186.
Release validation receipt · normal HyprPM consumer results
The actual downloaded public binary passed matching v0.57.2 interaction,
background-image and lifecycle tests, including unload to zero mappings,
reload, and compositor exit code 0 with the released plugin loaded.
Published binary SHA256: fa79d0421ed9c1685a984f34d4a27db1c0925755074c8fdb0de639f5220ba1a8.
Full changelog: v0.57.1...v0.57.2
v0.57.1
Builds now consistently select Lua 5.5, including systems with Lua 5.4 also installed. HyprExpo supports Hyprland 0.57.1 while retaining source support for 0.57.0.
- Correct GCC's GNU-unique flag and rebuild existing Make artifacts when build settings change.
- Update both supported HyprPM mappings to retained source
09fef61; all sixteen older mappings are unchanged. - Record the actual Lua module, source/tag/version, package versions, ELF dependencies and artifact checksum in
release-provenance.txt.
Validation covers 104 tooling tests, four C++ suites, both exact builds and forced rebuilds, external Nix consumers, ordinary no-revision HyprPM installs, and matching disposable runtime/lifecycle checks on both targets. The downloaded public binary also passed full matching-compositor runtime and lifecycle checks, including verified library unmapping after unload. Physical touchpad and HDR hardware paths were not exercised.
The downloadable binary targets Hyprland 0.57.1 and the dependency ABI recorded in its provenance. Build through HyprPM for the ABI of your running compositor.
SHA256 (hyprexpo.so):
91dfb3d44052646cd2963e102ccf56aefdcd638736d3e42b40f2ba4cc0f7994d
What's Changed
- Document Arch hyprpm installation and upgrade recovery by @dskvr in #178
- build: require Lua 5.5 for the Hyprland 0.57 target by @richtj in #180
- Support Hyprland 0.57.1 with verified Lua 5.5 release builds by @dskvr in #181
- Update 0.57 HyprPM pins to the validated Lua 5.5 source by @dskvr in #182
New Contributors
Full Changelog: v0.57.0...v0.57.1
v0.57.0
What's Changed
- Update HyprPM description for hyprexpo by @dskvr in #119
- Allow explicit rows in fixed workspace grids by @dskvr in #118
- Document release-compatible and Hyprland development branch policy by @dskvr in #120
- Validate the Hyprland development track at an exact upstream commit by @dskvr in #122
- Validate release and development compatibility through separate CI gates by @dskvr in #121
- Restore the original demo video below the README introduction by @dskvr in #124
- Consolidate repository layout and retire the completed scrolling spike by @dskvr in #125
- Reconcile the landed repository cleanup into hyprland-git by @dskvr in #126
- Guard HyprPM registrations and releases against temporary revisions by @dskvr in #127
- Turn Hyprland probe drift into bounded compatibility work by @dskvr in #128
- Draft: diagnose Hyprland 599ff9042 workspace API breakage by @dskvr in #129
- Classify Hyprland probe evidence by tested tree by @dskvr in #130
- chase: validate Hyprland f05d73f by @dskvr in #131
- docs(troubleshooting): document recovery from a sticky failed plugin load by @aserper in #132
- Keep center-current grids at a monitor's rule-reserved workspace floor by @dskvr in #135
- [hyprland-git] Keep center-current grids at a monitor's rule-reserved workspace floor by @dskvr in #134
- Use touch-down coordinates for grid workspace selection by @lukastk in #137
- Fix grid touchscreen selection on hyprland-git by @dskvr in #138
- Reuse exact Hyprland builds through a signed Bunny cache by @dskvr in #139
- Cancel active workflows when a pull request closes by @dskvr in #140
- Retry Bunny cache uploads after a HEAD authorization failure by @dskvr in #141
- Cancel closed PR workflows when GitHub omits PR associations by @dskvr in #142
- Skip Nix compatibility builds for documentation-only changes by @dskvr in #143
- Make README onboarding and documentation easier to follow by @dskvr in #145
- Add plugin:hyprexpo:overview_mode to opt out of scrolling detection by @dskvr in #147
- Support Hyprland e368c13c27a4 by @dskvr in #148
- Support Hyprland 579829f render contexts and safe reloads by @dskvr in #154
- Prevent Lua-configured overview opens from crashing by @dskvr in #153
- Preserve HDR working colors in workspace previews by @dskvr in #152
- Redesign landing page to match hyprlax and hyprflow by @dskvr in #157
- Carry master fixes forward and chase Hyprland 663b29b8 by @dskvr in #160
- Add opt-in cross-monitor workspace grids and direct selection by @Lowtrixx in #161
- Update src/HyprexpoLogic.cpp - adds missing '}' by @martin-hamilton in #164
- Refresh foreign workspace previews on source-monitor damage by @Lowtrixx in #162
- release: prepare v0.56.2+4 and refresh supported release pins by @dskvr in #166
- fix: unblock v0.56.2+4 release after PR #166 by @dskvr in #167
- release: pin validated v0.56.2+4 source for HyprPM by @dskvr in #168
- Keyboard: move up/down by drawn position, not column index by @jaroxciv in #165
- release: prepare v0.56.2+5 with centered-row navigation by @dskvr in #169
- Keep rotated captures coherent and refresh resized workspace previews by @dskvr in #156
- Carry released fixes into Hyprland c4e7596a with upright workspace previews by @dskvr in #171
- Adopt Hyprland v0.57.0 as the release and development target by @dskvr in #173
- Tracking: Hyprland development changes relative to master by @dskvr in #123
- release: v0.57.0 for Hyprland v0.57.0 by @dskvr in #174
New Contributors
- @lukastk made their first contribution in #137
- @Lowtrixx made their first contribution in #161
- @martin-hamilton made their first contribution in #164
- @jaroxciv made their first contribution in #165
Full Changelog: v0.56.2...v0.57.0
v0.56.2+5
v0.56.2+4
What's Changed
- Prevent Lua-configured overview opens from crashing by @dskvr in #153
- Preserve HDR working colors in workspace previews by @dskvr in #152
- Redesign landing page to match hyprlax and hyprflow by @dskvr in #157
- Add opt-in cross-monitor workspace grids and direct selection by @Lowtrixx in #161
- Refresh foreign workspace previews on source-monitor damage by @Lowtrixx in #162
- release: prepare v0.56.2+4 and refresh supported release pins by @dskvr in #166
- fix: unblock v0.56.2+4 release after PR #166 by @dskvr in #167
- release: pin validated v0.56.2+4 source for HyprPM by @dskvr in #168
New Contributors
Full Changelog: v0.56.2+3...v0.56.2+4
v0.56.2+3
What's Changed
- Use touch-down coordinates for grid workspace selection by @lukastk in #137
- Reuse exact Hyprland builds through a signed Bunny cache by @dskvr in #139
- Cancel active workflows when a pull request closes by @dskvr in #140
- Retry Bunny cache uploads after a HEAD authorization failure by @dskvr in #141
- Cancel closed PR workflows when GitHub omits PR associations by @dskvr in #142
- Skip Nix compatibility builds for documentation-only changes by @dskvr in #143
- Make README onboarding and documentation easier to follow by @dskvr in #145
- Add plugin:hyprexpo:overview_mode to opt out of scrolling detection by @dskvr in #147
New Contributors
Full Changelog: v0.56.2+2...v0.56.2+3
v0.56.2+2
What's Changed
- Document release-compatible and Hyprland development branch policy by @dskvr in #120
- Validate release and development compatibility through separate CI gates by @dskvr in #121
- Restore the original demo video below the README introduction by @dskvr in #124
- Consolidate repository layout and retire the completed scrolling spike by @dskvr in #125
- Guard HyprPM registrations and releases against temporary revisions by @dskvr in #127
- Turn Hyprland probe drift into bounded compatibility work by @dskvr in #128
- docs(troubleshooting): document recovery from a sticky failed plugin load by @aserper in #132
- Keep center-current grids at a monitor's rule-reserved workspace floor by @dskvr in #135
Full Changelog: v0.56.2+1...v0.56.2+2
v0.56.2+1
Compatibility and validation
- The attached binary is built for Hyprland 0.56.2 (
efb50993780079460b0cbed1363e2166a2de1d9f). Hyprland 0.56.1 users should use HyprPM or build against that exact release; plugin binaries are not ABI-interchangeable. - Both supported-release HyprPM pins select landed master source
5891014c611e1bd56d0121143f0221d46b5c0967, after separate exact-version builds and disposable loads on Hyprland 0.56.1 and 0.56.2. - The downloaded release artifact reports clean
v0.56.2+1and passed the rectangular fixed-grid runtime matrix on Hyprland 0.56.2. - Physical touch-device and Nix-build validation remain outstanding.
Binary SHA-256: e784f9d3822a72902f9c770b0c496b52407343c4afd2cf3fde1cb6b4fb2835f6. Build details are attached in release-provenance.txt.
What's Changed
- Update HyprPM description for hyprexpo by @dskvr in #119
- Allow explicit rows in fixed workspace grids by @dskvr in #118
Full Changelog: v0.56.2...v0.56.2+1
v0.56.2
Release validation and compatibility
- Annotated tag
v0.56.2points to7549dc3f776e84b934d736066e56fafff134e620; the VERSION file and published plugin both reportv0.56.2. - The attached binary is built for Hyprland 0.56.2 (
efb50993780079460b0cbed1363e2166a2de1d9f). For Hyprland 0.56.1, use HyprPM or build against that exact release; the two binaries are not ABI-interchangeable. - Both supported-release HyprPM pins select landed master commit
7c5e2ac2524ffa75d077b5785b760ec81edb0cc6, verified with separate exact-header builds and matching disposable native acceptance on 0.56.1 and 0.56.2. - The combined features include centered/capped workspace fixes, pinned-window close behavior, all-monitor overviews, and native scrolling-layout overviews. Cross-output grid dragging is supported; cross-output drops involving native scrolling cancel safely. Physical touch-device and Nix-build validation were not performed.
Changelog clarification: the automatically generated history below includes #109, but its development-only API changes were reverted during #113 and are not shipped here. The replacement development-compatibility draft #117 remains separate.
Binary SHA-256: 2b17d851e8add316293abd69b8bf026ec4a79dc333266b67b534fe581d2aa6f5. Build details are attached in release-provenance.txt.
What's Changed
- ci: validate hyprpm commit pins before release by @dskvr in #76
- Add active workspace overview mode by @aserper in #73
- fix: allow border_width = 0 to disable tile borders by @RohitKaushal7 in #80
- fix: crash when dragging a window onto a tile it fills by @RohitKaushal7 in #79
- feat: add drag-and-drop toggle by @dskvr in #83
- Keep overview number keys on the active display by @dskvr in #78
- feat: add gesture_fingers and gesture_direction config options by @RohitKaushal7 in #81
- Prevent number-key crashes under Lua config by @dskvr in #89
- Hide workspace labels immediately when closing overview by @dskvr in #90
- Grow first-anchored grid to keep active workspace visible (#91) by @dskvr in #92
- Remove explanatory comments around first-anchor grid growth by @dskvr in #93
- docs(lua): explain declarative plugin loading by @aserper in #95
- fix(labels): honor explicit legacy settings by @aserper in #96
- Restore the previous submap on close instead of hardcoding reset by @dceu in #98
- Add an origin-preserving cancel gesture by @dskvr in #106
- fix: chase upstream keybind changes by @matt1432 in #109
- Fix pins for v0.56.{1,2} by @rharish101 in #112
- Test combined overview features before landing on master by @dskvr in #116
New Contributors
- @RohitKaushal7 made their first contribution in #80
- @dceu made their first contribution in #98
- @matt1432 made their first contribution in #109
- @rharish101 made their first contribution in #112
Full Changelog: v0.56.1...v0.56.2