Hyprland desktop configs managed with GNU Stow.

Configs live at the repo root:

dotfiles/
├── .config/
│   ├── hypr/             # Hyprland, scripts, keybinds
│   ├── waybar/           # Status bar
│   ├── kitty/            # Terminal
│   ├── rofi/             # App launcher / menus
│   └── btop/             # System monitor
├── .local/share/applications/
├── wallpapers/           # Linked to ~/Pictures/wallpapers on install
├── install.sh
└── packages.txt

install.sh uses GNU Stow to link .config/ and .local/ into $HOME. A generated stow/ directory (gitignored) holds Stow packages; edits in .config/... apply immediately via the symlinks. Re-run ./install.sh after adding new config directories.

git clone git@github.com:YOUR_USER/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

Skip apt installs if packages are already installed:

SKIP_PACKAGES=1 ./install.sh

1. Log into Hyprland
2. Launch waybar: ~/.config/waybar/launch.sh

Wallpapers live in wallpapers/ in the repo and are linked to ~/Pictures/wallpapers on install.

Edit files in .config/..., then re-run install if you add new packages:

cd ~/workspaces/dotfiles
SKIP_PACKAGES=1 ./install.sh

Or restow manually:

cd ~/workspaces/dotfiles
./install.sh

cd ~/dotfiles
git init
git add .
git commit -m "Initial dotfiles"
gh repo create dotfiles --private --source=. --push

Use a private repo unless you have audited for secrets.

Create untracked files under local/ or add a host profile later if laptop/desktop configs diverge.