Files
.dotfiles/README.md
tri 34e978e84c refactor: group stow packages into common, mac and kde
Split the packages by platform so each app stays an opt-in Stow package
under common/, mac/ or kde/. KDE gets its own Fastfetch, Helium and
Spectacle packages, and darwin-breeze becomes kde/theme. The READMEs
document stowing a whole group as well as individual packages.
2026-10-30 21:57:15 +07:00

1.9 KiB

Personal dotfiles

These are my config files for macOS and KDE, managed with GNU Stow. You need stow and zsh installed.

Installation

git clone https://github.com/vokhactri/.dotfiles.git "$HOME/.dotfiles"
cd "$HOME/.dotfiles"

The packages are split into three groups:

  • common/ has Git, Micro, mpv, npm, Starship and Zsh.
  • mac/ has Ghostty and the original Fastfetch config.
  • kde/ has the Darwin Breeze theme, Helium, Konsole Fastfetch, Spectacle and tray icons.

Install all of common, then the group for your platform:

(cd common && stow -t "$HOME" */)
(cd mac && stow -t "$HOME" */)   # macOS
(cd kde && stow -t "$HOME" */)   # KDE

*/ matches every package in the group. Each line runs in a subshell, so you stay in the repo root and can run them one after another. KDE needs a few more steps after this. They're in kde/README.md.

Picking packages

You don't have to install everything. List only the packages you want:

stow -d common -t "$HOME" git zsh starship
stow -d mac -t "$HOME" ghostty
stow -d kde -t "$HOME" spectacle fastfetch

-d tells Stow which group to read from. -t puts the symlinks in your home directory. You can mix packages from different groups. Fastfetch is the exception. Install mac/fastfetch or kde/fastfetch, never both.

Previewing and removing

-n -v prints what Stow would do and changes nothing. -D removes the symlinks. Pass the same -d and -t you used to install:

stow -n -v -d kde -t "$HOME" spectacle
stow -D -d kde -t "$HOME" spectacle

Once the Zsh config is linked, run exec zsh to reload the shell.

Credits