-
-
Notifications
You must be signed in to change notification settings - Fork 1
FAQ
bitzdots is a collection of Hyprland dotfiles focused on low-end performance, automatic wallust theming, and a clean workflow. It includes configurations for waybar, rofi, swaync, kitty, fish, and 25 wallust templates covering 20+ components.
If you want a performant, auto-themed Hyprland setup that runs well on older hardware, yes. The setup is opinionated but highly customizable.
- Performance-first — Every component is tuned for low CPU/RAM usage
- Auto-coloring pipeline — 25 Jinja2 templates update automatically with any wallpaper
- Comprehensive — Recording, screenshots, media control, power management, notification center, live wallpapers out of the box
- Safe theming — Backup/restore on every wallust run
No, but you should have Hyprland installed and working. ./install.sh --with-deps handles dependencies.
Yes — the installer detects NixOS and prints the packages to add to configuration.nix. See Installation.
The installer creates symlinks. Existing configs are backed up to .bak before being replaced.
The Arch installer splits packages into guaranteed repo packages and AUR packages (installed one-by-one via paru/yay) so a single failure doesn't block the rest. If paru/yay is missing, install them first: sudo pacman -S paru.
Press SUPER + SHIFT + W or run:
~/.config/wallust/wallpaper-select.shThis updates all 25 themed configs automatically.
Edit hypr/keybinds.lua using the Lua API:
hl.bind("SUPER + SHIFT + Z", hl.dsp.exec_cmd("your-command"))Hyprland hot-reloads Lua configs on save — no restart needed.
Ensure the audio source is the default sink monitor (desktop audio). Check with pactl list short sources. See Scripts.
This is a known Hyprland issue. All recording scripts use an atomic mkdir debounce to prevent double execution.
bitzdots forces dark theme for both GTK and Qt apps by default. If something still appears light:
GTK:
- Check
~/.config/gtk-3.0/settings.inihasgtk-application-prefer-dark-theme=1 - Run:
gsettings set org.gnome.desktop.interface color-scheme prefer-dark
Qt:
- Verify
QT_STYLE_OVERRIDEandQT_QPA_PLATFORMTHEME=qt6ctare set - Qt6 config is auto-generated by wallust at
~/.config/qt6ct/qt6ct.conf
Ensure swaync is running. Toggle with SUPER + N, or restart: pkill swaync && swaync &.
Restart the portal service to fix the loop:
systemctl --user restart xdg-desktop-portal-hyprlandThe install script handles this automatically.
Make sure wallust is installed and templates are in wallust/templates/. Regenerate manually:
wallust run ~/.cache/current_wallpaper.png --config-dir ~/.config/wallust
~/.config/wallust/reload-theme.shThe kmeans backend can take minutes and fail on some images. bitzdots uses the fast fastresize backend by default:
grep backend ~/.config/wallust/wallust.toml # Should say "fastresize"
wallust run image.jpg --config-dir ~/.config/wallust --backend fastresizeInstall mpvpaper, then place videos (.mp4, .webm, .mkv, .gif) in ~/Pictures/Wallpapers/live/. The picker shows them under "Live wallpaper".
Ensure wallust has generated ~/.config/rofi/theme-generated.rasi:
ls -la ~/.config/rofi/theme-generated.rasi
# If missing:
wallust run ~/.cache/current_wallpaper.png --config-dir ~/.config/wallustThe rofi power menu uses themed SVG icons at ~/.config/rofi/icons/*.svg. They're generated by wallust templates (lock.svg.j2, logout.svg.j2, etc.). Regenerate the theme to create them.
Edit fish/config.fish and ensure set -U fish_greeting is present, then restart fish.
Change the terminal command in hypr/keybinds.lua.
Remove the custom/recording module from waybar/config.jsonc.
- Add module config to
waybar/config.jsonc - Add CSS in
waybar/style.css - Optionally add a custom script in
waybar/scripts/ - Restart waybar:
pkill -x waybar && waybar &
See Customization for the full guide.