bitzdots

1# Scripts
2 
3Reference for all scripts in bitzdots.
4 
5## Waybar Scripts (`waybar/scripts/`)
6 
717 scripts powering the waybar custom modules.
8 
9| Script | Purpose | Used By |
10|--------|---------|---------|
11| `brightness.sh` | Outputs current brightness % with 4-tier icon as JSON | `custom/brightness` |
12| `launch.sh` | Ensures waybar + swaync are running | Autostart |
13| `media.sh` | playerctl metadata follower (artist/title/album/status) | `custom/media` |
14| `notification.sh` | Bell icon with DnD/notification count | `custom/notification` |
15| `power-profile.sh` | Queries UPower via D-Bus for active profile icon | `custom/power-profiles` |
16| `power-profile-switch.sh` | Cycles to next available power profile via D-Bus | Click handler |
17| `system-power.sh` | Rofi power menu (Lock/Logout/Sleep/Reboot/Shutdown) | `custom/power` |
18| `tui-audio.sh` | Opens pulsemixer in floating kitty | Audio click (waybar) |
19| `tui-bluetooth.sh` | Opens bluetui in floating kitty | Bluetooth click (waybar) |
20| `tui-wifi.sh` | Waits for NetworkManager, then opens impala in floating kitty | Network click (waybar) |
21| `tui-cpu.sh` | Opens btop in floating kitty | CPU click (waybar) |
22| `weather.sh` | Fetches weather from wttr.in (30-min cache) | Optional module |
23| `workspaces.sh` | Batch workspace display (5 at a time) | `custom/workspaces` |
24| `workspace-click.sh` | Determines clicked workspace from pixel offset | Workspace click |
25| `workspace-next.sh` | Focus next workspace | Scroll up |
26| `workspace-prev.sh` | Focus previous workspace | Scroll down |
27 
28## Utility Scripts (`scripts/`)
29 
3010 core scripts for theming and recording.
31 
32### `reload-theme.sh`
33 
34Applies the generated theme to all running components.
35 
36```bash
37~/.config/matugen/reload-theme.sh
38```
39 
40**What it does:**
411. Reloads swaync CSS (`swaync-client --reload-css`)
422. Updates Hyprland border colors from `colors.lua`
433. Fixes qt6ct config path if needed
444. Restarts waybar for full refresh
45 
46### `wallpaper-select.sh`
47 
48Rofi-based wallpaper picker with grid thumbnails.
49 
50```bash
51~/.config/matugen/wallpaper-select.sh                    # Open picker UI
52~/.config/matugen/wallpaper-select.sh /path/to/image.jpg  # Direct set
53```
54 
55**Features:**
56- Grid display of all wallpapers with ImageMagick thumbnails
57- Separate sections for static wallpapers and live wallpapers
58- Cached theme switching — uses pre-generated palettes when available
59- Backup/restore safety on all theme generations
60- Restarts waybar after theme change
61 
62### `cache-wallpapers.sh`
63 
64One-shot pre-cache all wallpapers.
65 
66```bash
67~/.config/matugen/cache-wallpapers.sh
68```
69 
70Generates matugen palettes and ImageMagick thumbnails for every wallpaper in the directories.
71 
72### `matugen-cache-daemon.sh`
73 
74Event-driven background cache daemon.
75 
76```bash
77~/.config/matugen/matugen-cache-daemon.sh
78```
79 
80**Features:**
81- Watches wallpaper directories with `inotifywait`
82- Debounces rapid file changes
83- Pre-generates palettes in background
84- 24-hour failure cooldown for problematic images
85- File locking for single-instance safety
86- Runs at idle priority (Nice=19)
87 
88### `record-fullscreen.sh`
89 
90Toggle fullscreen screen recording.
91```bash
92~/.config/matugen/record-fullscreen.sh
93```
94 
95- Uses `wf-recorder` with audio (pulse audio)
96- Toggles: first call starts, second call stops
97- Saves to `~/Videos/Recordings/Fullscreen/` with timestamped filename
98- Shows start/stop notifications
99 
100### `record-region.sh`
101 
102Toggle region screen recording.
103 
104```bash
105~/.config/matugen/record-region.sh
106```
107 
108- Uses `slurp` for region selection + `wf-recorder` with audio
109- Same toggle behavior as fullscreen
110- Saves to `~/Videos/Recordings/Region/`
111 
112### `recording-indicator.sh`
113 
114Blinking indicator for waybar recording module.
115 
116- Called by waybar polling (10s interval)
117- Outputs empty JSON when not recording
118- Alternates between empty and icon JSON when recording (creates blink effect)
119 
120### `hyprlock-setup.sh`
121 
122Generates a basic `hyprlock.conf` from current wallpaper.
123 
124```bash
125~/.config/matugen/hyprlock-setup.sh
126```
127 
128- Uses current wallpaper as lock screen background
129- Sets JetBrainsMono font for the clock/date
130 
131### `wifi-fix.sh`
132 
133Boot-time WiFi stabilizer. Called from `hypr/autostart.lua` a few seconds after login.
134 
135```bash
136~/.config/matugen/wifi-fix.sh
137```
138 
139**What it does:**
1401. Waits for NetworkManager to appear on D-Bus (up to 30s)
1412. Unblocks the WiFi radio (`rfkill unblock wifi`, `nmcli radio wifi on`)
1423. Waits for an active connection (up to 45s)
1434. If still offline, reactivates every saved connection
1445. Retries with a radio toggle (off/on) if needed
145 
146Fixes the boot-time "strikethrough WiFi" waybar icon and impala crashes caused by NetworkManager not being ready.
147 
148### `font-switch.sh`
149 
150System font switcher between **Paper Mono** and **JetBrainsMono Nerd Font**.
151 
152```bash
153font-switch.sh [paper | jetbrains]
154font-switch.sh toggle               # or dev font toggle
155```
156 
157**What it does:**
1581. Checks if Paper Mono is installed; if not, downloads and installs it globally (`/usr/local/share/fonts/paper-mono/`).
1592. Updates `kitty.conf` font family and signals running Kitty instances (`SIGUSR1`) to reload live.
1603. Updates Waybar text font dynamically while preserving Nerd Font icons across the bar via Pango markup.
1614. Restarts Waybar smoothly to apply styling changes.
162 
163## Rofi Scripts (`rofi/scripts/`)
164 
165### `clipboard.sh`
166 
167Clipboard history manager.
168 
169```bash
170~/.config/rofi/scripts/clipboard.sh              # copy mode
171~/.config/rofi/scripts/clipboard.sh --delete      # delete mode
172```
173 
174- Lists recent clipboard entries from cliphist
175- Default mode (`SUPER+V`): decodes and copies selected entry back to clipboard
176- Delete mode (`SUPER+SHIFT+V`): removes selected entry from clipboard history
177- Starts cliphist store daemon if not running
178- Keyboard navigable via rofi
179 
180### `spotlight.sh`
181 
182Spotlight-style search (`ALT+SPACE`). One rofi prompt that searches installed
183applications, files, folders and the web — live suggestions as you type, each
184with its icon (app logo, folder icon, or browser logo). On-demand only: rofi
185exits when the menu closes, no background daemon.
186 
187```bash
188~/.config/rofi/scripts/spotlight.sh
189```
190 
191- Type to filter apps / folders / files under `$HOME` live
192- `Search the web` (always visible at the top) opens the default browser with
193  the typed query; pressing Enter with no matching row also does a web search
194- Apps launch via their `.desktop` entry; files/folders open in the default
195  file explorer (`$FILE_EXPLORER`)
196- Uses the same matugen-generated rofi template theme as the launcher
197  (`launcher.rasi`); defaults are read from `hypr/defaults.lua`
198  (`BROWSER`, `FILE_EXPLORER`)
199 
200### `system-power.sh`
201 
202Power management menu.
203 
204```bash
205~/.config/rofi/scripts/system-power.sh
206```
207 
208Options:
209- **Lock** — `hyprlock`
210- **Logout** — `hyprctl dispatch exit`
211- **Sleep** — `systemctl suspend`
212- **Reboot** — `systemctl reboot`
213- **Shutdown** — `systemctl poweroff`
214- **Cancel** — Close menu
215 
216Uses themed SVG icons from rofi icons directory.
217