tobyvin's .dotfiles
Install
git clone https://git.tobyvin.dev/.dotfiles && ./.dotfiles/install.sh
Getting started
The configuration files are managed using GNU stow and the dotfiles can be
installed solely by running stow */ from the repository's root.
Install script
A install.sh helper script is provided that will stow packages and run package
specific install scripts. It can be run with ./install.sh [package ..],
defaulting to operating on all packages if none are specified.
It stows the packages using the -R (restow) option, which will remove any
broken or missing symlinks belonging to the repository. Normally this spams the
output with UNLINK and LINK for every file in every package, so it's piped
through a small awk script to filter the output to only non-reverted actions.
Package specific install scripts
The install script will run any package specific install scripts that exist in
the root of a package directory, e.g. ./<pkgname>/install.sh.
Example usecases:
- Creating non-existent directories
- Enabling systemd user services
- Fixing file permissions
- Running one-time setup commands
- etc.
Example package install script
#!/bin/sh
pkgname=<pkgname>
if ! command -v "$pkgname" >/dev/null; then
printf '%s: %s not found, skipping...\n' "$0" "$pkgname"
exit 0
fi
mkdir -pv "${XDG_CACHE_HOME}/${pkgname}"
printf "%s: Installing service\n" "$0"
systemctl --user enable --now --no-block "${pkgname}.service"
More examples: zsh, pass, and nvim
Mirrors
I host this repository (and many others) on my local cgit instance, but it is also mirrored to both SourceHut and GitHub.