My Arch Hyprland Dotfiles

Opinionated Hyprland desktop dotfiles for Arch Linux, managed with GNU Stow.

This repository includes a complete desktop setup with:

• Hyprland + Hyprlock configuration
• Theme-aware Waybar / Wofi / Wlogout styling
• Wallpaper and theme switcher scripts
• A Neovim configuration (Lua-based)
• An install bootstrap script for core packages

---

Documentation Index

• Quick Start
• Themes & Wallpaper Workflow
• Keybindings Reference

---

Repository Layout

.
├── hypr/       # Hyprland config, scripts, wallpapers
├── waybar/     # Waybar config and per-theme styles
├── wofi/       # Wofi styles and per-theme styles
├── wlogout/    # Wlogout layout + per-theme styles
├── nvim/       # Neovim config
├── install.sh  # Arch bootstrap script
└── README.md

---

Included Features

• Theme switching UI via wofi (theme_toggle.sh)
• Wallpaper switching UI for active theme (wallpaper_switch.sh)
• Theme persistence across switches using cache files in ~/.cache
• Waybar hot-reload whenever theme changes
• Night light toggle via hyprsunset

---

Quick Usage

After setup and stowing:

• Super + Shift + T → choose full desktop theme
• Super + T → choose wallpaper for current theme
• Super + N → toggle night light

See full tables and setup steps in docs/.

---

Notes

• This setup assumes an Arch-based system.
• Theme scripts rely on assets being symlinked under ~/.config via Stow.
• If you maintain local changes, keep them in your fork/branch and restow when needed.