Dot-Files

This contains all of my dot files and step-by-step instructions on how to build an Arch distribution similar to mine. Most configurations are detailed with comments. All dot files are purposefully compact with little ricing.

Installation

Aside from referencing the configuration files directly, you can use stow to automatically install any one or multiple of the configurations in this repository. This repository uses GNU Stow for managing symlinks.

# Packages are 'installed' by merely symlinking the files to their destinations
sudo pacman -S stow

# Clone the repository
git clone https://github.com/NathanielInman/dot-files.git ~/Sites/dot-files
cd ~/Sites/dot-files

# List available packages
./install.sh -l

# Install all packages
./install.sh -a

# Install specific packages
./install.sh nvim zsh starship

# Uninstall a package
./install.sh -u nvim

# Restow after pulling updates
./install.sh -r nvim

Available Packages

Package	Description
kitty	Terminal emulator
git	Git configuration
hyprland	Wayland compositor
nushell	Modern shell
nvim	NeoVim with NvChad
walker	Application launcher
starship	Shell prompt
swaync	Notification center
topgrade	Upgrade-everything cfg
vim	Vim configuration
waybar	Status bar
zsh	Zsh + Oh-My-Zsh theme

System-level files that can't be stowed (because they live outside $HOME) are tracked under etc/ and usr/ as copies. Install them via ./install.sh -s, which prompts for each one. Currently covers:

• etc/pacman.d/hooks/hyprpm.hook — rebuilds hyprpm plugins automatically after Hyprland upgrades so boot doesn't complain about outdated plugin headers.

Automation

scripts/ holds a few cron helpers (set up via crontab -e, see docs/setting-up-archlinux.md):

• cron-git-notes-auto-update.sh / cron-git-tasks-auto-update.sh — keep the notes and todo repos synced hourly.
• cron-sites-nightly-backup.sh — a 3am safety net so no uncommitted work in ~/Sites is ever lost to a dead disk. Owned repos get an atomic commit + push on the current branch; every other dirty repo is snapshotted non-destructively to a backup/auto/<host>/<branch> ref on its remote. Full write-up: docs/sites-nightly-backup.md.

Tip

Clicking on the icons below will lead directly to this repositories documentation on how to setup said operating system or tool.

My Everyday Stack

My Common Stacks

Who Am I

I'm a software engineer who makes Roguelikes for fun, enjoys WebGL, javascript, golang & rust.