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
5.8 KBtext
Raw View on gitlab ↗
1# Installation
2 
3bitzdots supports Arch Linux, Fedora, Debian/Ubuntu, and NixOS. Choose your method below.
4 
5## Automated Install (Recommended)
6 
7```bash
8git clone https://github.com/bitzzdev/bitzdots.git ~/.config/bitzdots
9cd ~/.config/bitzdots
10chmod +x install.sh
11 
12# Install configs only (no system packages):
13./install.sh
14 
15# Install configs + system packages:
16./install.sh --with-deps
17```
18 
19The installer auto-detects your distro and installs the appropriate packages.
20 
21## Manual Install
22 
23### 1. Install Packages
24 
25Choose your distro:
26 
27<details>
28<summary><b>Arch Linux</b></summary>
29 
30```bash
31# Official repos
32sudo pacman -S waybar swaync rofi kitty cava awww hyprpicker wl-clipboard \
33  playerctl pavucontrol polkit-kde-agent grim slurp cliphist hyprlock \
34  ffmpeg impala bluetui btop pulsemixer wf-recorder python breeze \
35  inotify-tools imagemagick fastfetch fish power-profiles-daemon \
36  qt5ct qt6ct
37 
38# AUR (using paru or yay)
39sudo pacman -S matugen ttf-jetbrains-mono-nerd
40```
41</details>
42 
43<details>
44<summary><b>Fedora</b></summary>
45 
46```bash
47sudo dnf install waybar swaync wlogout rofi kitty cava awww hyprpicker \
48  wl-clipboard playerctl pavucontrol polkit-kde-agent grim slurp \
49  cliphist hyprlock ffmpeg inotify-tools ImageMagick fastfetch fish \
50  power-profiles-daemon
51 
52cargo install matugen
53```
54</details>
55 
56<details>
57<summary><b>Debian/Ubuntu</b></summary>
58 
59```bash
60sudo apt install waybar swaync wlogout rofi kitty cava awww hyprpicker \
61  wl-clipboard playerctl pavucontrol polkit-kde-agent grim slurp \
62  cliphist hyprlock ffmpeg inotify-tools imagemagick fastfetch fish
63 
64cargo install matugen
65```
66</details>
67 
68<details>
69<summary><b>NixOS</b></summary>
70 
71```nix
72{ config, pkgs, ... }:
73{
74  environment.systemPackages = with pkgs; [
75    waybar swaync wlogout rofi kitty cava hyprpicker
76    wl-clipboard playerctl pavucontrol polkit-kde-agent
77    grim slurp cliphist hyprlock ffmpeg btop 
78    inotify-tools imagemagick fastfetch fish
79    matugen python3
80  ];
81}
82```
83</details>
84 
85### 2. Link Configuration Files
86 
87```bash
88DOTFILES_DIR="$HOME/.config/bitzdots"
89CONFIG_DIR="$HOME/.config"
90 
91# Hyprland
92for f in "$DOTFILES_DIR/hypr"/*.lua; do
93  ln -sf "$f" "$CONFIG_DIR/hypr/$(basename "$f")"
94done
95 
96# Waybar
97ln -sf "$DOTFILES_DIR/waybar/config.jsonc" "$CONFIG_DIR/waybar/config.jsonc"
98ln -sf "$DOTFILES_DIR/waybar/style.css" "$CONFIG_DIR/waybar/style.css"
99for s in "$DOTFILES_DIR/waybar/scripts"/*.sh; do
100  ln -sf "$s" "$CONFIG_DIR/waybar/scripts/$(basename "$s")"
101done
102 
103# Rofi
104ln -sf "$DOTFILES_DIR/rofi/config.rasi" "$CONFIG_DIR/rofi/config.rasi"
105ln -sf "$DOTFILES_DIR/rofi/theme-generated.rasi" "$CONFIG_DIR/rofi/theme-generated.rasi"
106for d in themes colors scripts launchers icons; do
107  mkdir -p "$CONFIG_DIR/rofi/$d"
108  for f in "$DOTFILES_DIR/rofi/$d"/*; do
109    ln -sf "$f" "$CONFIG_DIR/rofi/$d/$(basename "$f")"
110  done
111done
112 
113# SwayNC
114ln -sf "$DOTFILES_DIR/swaync/config.json" "$CONFIG_DIR/swaync/config.json"
115ln -sf "$DOTFILES_DIR/swaync/style.css" "$CONFIG_DIR/swaync/style.css"
116 
117# Kitty
118ln -sf "$DOTFILES_DIR/kitty/kitty.conf" "$CONFIG_DIR/kitty/kitty.conf"
119 
120# Cava
121ln -sf "$DOTFILES_DIR/cava/config" "$CONFIG_DIR/cava/config"
122for f in "$DOTFILES_DIR/cava/shaders"/*; do
123  ln -sf "$f" "$CONFIG_DIR/cava/shaders/$(basename "$f")"
124done
125 
126# Wlogout
127ln -sf "$DOTFILES_DIR/wlogout/style.css" "$CONFIG_DIR/wlogout/style.css"
128ln -sf "$DOTFILES_DIR/wlogout/layout" "$CONFIG_DIR/wlogout/layout"
129for f in "$DOTFILES_DIR/wlogout/assets"/*; do
130  ln -sf "$f" "$CONFIG_DIR/wlogout/assets/$(basename "$f")"
131done
132 
133# Matugen
134ln -sf "$DOTFILES_DIR/matugen/config.toml" "$CONFIG_DIR/matugen/config.toml"
135for t in "$DOTFILES_DIR/matugen/templates"/*; do
136  ln -sf "$t" "$CONFIG_DIR/matugen/templates/"
137done
138 
139# Scripts
140for s in "$DOTFILES_DIR/scripts"/*.sh; do
141  ln -sf "$s" "$CONFIG_DIR/matugen/$(basename "$s")"
142done
143 
144# GTK
145ln -sf "$DOTFILES_DIR/gtk/gtk-3.0/settings.ini" "$CONFIG_DIR/gtk-3.0/settings.ini"
146ln -sf "$DOTFILES_DIR/gtk/gtk-4.0/settings.ini" "$CONFIG_DIR/gtk-4.0/settings.ini"
147 
148# Qt dark theme
149mkdir -p "$CONFIG_DIR/qt5ct"
150ln -sf "$DOTFILES_DIR/qt5ct/qt5ct.conf" "$CONFIG_DIR/qt5ct/qt5ct.conf"
151# qt6ct config is auto-generated by matugen from template
152mkdir -p "$CONFIG_DIR/environment.d"
153ln -sf "$DOTFILES_DIR/environment.d/qt.conf" "$CONFIG_DIR/environment.d/qt.conf"
154 
155# Fish
156mkdir -p "$CONFIG_DIR/fish"
157ln -sf "$DOTFILES_DIR/fish/config.fish" "$CONFIG_DIR/fish/config.fish"
158 
159# Fastfetch
160mkdir -p "$CONFIG_DIR/fastfetch"
161ln -sf "$DOTFILES_DIR/fastfetch/config.jsonc" "$CONFIG_DIR/fastfetch/config.jsonc"
162ln -sf "$DOTFILES_DIR/fastfetch/bitz.txt" "$CONFIG_DIR/fastfetch/bitz.txt"
163```
164 
165### 3. Systemd Service
166 
167```bash
168mkdir -p "$CONFIG_DIR/systemd/user"
169cp "$DOTFILES_DIR/systemd/user/matugen-cache-daemon.service" \
170   "$CONFIG_DIR/systemd/user/matugen-cache-daemon.service"
171systemctl --user daemon-reload
172systemctl --user enable --now matugen-cache-daemon.service
173```
174 
175### 4. Install Font
176 
177```bash
178# Arch (AUR)
179paru -S ttf-jetbrains-mono-nerd
180 
181# Or download manually from https://www.nerdfonts.com/
182```
183 
184### 5. Generate Initial Theme
185 
186```bash
187matugen image ~/Pictures/Wallpapers/your-wallpaper.jpg --config ~/.config/matugen/config.toml \
188  --config-dir ~/.config/matugen
189```
190 
191### 6. Set Fish as Default Shell (Optional)
192 
193```bash
194chsh -s $(which fish)
195```
196 
197Log out and back in for the change to take effect.
198 
199## Post-Installation Checklist
200 
201- [ ] Waybar is visible at the top of the screen
202- [ ] Pressing `SUPER + T` opens kitty
203- [ ] Pressing `SUPER + Space` opens rofi launcher
204- [ ] Pressing `Print` saves a screenshot
205- [ ] `SUPER + SHIFT + W` opens the wallpaper picker
206- [ ] Changing the wallpaper updates all colors
207- [ ] Notifications appear and the control center opens with `SUPER + N`
208- [ ] The wallpaper cache daemon is running: `systemctl --user status matugen-cache-daemon.service`
209- [ ] All apps default to dark theme (GTK, Qt, kitty, etc.)
210 
211## Troubleshooting
212 
213See the [FAQ](faq.md) for common issues.
214