• Multi-WM Support: Designed for Arch Linux (supports Hyprland, Niri, MangoWM, Labwc) with seamless switching between window managers.
• Distro Agnostic: Compatible with any Linux distribution given the core dependencies are installed.
• DE-like Experience: Modular UI powered by Rofi, Waybar, SwayNC, and custom scripts.
• Extensible: Highly customizable and easy to adapt to your own workflow.

• Control Center: ~/hakuspace-control this directory stores your custom configs so you don't have to touch the main ones, giving you much more freedom to customize.
• Accent Colors: Synced across Waybar, Rofi, Kitty, Swaync,... giving your setup a Super Clean and Cohesive Vibe!
• Smart Accent Color: Automatically generates the accent color palette based on your current wallpaper.
• Flexible Waybar Layouts: Support layouts: top, left, coredge, minimal, full, neon (Will be extended more).
• Unique Cava Underbar: Dynamic audio visualizer waves seamlessly layered directly beneath the Waybar.
• Wallpaper Automation: Wallpapers change automatically every 5 minutes (customizable WALL_INTERVAL in the main_setting.sh).
• Dockbar: Built-in, Another Waybar with wlr/taskbar module, can pin applications, looking like a Taskbar or Dock.
• Desktop Icons (experimental): Built-in, Items in folder ~/Desktop will be shown on Desktop (still bugs btw).

[!note] My dotfiles are powered by scripts; if you're not using them, there's no impact on your performance!

If you have any questions about how to use my dotfiles or want some tips, don't hesitate to reach out on Discord

XDG Desktop Portal: GTK by default, but each WM will use its specific, recommended portal according to its official wiki (hyprland uses hyprland, niri uses gnome, and mangowm/labwc uses wlr).

Accent Color based on wallpaper using python-colorthief

[!Important] Prerequisites: You need a pre-installed Arch Linux or an Arch-based Linux Distro (A fresh install is highly recommended). If you already have an existing WM or DE configuration, it is best to only reference the configs in HakuSpace rather than running the installation script directly over your system.

[!tip] For Fedora users, you can follow the Fedora Guide

1. Clone the Dotfiles

If you prefer to experience the lastest changes (Lastest Git), you can clone the main branch:

cd ~
git clone https://github.com/hakuimaku/hakuspace.git ~/hakuspace

If you prefer the version I've tested (a little honestly), clone the stable release version v2.2.1 (lastest):

cd ~
git clone --depth 1 --branch v2.2.1 https://github.com/hakuimaku/hakuspace.git ~/hakuspace

Switch to the hakuspace directory:

cd hakuspace

2. Run the Installation Script

chmod +x install.sh
./install.sh

3. Complete the Installation

After running the installation script, restart your computer and log in to either Hyprland, Niri, Mango or Labwc to experience the new setup.

4. After Installation

1. Change the GTK theme:

• Go to GTK Settings in Rofi App Menu.
• Change the theme, icons, and mouse cursor for a better aesthetic.

2. Install additional packages:

waybar-cava is a plugin for Waybar that provides a visualizer for audio output. My waybar top needs this to work properly (cava module).

yay -S waybar-cava

3. Allow Local Root User to Access X/Xwayland Display

xhost +si:localuser:root

Grants the local root user permission to connect to and launch graphical (GUI) applications (like GParted) within the current user's active X server or Xwayland session.

🔽 Update Haku Space to lastest version

1. Get the lastest version

• Git pull for the lastest git.

cd ~/hakuspace
git pull origin main

• Git fetch for the lastest stable release.

cd ~/hakuspace
git fetch --tags
LATEST_TAG=$(git describe --tags $(git rev-list --tags --max-count=1))
git checkout $LATEST_TAG

2. Update

• Run update.sh script in hakuspace folder.

cd ~/hakuspace
chmod +x update.sh
./update.sh

🗑 Uninstall Haku Space

(WM: The Window Manager you are currently using, e.g., hyprland, niri, mango).

My dotfiles are very clean. You just need to check the config folders that were copied from common and specific WM in ~/hakuspace, then delete them from ~/.config (During installation, the install.sh script automatically created a backup of your existing configuration files so you can backup your old config).

