Repository navigation
Releases
v26.11
HakuSpace v26.11 - Hikai Update
This release focuses on making Hikai a more complete and reliable Quickshell desktop experience, while keeping Classic available.
Highlights
- More integrated Hikai shell surfaces, including HakuMenu, taskbar, dashboard and settings.
- Native wallpaper and video playback options.
- Task Manager, image editor, window navigation and native lock/idle controls.
- Improved light/dark theming and personalization.
Fixes
- Safer updates and configuration migration.
- UI interaction, focus and shell transition improvements.
Upgrade
Run ./update.sh, then ./scripts/migrate.sh --audit and ./doctor.sh.
Arch Linux remains the primary supported platform. Classic mode is still available.
v26.10-1
What's Changed
- Lively wallpaper resume: video wallpapers are now restored automatically at login via the new
wallpaper_resume.sh(Hyprland, Niri, Mango, Labwc) - Random wallpaper:
random_wallpaper.shnow cycles lively wallpapers too, picking videos while mpvpaper is running - Accent color: dark colors are now brightened to a minimum luminance instead of falling back to white
- Edge Trigger: swapped the top and bottom edges, so top opens hakumenu and bottom opens wallpaper select
- Kill Lively Wallpaper: now restores the static wallpaper and accent color
- Wallpaper startup: smarter daemon startup depending on the last wallpaper type
- Taskbar: better Thunar icon
- Theme menu: removed the redundant Change Lively Wallpaper entry and fixed Kill Lively Wallpaper
Full Changelog: v26.09-2...v26.10-1
v26.09-2
What's Changed
- Edge Trigger (new): hover a screen edge to open Rofi/SwayNC menus (wallpaper select, Haku Menu, shutdown, notifications). Menus auto-close when the mouse leaves their safe zone. Dwell time, cooldown and edge length are configurable.
- Haku Shell Mode (new): one toggle for Rounded Screen (dynamic), Cava (dynamic), Opaque Theme and Edge Trigger.
- Opaque Theme (new): solid black panels for Waybar, Rofi, SwayNC, GTK and Kitty.
- Dynamic exclusive zone: Rounded Screen and Cava now respect other panels like Waybar. Cava also gets a Top (overlay) mode and a color switch.
- Rofi: unified static and live wallpaper selector, new vertical shutdown menu, improved themes, keybinds and mouse binds, and a slide animation.
- Hyprland: updated border and rounding style, fixed VS Code window rules (also on Niri and Mango), fixed the
hypridlesource. - SwayNC: redesigned control center, with a Haku Shell toggle replacing the taskbar button.
- Hyprlock: custom top label, bottom label and placeholder via
~/hakucfg/config/hyprlock.conf. - Utilities: new
fix_icon_theme.sh, Waybar manual toggle, Taskbar icon and reload fixes. - Breaking:
GEN_HORI_OPTSandGEN_VERT_OPTSare renamed toGEN_WIDE_OPTSandGEN_BOX_OPTS. Update~/hakucfg/setting.shif you overrode them. - Docs: Edge Trigger, Opaque Theme and NixOS integration docs, plus a Fedora guide fix.
Full Changelog: v26.09-1...v26.09-2
v26.09-1
What's Changed?
New Features & Major Updates
- Migrated configuration management to a flexible symlink-based deployment mechanism.
- Desktop Icons: Completed the desktop icons application, adding an auto-arrange feature and interactive options.
- Taskbar: Removed the old
dockbarand replaced it with a brand newtaskbarimplementation. - Rounded Screen: Introduced a new feature to add aesthetic rounded corners to your screen.
- Shortcut Generator: Added a script and a Rofi menu to easily generate and select application shortcuts.
- Documentation: Added comprehensive documentation for core scripts, libraries, and mini-apps.
Improvements & Fixes
- Accent Color Engine: Enhanced dark color detection using WCAG luminance for smarter color generation.
- Waybar: Cleaned up unused code and added a linear-gradient background for the
leftlayout. - Hyprland: Tweaked special workspace animations and improved vibrancy blur settings.
- System Scripts: Optimized
doctor.sh,install.sh,update.sh, andclean.sh(added cleanup support for other package managers). - Fish Shell: Improved shell abbreviations for a better command-line workflow.
- Icon Handling: Enhanced cache handling and theme detection for taskbar application icons.
- Menu Logic: Removed
disownfrom spawn functions for better underlying process management. - Styling: Set the default visual base style to use rounding and gaps.
Full Changelog: v2.3.2...v26.09-1
v2.3.2
What's Changed?
- Refactor Rofi: improved the interface, adding 3 new themes and 1 old theme (old but gold):
- legacy: old, minimal.
- line: cleaner, more modern, with some lines (default).
- tablet: horizontal, includes wallpaper, designed for relaxation.
- television: vertical, includes wallpaper, optimized for ultra-wide wallpapers.
- Hyprland changes: decoration now defaults to
gap = 0, and window animations use slide for a minimal, focused experience. Press SUPER + F1 to toggle centered focus mode;gaps_outwill increase to80if you want a broader view of the workspace. - Fish shell configuration has been added to
hakucfg, allowing you to customize your shell as desired. - Minor Waybar changes: the default theme is now
top(the oldfulltheme), and the oldtoptheme has been renamed tolegacy. - Changes to the HakuMenu in the Theme tab: the Change Waybar/Rofi theme options have been moved into Change Theme.
- Updated
setting.shto versionv2.3.2.
Full Changelog: v2.3.1...v2.3.2
v2.3.1
What's Changed?
Something new:
- Refactor
hakuspace-control, remove it and usehakucfginstead: improve structure, rename to become more professional. - Improve Accent Color with 4 mode:
vivid,dominant,brightestandsaturatedcolor. - Improve default app (browser, file manager): use
xdg-opento manage. - Improve
fulllayout Waybar. - Improve Cava Underbar feature: color based on accent color.
- Improve scripts.
Something change:
- Keybinding: add more keybinding, Niri use SUPER + T to toggle Cava Underbar.
- New look and feel for Hyprland.
- State files: now stored in
~/.local/state/hakuspace
Remove the old hakuspace-control because they are no use now, you should move your config to the new one `~/hakucfg before remove them:
rm -rf ~/hakuspace-controlRemove the old state files:
rm -rf ~/.local/state/haku_themeWaybar full layout with the new Hyprland's look:

Full Changelog: v2.3.0...v2.3.1
v2.3.0
What's Changed?
Something new:
- Update
main_setting.shfrom v2.2.2 to version 2.3.0 - Added customizable Hypridle settings through
~/hakuspace-control/hypridle.conf. - Renamed
cava-layer.pytocava_layer.py. - Simplified wallpaper and thumbnail path handling.
Remove this directory, because it's no use now:
rm -rf ~/Videos/Wallpapers/PreviewRefactor repository:
- Restructured configuration sources under
src/home/. - Simplified and fixed
install.shandupdate.shdeployment paths. - Added automatic backups under
~/.backup/before configuration changes. - Added
rollback.shto restore previous HakuSpace configurations safely. - Rollback preserves unrelated files and user-owned once-only configurations.
- Added comprehensive architecture and dotfiles copy-management documentation.
- Added Vietnamese translations for the installation and architecture guides.
- Updated README installation, rollback, NixOS, and keybinding instructions.
The repository now uses the following source layout:
src/home/.config/for application and window-manager configuration.src/home/.local/bin/for managed user scripts.src/home/hakuspace-control/for default user customization templates.src/packages/for package manifests.
HakuSpace continues to use regular copied files rather than symbolic links or Home Manager.
Full Changelog: v2.2.6...v2.3.0
v2.2.6
What's Changed?
- New Waybar style: Island!
- Refactor Cava Underbar: now is GTK layer app, so can support all WM!
- Enhanced:
record.sh,lock.sh.
Cava-layer (Cava underbar) needs vte to work properly:
sudo pacman -S vte3
Full Changelog: v2.2.5...v2.2.6
v2.2.5
What's Changed?
- Lively Wallpaper auto-gen thumnail, all you want to use is put your video in ~/Videos/Wallpapers.
- Fix: remove static set mouse cursor.
- Fix: dpms hyprland.
Full Changelog: v2.2.4...v2.2.5
v2.2.4
What's Changed?
- Niri and Mango now have colored borders based on the accent color.
- Shifted the dotfiles style toward a squarer design instead of the old rounded corners.
- Upgraded the Thunar style to make it look cleaner and better :).
- Updated system idle behavior using hypridle and the
idle_inhibit.shscript (removedsway-audio-idle-inhibit). - Updated SwayNC: styling adjustments and updated several buttons.
- Updated the Starship prompt style.
- Fixed NixOS issue: stopped using
nix-shellto run Python scripts due to high execution delay.
Full Changelog: v2.2.3...v2.2.4
