Most config is managed using GNU Stow. Once you have installed Stow (avaialble in most distros' package managers), you can use this repo as follows:
- Clone this repo to
~/dotfiles/. - Change your shell's working directory to
~/dotfiles/. - Run
stow <package name>, where is the name of one of the directories at the root of this repo.
Stow will create symlinks to the files and/or directories in the package directory from the same place relative to ~/. For example, because the ./tmux/ directory contains .tmux.conf, stow tmux will result in a symlink from ~/.tmux.conf to ~/dotfiles/tmux/.tmux.conf. Similarly, stow wezterm will result in a symlink from ~/.config/wezterm/ to ~/dotfiles/wezterm/.config/wezterm/.
While most directories at the root of this repo are stow packages, there are exceptions:
- The
./gnome/directory contains a gnome-dconf.ini file with some setting overrides that I like. Rundconf load / < ~/dotfiles/gnome/gnome-dconf.inito overwrite the corresponding settings on your system. You may want to back up your dconf settings first:dconf dump / > ~/.config/dconf/user.bak.