bitzdots

1# Features
2 
3Complete overview of everything bitzdots has to offer.
4 
5## 1. Automatic Color Theming
6 
7The core feature. Every component derives its colors from your current wallpaper.
8 
9### How It Works
10 
111. **matugen** extracts a 16-color palette from your wallpaper using the fastresize backend (fast and reliable on low-end hardware)
122. **25 Jinja2 templates** render these colors into config files
133. **reload-theme.sh** notifies all running applications of the change
144. **Cache daemon** pre-generates palettes so switching wallpapers is instant
15 
16### Themed Components (20+)
17 
18| Component | What Gets Themed |
19|-----------|-----------------|
20| **Hyprland** | Active/inactive border colors (2-color gradient) |
21| **Waybar** | Full CSS (background, text, module colors) + JSONC config |
22| **Kitty** | Terminal 16-color palette |
23| **Rofi** | Launcher, power menu, wallpaper picker themes |
24| **SwayNC** | Notification center background, text, accent colors |
25| **Wlogout** | Logout screen CSS |
26| **Cava** | Audio visualizer color scheme |
27| **Qt/KDE** | Full color scheme via qt6ct + kdeglobals |
28| **GTK** | GTK settings.ini links |
29| **Hyprlock** | Lock screen background and styling |
30| **Browser** | CSS file for web-based theming |
31 
32## 2. Waybar Status Bar
33 
34Top-mounted, 26px height status bar with 15 modules:
35 
36- **Workspaces** — Batch display (5 at a time, centered on active). Click to focus, scroll to cycle
37- **Runcat** — CPU activity animation (Python-based)
38- **Media** — Now-playing display with play/pause/next/prev controls
39- **Clock** — AM/PM format, calendar tooltip on hover
40- **Network** — WiFi/ethernet icons with signal strength, click to open impala TUI
41- **Bluetooth** — Connection status, click to open bluetui
42- **Audio** — Volume slider, click to open pulsemixer
43- **Brightness** — Backlight level with 4-tier icon, scroll to adjust
44- **Power Profiles** — Current power profile (balanced/power-saver), click to cycle
45- **CPU** — Usage percentage, click to open btop
46- **Memory** — RAM usage, click to open btop
47- **Recording** — Flashing indicator when screen recording
48- **Notification** — Bell icon with DnD status, click to toggle panel
49- **System Tray** — Standard Wayland system tray
50- **Power** — Logout/restart/shutdown menu
51 
52## 3. Keyboard-Driven Interface
53 
5455+ keybindings for mouse-free operation. See [Keybindings](keybindings.md) for the full list.
55 
56## 4. Rofi Menus
57 
58Every system function has a keyboard-navigable rofi interface:
59 
60- **App Launcher** — `SUPER + Space`
61- **Clipboard History** — `SUPER + V` to copy, `SUPER + SHIFT + V` to delete (cliphist integration)
62- **Power Menu** — `SUPER + P` (lock, logout, sleep, reboot, shutdown)
63- **Wallpaper Picker** — `SUPER + SHIFT + W` (static + live, grid with thumbnails)
64- **Audio Menu** — Switch output/input devices, open pulsemixer
65- **Bluetooth Menu** — Toggle, connect devices
66- **WiFi Menu** — Connect to networks, toggle
67- **System Monitor** — Open btop/htop
68 
69## 5. System TUI Pattern
70 
71All system tools open in floating Kitty windows with the `system-tui` class:
72- Auto-float window rule for consistent behavior
73- Centered, 800x600 default size
74- Accessible via waybar click or keybind
75 
76| Tool | Function |
77|------|----------|
78| **btop** | System monitor (CPU, RAM, processes) |
79| **pulsemixer** | Audio mixer |
80| **impala** | WiFi network manager |
81| **bluetui** | Bluetooth manager |
82| **nmtui** | Network manager (fallback) |
83 
84## 6. Screenshots & Recording
85 
86- **Fullscreen screenshot** — `Print` → saves to `~/Pictures/Screenshots/Fullscreen/` + clipboard
87- **Selection screenshot** — `SUPER + SHIFT + S` → select region with slurp → saves to `~/Pictures/Screenshots/Freeform/` + clipboard
88- **OCR screenshot** — `SUPER + SHIFT + T` → select region, runs eink-ocr
89- **Fullscreen recording** — `SUPER + R` → wf-recorder with audio → saves to `~/Videos/Recordings/Fullscreen/`
90- **Region recording** — `SUPER + SHIFT + R` → select region → saves to `~/Videos/Recordings/Region/`
91 
92## 7. Notification Center
93 
94SwayNC-based notification center with:
95 
96- **MPRIS widget** — Now-playing with album art, play/pause/next/prev
97- **Volume slider** — Master volume control
98- **Backlight slider** — Screen brightness control
99- **Quick toggles** — WiFi, Bluetooth, microphone mute, speaker mute
100- **Do Not Disturb** mode
101- **3-second notification timeout** for minimal intrusiveness
102 
103## 8. Wallpaper Management
104 
105- **Static wallpapers** via `awww` with animated crossfade transitions
106- **Live video wallpapers** via `mpvpaper`
107- **Cache daemon** pre-generates color palettes for all wallpapers in the background
108- **Grid picker** with thumbnails for instant preview
109- **Automatic color extraction** from both static images and video frames
110 
111## 9. Low-End Optimizations
112 
113- **CPU-efficient scripts** — All waybar polling scripts use minimal intervals where possible; power-profiles uses D-Bus directly (no hang-prone powerprofilesctl)
114- **No playerctl leaks** — Media script kills stale `playerctl metadata --follow` processes on startup
115- **Efficient workspace polling** — Uses `hyprctl workspaces -j` (lightweight) instead of `hyprctl clients -j`
116- **Low-resource idle** — Full stack under 300MB RAM
117- **Cache daemon runs at idle priority** — Nice=19, IO scheduling class=idle
118 
119## 10. Fish Shell + Fastfetch
120 
121- **Fish** with greeting disabled, `~/.cargo/bin` and `~/.local/bin` in PATH
122- **Fastfetch** with custom BITZ ASCII logo, displays system info on terminal start
123