dotfiles

Arch Linux · Hyprland · Matugen — dynamic wallpaper-based theming

---

What is this

A minimal, dynamic rice for Arch Linux using Hyprland as the compositor. Colors are generated automatically from any wallpaper via Matugen — change your wallpaper and every app recolors itself to match.

Built on top of Omarchy with custom configs layered over the defaults.

Stack:

• WM: Hyprland (Wayland)
• Bar: Waybar (glassmorphic floating islands)
• Terminal: Ghostty
• Shell: Zsh + Starship prompt
• Theming: Matugen (Material You color extraction)
• Notifications: SwayNC
• Launcher: Walker + Rofi (picker shim for emoji/clipboard/keybindings/omarchy menus)
• Visualizer: Cava
• System monitor: btop
• Fetch: Fastfetch

---

Dependencies

Install everything with:

yay -S hyprland waybar ghostty matugen starship zsh lsd zoxide fzf \
       cava btop wl-screenrec walker swaync stow rofi \
       ttf-firacode-nerd hyprlock hypridle hyprsunset \
       xdg-desktop-portal-hyprland uwsm cliphist wl-clipboard

---

Install

git clone https://github.com/codetesla51/uthman_dotfiles.git ~/dotfiles
cd ~/dotfiles
chmod +x install.sh
./install.sh

The installer will:

1. Check for missing dependencies (warns, does not exit)
2. Create ~/.config/theme/current/ and ~/.config/theme/themes/snow_black/
3. Copy fallback colors so the rice works immediately
4. Create integration symlinks for btop and cava themes
5. Back up any existing config files that would conflict, then symlink everything via GNU Stow
6. Optionally run matugen to generate colors from your wallpaper

Existing configs are automatically backed up to ~/.config-backup-<timestamp>/ before stowing.

---

How theming works

Matugen reads a wallpaper image and generates a full Material You color palette, then writes color variables to every app's config via templates.

Apply a new wallpaper and regenerate all colors:

matugen image ~/Pictures/your-wallpaper.jpg

Color output locations:

• ~/.config/theme/current/ — active colors (written by matugen)
• ~/.config/theme/themes/snow_black/ — saved snapshot of the snow_black theme
• ~/.config/waybar/colors.css — waybar color variables (auto-updated)

Template files live in ~/.config/matugen/templates/ — one per app. Matugen fills in {{ colors.primary.default.hex }} style variables and writes the result to each app's config directory.

Apps themed by matugen: Waybar, Hyprlock, Ghostty, btop, Cava, Walker, SwayNC, GTK, Firefox, Chromium, Mako

---

Control Panel

A web UI for managing this rice — built in Go (single binary, no Node), frontend embedded in the binary. Runs as a systemd user service on http://localhost:8765.

cd ~/dotfiles/panel
go build -o panel main.go
systemctl --user enable --now omarchy-panel.service

What it controls:

• Dashboard — live CPU/RAM/battery/network charts, disk usage, quick controls (volume, brightness, DND)
• Theme — switch wallpapers (regenerates all matugen colors live), tweak matugen scheme type & contrast, Ghostty font/opacity/cursor, Hyprland effects (blur, shadows, animations, gaps)
• Logs — live journalctl streaming with source/priority filters and grep
• Binds — add/remove Hyprland keybinds (bindings.conf, auto-reloads Hyprland) and manage autostart apps
• Devices — monitors (mode/scale editor), audio, brightness, network info, waybar position, night light (hyprsunset), notifications (SwayNC + mako)
• Power — TLP profiles, battery health with charge/discharge estimates, lock/logout/suspend/reboot/shutdown, input devices (layout, repeat rate, natural scroll)
• Processes — sortable process list with RSS/memory, kill (SIGTERM/SIGKILL)

The panel writes to ~/dotfiles first (stow-aware: symlinks are respected), so every change is versioned in git.

---

Structure

~/dotfiles/
├── .config/
│   ├── ghostty/         # Terminal config
│   ├── rofi/            # Launcher themes + picker scripts (dmenu shim)
│   ├── waybar/          # Bar + scripts
│   ├── hypr/              # Hyprland config (personal, layered over omarchy)
│   │   ├── hyprland.conf  # Main config, sources omarchy defaults
│   │   ├── bindings.conf  # Personal keybindings (incl. rofi overrides)
│   │   ├── autostart.conf # Startup processes
│   │   ├── envs.conf      # Environment variables (PATH)
│   │   ├── monitors.conf  # Display setup
│   │   ├── input.conf     # Input devices
│   │   ├── looknfeel.conf # Look & feel
│   │   ├── hyprlock.conf  # Lock screen config
│   │   ├── hypridle.conf  # Idle management
│   │   ├── hyprsunset.conf# Blue-light filter
│   │   ├── xdph.conf      # Portal handler
│   │   ├── battery.sh     # Battery helper
│   │   ├── capslock.sh    # Capslock helper
│   │   ├── scripts/       # Helper scripts
│   │   └── shaders/       # Hyprland shaders
│   ├── fastfetch/       # Fetch config
│   ├── cava/            # Audio visualizer
│   ├── btop/            # System monitor
│   ├── swaync/          # Notification center
│   ├── starship.toml
│   └── matugen/
│       ├── config.toml  # Template paths and matugen settings
│       └── templates/   # Per-app color templates
├── .local/bin/
│   └── omarchy-launch-walker # Rofi/Walker dmenu shim (PATH via hypr/envs.conf)
├── panel/                # Web control panel (Go + embedded static UI)
│   ├── main.go           # API server (~30 endpoints)
│   ├── static/           # Embedded frontend (HTML/CSS/JS)
│   └── panel             # Built binary (gitignored)
├── .zshrc
├── Pictures/
│   └── logo.png         # Fastfetch logo
├── wallpapers/          # Wallpaper collection
├── theme-fallback/      # Static snow_black colors (used before matugen runs)
├── screenshot.png
├── install.sh
└── README.md

---

Note on Omarchy

This rice is built on top of Omarchy. Hyprland default bindings, envs, and window rules are sourced from Omarchy's system files at ~/.local/share/omarchy/default/hypr/. If you are not using Omarchy, you will need to supply your own hyprland.conf.

---

Credits

• Omarchy — Arch Linux + Hyprland distribution
• Matugen — Material You color generation
• Hyprland — Wayland compositor
• Waybar — Status bar
• Starship — Shell prompt
• FiraCode Nerd Font — Font