Configuration

Configuration

All configuration files live under ~/.config/ and are symlinked from the repo by install.sh.

File Structure

~/.config/bitzdots/
├── hypr/                    # Hyprland (Lua)
│   ├── hyprland.lua         # Entry point (requires all modules)
│   ├── variables.lua        # Environment variables
│   ├── monitors.lua         # Display configuration
│   ├── input.lua            # Keyboard, mouse, touchpad
│   ├── appearance.lua       # Blur, opacity, borders
│   ├── animations.lua       # Window animations
│   ├── keybinds.lua         # 55+ keyboard shortcuts
│   ├── rules.lua            # Window rules
│   └── autostart.lua        # Startup applications
├── waybar/
│   ├── config.jsonc         # Module layout (15 modules, themed)
│   ├── style.css            # Bar styling (themed)
│   ├── colors/teto.css      # Default color fallback
│   ├── scripts/             # 17 custom scripts
│   └── modules/runcat-text/ # CPU runcat animation
├── rofi/
│   ├── config.rasi          # Main config
│   ├── themes/              # 27 theme variants
│   ├── colors/              # 16 static color schemes
│   ├── launchers/type-6/    # Wallpaper launcher variant
│   ├── scripts/             # Power, clipboard, wallpaper scripts
│   └── icons/               # 8 themed SVG icons
├── swaync/
│   ├── config.json          # Notification center config
│   └── style.css            # Notification styles (themed)
├── wlogout/
│   ├── layout               # Button layout
│   ├── style.css            # Logout screen styles (themed)
│   ├── assets/              # SVG icons
│   └── icons/               # PNG icons
├── kitty/
│   └── kitty.conf           # Terminal config
├── cava/
│   ├── config               # Audio visualizer config
│   ├── shaders/             # 6 shaders
│   └── themes/generated     # Auto-generated theme
├── wallust/
│   ├── wallust.toml         # Theming config (template → target map)
│   ├── templates/           # 25 Jinja2 templates
│   └── *.sh                 # Utility scripts (linked from scripts/)
├── fish/
│   └── config.fish          # Shell configuration
├── fastfetch/
│   ├── config.jsonc         # Fastfetch config
│   └── bitz.txt             # Custom BITZ ASCII logo
├── scripts/                 # 10 utility scripts
├── icons/                   # Source SVG icons (linked to rofi)
├── gtk/                     # GTK3/4 dark theme settings
├── environment.d/qt.conf    # Qt environment variables
└── systemd/user/            # User services (wallust cache daemon)

Hyprland

Hyprland configuration is split into modular Lua files for maintainability:

File	Purpose
hyprland.lua	Entry point — requires all other modules
variables.lua	Sets XCURSOR_SIZE, XCURSOR_THEME, Qt overrides
monitors.lua	Display resolution, refresh rate, orientation
input.lua	Keyboard, mouse, touchpad settings
appearance.lua	Blur, gaps, border colors (active border uses theme)
animations.lua	Window open/close animations
keybinds.lua	All keyboard shortcuts (55+)
rules.lua	Per-window rules (floating, workspace, opacity)
autostart.lua	Starts waybar, swaync, polkit, cliphist, wallpaper daemon

Waybar

Waybar modules are configured in waybar/config.jsonc with these intervals:

Module	Interval	Notes
Workspaces	2s	Uses hyprctl workspaces -j
Runcat	on-event	CPU activity animation (Python)
Media	on-event	playerctl now-playing
CPU	5s	Lightweight polling
Memory	10s	RAM usage display
Network	3s	Wi-Fi/ethernet status
Recording	10s	Blinks when wf-recorder active
Clock	30s	Date and time
Power profiles	5s	UPower D-Bus
Brightness	5s	Backlight control
Notifications	10s	SwayNC integration

Scripts

All utility scripts live in scripts/ and are symlinked into ~/.config/wallust/. Waybar-specific scripts live in waybar/scripts/. See Scripts for details.

Auto-Generated Files

Files marked Auto-generated by wallust — DO NOT EDIT are regenerated on every wallpaper change. To customize them permanently, edit the corresponding Jinja2 template in wallust/templates/ instead. See Customization.