• Remove all scripts located in ~/.local/bin.
• Delete the auto-generated files in ~/.local/state/haku_theme.
• If necessary, you can also remove the icons and themes inside ~/.icons and ~/.themes.
• Review pkg-core.txt, pkg-service.txt, pkg-optional.txt (in hakuspace/common) and pkg-WM.txt (in hakuspace/WM) to uninstall any unnecessary packages.
• Finally, you can completely delete the ~/hakuspace directory.

You can immediately use the plugins that I have pre-configured. Simply install and enable them using the commands below (or tweak them as you like in plugin.lua).

• hyprexpo - Overview layout for your workspaces.
• hypr-dynamic-cursors - Smooth, physics-based dynamic cursor effects.

hyprpm update

hyprpm add https://github.com/virtcode/hypr-dynamic-cursors
hyprpm enable dynamic-cursors

hyprpm add https://github.com/sandwichfarm/hyprexpo
hyprpm enable hyprexpo

hyprpm reload

Read the Wiki for more info: https://wiki.hypr.land/Plugins/Using-Plugins/

See more in ~/hakuspace-control/hyprland-custom.lua for guide.

• See more keybinding in: Hyprland | Niri | MangoWM | Labwc
• Hotkeys:

• Labwc:

• Custom config (your personal changes): ~/hakuspace-control
• Icons: ~/.icons
• Themes: ~/.themes
• All hakuspace scripts: ~/.local/bin
• Fastfetch logo: ~/.config/fastfetch
• Wallpapers: ~/Pictures/Wallpapers
• Lively wallpapers: ~/Videos/Wallpapers
• Lively wallpaper thumbnail: in folder Preview ~/Videos/Wallpapers/Preview and add image .jpg/.png (same name with video) to make the thumbnail appear in rofi select menu if you want to use lively wallpaper
• State file & Haku Theme for waybar, rofi,... (includes accent_color, font, font size): ~/.local/state/haku_theme

• Open your terminal on Workspace 1 and type haku for a little surprise. To close them, just append the '--clear' argument (e.g., haku --clear).
• Cava Underbar: To toggle a Cava visualizer right below Waybar, select Cava Underbar from the Haku Menu. It automatically hides during fullscreen and reappears when you exit. To disable it completely, just toggle it again in the Haku Menu.

Waybar bugs:

• Waybar clock: You should set your timezone and locale manually in waybar configuration to ensure the clock displays correctly.
• Waybar cava module: If you encounter issues with the Cava module in Waybar, ensure that you have installed waybar-cava and that it is properly configured in your Waybar config file.
• Waybar use ext/workspaces for Multi-WMs setup.

My dotfiles bugs:

• Currently, my custom gtk.css is only compatible with GTK 3 and only supports Dark Mode. If you are using Light Mode, you may encounter some issues with the appearance of GTK applications (Thunar). If you don't want to use my thunar theme, remove gtk.css in ~/.config/gtk-3.0/.
• Cava Underbar in Niri does not support the no-focus rule. As a result, you might accidentally move it from its original position or close it by mistake.
• Some features might still be missing since I only tested this setup for my personal use. If you need more than what's provided, you'll need to install and configure those parts manually.
• If you don't want to use certain apps (like wl-screenrec, thunar, ly etc.), you can easily remove and replace them with alternatives. However, some apps are deeply integrated into my scripts or configs, so removing them may break functionality or cause those scripts/configs to stop working.
• If you find that the script isn't working, run it directly in the terminal to see what the error is.
• If you encounter any issues during installation or configuration, just ask me in some video on my Tiktok, open an issue on GitHub or Join my Discord to get more help!. I will do my best to help you out.

If you're using Fedora:

• Swaync service may automatically start on Fedora. Which can cause issues when startup. To fix this, you can disable the Swaync service by running the following command:

systemctl --user disable swaync.service

• This is a personal dotfiles configuration. Feel free to fork and adapt it to your needs!
• Tiktok / See more showcase: @hakuimaku2372
• Discord: hakuspace-dots

See hakuspace-archive for the assets used in this project: hakuspace-archive