bitzdots

gitlab

Lean Hyprland dotfiles with automatic matugen theming. Low-end optimized, full-stack auto-coloring, 26 Jinja2 templates. Rofi-powered menus, waybar modules, screenshot/recording, event-driven cache daemon.

0 stars0 forksupdated 2d agodefault branch: matugenExtended

Download .tar.gz View on gitlab ↗View on github ↗

clonehttps://gitlab.com/bitzzdev/bitzdots.git

archlinuxdotfileshyprlandhyprland-dotfileslow-endminimalricingwallustwaybarwayland

@ matugenExtended

2.7 KBtext

Raw View on gitlab ↗

1# Getting Started
2 
3Quick start guide for first-time bitzdots users.
4 
5## Prerequisites
6 
7- A working Hyprland installation
8- Git
9- `~/.config/` directory exists
10- Basic familiarity with the terminal
11 
12## One-Command Install
13 
14```bash
15git clone https://github.com/bitzzdev/bitzdots.git ~/.config/bitzdots
16cd ~/.config/bitzdots
17chmod +x install.sh
18./install.sh --with-deps
19```
20 
21This will:
221. Detect your distro (Arch, Fedora, Debian, NixOS)
232. Install all required packages
243. Link all config files to `~/.config/`
254. Install JetBrainsMono Nerd Font
265. Enable the wallpaper cache systemd service
276. Set fish as your default shell
287. Create screenshot directories
298. Generate an initial theme from your first wallpaper
30 
31## After Installation
32 
33### 1. Log Out and Back In
34 
35After running the installer, log out of your current Hyprland session and log back in. The `autostart.lua` script will launch:
36 
37- Waybar (status bar)
38- SwayNC (notification center)
39- Polkit authentication agent
40- Cliphist (clipboard history)
41- Awww daemon (animated wallpapers)
42- Your last wallpaper
43 
44### 2. Set Your First Wallpaper
45 
46Press `SUPER + SHIFT + W` to open the wallpaper picker, or run:
47 
48```bash
49~/.config/matugen/wallpaper-select.sh
50```
51 
52Select an image — the theme generates automatically and all components update.
53 
54### 3. Learn the Keybindings
55 
56Essential shortcuts:
57 
58| Key | Action |
59|-----|--------|
60| `SUPER + T` | Open terminal (kitty) |
61| `SUPER + Space` | App launcher (rofi) |
62| `ALT + Space` | Spotlight search (files + folders + web) |
63| `SUPER + Q` | Close window |
64| `SUPER + V` | Clipboard history |
65| `SUPER + SHIFT + S` | Selection screenshot |
66| `Print` | Fullscreen screenshot |
67| `SUPER + N` | Toggle notifications |
68| `SUPER + SHIFT + W` | Wallpaper picker |
69 
70Full list: [Keybindings](keybindings.md)
71 
72### 4. Customize
73 
74- **Change colors**: Just change the wallpaper. Everything follows
75- **Modify templates**: Edit files in `~/.config/matugen/templates/`
76- **Add new components**: See [Customization](customization.md)
77 
78## First-Time Tweaks
79 
80### Power Profiles
81 
82If your system supports it, cycle power profiles via the waybar power icon, or:
83 
84```bash
85~/.config/waybar/scripts/power-profile-switch.sh
86```
87 
88### Screenshots
89 
90- `Print` → saves to `~/Pictures/Screenshots/Fullscreen/` + clipboard
91- `SUPER + SHIFT + S` → select region, saves to `~/Pictures/Screenshots/Freeform/` + clipboard
92 
93### Screen Recording
94 
95- `SUPER + R` → toggle fullscreen recording
96- `SUPER + SHIFT + R` → toggle region recording
97 
98Saved to `~/Videos/Recordings/Fullscreen/` and `~/Videos/Recordings/Region/`.
99 
100## What's Next?
101 
102- Read the [Features](features.md) overview
103- Explore the [Waybar Modules](waybar-modules.md)
104- Learn how [Theming](theming.md) works
105- Check [Performance](performance.md) optimization tips
106