hyprConfig

1# hyprConfig: E-ink Dotfiles for Hyprland and Quickshell
2 
3Hyprland dotfiles configuration that builds a centered pill top bar using Quickshell, featuring dynamic Material You color palettes generated directly from your active wallpaper via matugen.
4 
5Maintained by Dev Borah ([@bitzzdev](https://github.com/bitzzdev)).
6 
7## Features
8 
9- Quickshell top bar: time indicator, workspaces switcher, audio volume, WiFi SSID, and battery status pill.
10- Calendar popover: click time indicator to toggle the interactive monthly calendar.
11- Dynamic color theming: wallpaper palette extracted in real time via `matugen image ... -j hex`.
12- Hyprland key bindings:
13  - `SUPER + T`: launch kitty terminal
14  - `SUPER + SHIFT + T`: run OCR on selected screen region and copy text to clipboard
15  - `SUPER + Q`: close focused window
16  - `SUPER + E`: launch nautilus file manager
17 
18## Installation
19 
20The repository is structured for deployment using GNU `stow`.
21 
22### One-command installer (Arch Linux)
23 
24```bash
25chmod +x ./install-arch.sh
26./install-arch.sh
27```
28 
29### Manual installation
30 
31```bash
32cd /path/to/hyprConfig
33stow -t "$HOME" dotfiles
34chmod +x ~/.local/bin/eink-wallpaper
35```
36 
37## Wallpaper and theme commands
38 
39To change wallpaper and automatically regenerate theme colors:
40 
41```bash
42eink-wallpaper /path/to/wallpaper.png
43```
44 
45To restore the saved wallpaper on graphical session start (invoked automatically via Hyprland `exec-once`):
46 
47```bash
48eink-wallpaper --restore
49```
50 
51## Connect
52 
53- Creator: [Dev Borah](https://bitz.is-a.dev)
54- GitHub: [bitzzdev](https://github.com/bitzzdev)
55- Ko-fi: [bitzzdev](https://ko-fi.com/bitzzdev)
56- Reddit: [u/bitzzdev](https://www.reddit.com/user/bitzzdev/)
57 
58## License
59 
60MIT License. Free to use, adapt, and share.
61