dotfiles

This is a repo containing my dotfiles as well as some personal notes I've taken about Linux system configuration. The dotfiles themselves primarily reside in .config, except for a very small number of them which reside at the repo root due to having the intended installation target in the user's home directory.

Installation

The easiest way to install the dotfiles is with the included install script:

git clone https://codeberg.org/pezcore/dotfiles.git ~/.dotfiles && cd ~/.dotfiles
./install.sh

This will create a set of symbolic links under $HOME/.config each of which points to the corresponding file under .config in this repo. This symlink-based installation method is recommended because it allows changes to the files to be tracked in git while also appearing to be located where the XDG_CONFIG_HOME programs expect them. The presence of symlinks in the appropriate location pointing to the appropriate files is all that constitutes and installation of the dotfiles: no executable logic is necessary to perform installation. Note that the install script will create symlinks with absolute path targets which means if you move this repo, all links will break and you will have to uninstall and rerun the install scripts.

If you want you can also install with GNU Stow:

stow --no-folding -t ${XDG_CONFIG_HOME:-$HOME/.config} .config

Uninstallation

To uninstall the dotfiles, simply remove the symlinks that point here. Here is a useful command to remove all symlinks pointing here:

find ~/.config -type l -lname "*$PWD*" -delete

CAUTION: This command will delete ALL files matching the criteria is not reversible, use with extreme caution

Manual Installation

If you can't or wont use automatic installation methods, you can install the configs manually by either creating symbolic links or copying files to your config directory, for example:

ln -s /path/to/thie/repo/.config/alacritty/alacritty.toml ~/.config/alacritty/alacritty.toml

or

cp /path/to/thie/repo/.config/alacritty/alacritty.toml ~/.config/alacritty/alacritty.toml

New System Initialization

This repo contains a list of recommended software to install on a brand-new Void Linux installation. To install it, run:

sudo xbps-install $(cat new-system-init/install-list-void.txt)