Dotfiles

Personal Linux/HyDE configuration for ricing Hyprland. All the documents are AI generated, view /linux-learning to view key workflows and a cheat sheet of the keybindings.

This repo intentionally tracks user-owned overrides, not the whole home directory and not generated HyDE state.

Before installing on a new machine, read PREREQUISITES.md.

What Is Tracked

• home/.config/hypr/userprefs.conf - personal Hyprland overrides.
• home/.config/hyde/config.toml - HyDE user config overrides.
• home/.config/kitty/kitty.conf - Kitty user config.
• home/.config/nvim - LazyVim starter config and lockfile.
• home/.config/pypr/config.toml - Pyprland scratchpad/dropdown config.
• home/.config/swaync/config.json - SwayNC notification center config.
• home/.config/swaync/style.css - SwayNC notification center theme.
• home/.config/zsh/user.zsh - HyDE Zsh user customizations.
• home/.tmux.conf - tmux copy mode and terminal workflow.
• home/.config/waybar/user-style.css - Waybar user CSS overrides.
• home/.config/waybar/layouts/workspace-media.jsonc - custom HyDE Waybar layout.
• home/.local/bin/media-menu - Rofi media controls backed by playerctl.
• home/.local/bin/screenshot-notify - screenshot notification actions.
• packages/ - package manifests.
• docs/ - personal workflow notes.

What Is Not Tracked

• Browser profiles.
• Login/session tokens.
• ~/.cache.
• HyDE generated Wallbash output.
• HyDE generated active Waybar config files, except tracked user CSS and custom layouts.
• ~/.config/cfg_backups.
• Full app state for Spotify, Discord/Vesktop, Steam, etc.

Install On A New Machine

Review first:

./install.sh --dry-run

Apply symlinks:

./install.sh

This script backs up existing files before replacing them with symlinks.

Package Manifests

Refresh package lists on the source machine:

pacman -Qqe > packages/pacman-explicit.txt
pacman -Qqm > packages/aur.txt
flatpak list --app --columns=application > packages/flatpak-apps.txt

On a new Arch machine, install packages selectively. Do not blindly install every package until you understand the list.

Official repo packages:

sudo pacman -S --needed - < packages/pacman-explicit.txt

AUR packages:

yay -S --needed - < packages/aur.txt

Flatpak apps:

xargs -r flatpak install -y flathub < packages/flatpak-apps.txt

Zsh Aliases

For this HyDE setup, put aliases and shell customizations in:

~/.config/zsh/user.zsh

HyDE uses ZDOTDIR=~/.config/zsh, so ~/.zshrc is not the best long-term place for portable aliases.

Neovim / LazyVim

This repo tracks the LazyVim starter config at:

home/.config/nvim

Useful files:

~/.config/nvim/lua/config/options.lua
~/.config/nvim/lua/config/keymaps.lua
~/.config/nvim/lua/plugins/

Install the recommended CLI helpers:

sudo pacman -S --needed neovim ripgrep fd nodejs npm lazygit gcc make unzip

Sync LazyVim plugins:

nvim --headless "+Lazy! sync" +qa