README.md

the files that makes me feel at ~/

🏠 Dotfiles

My personal dotfiles, installed and managed with dotbot.

Note

This is as XDG Base Directory Standard compliant as possible!

Highlights

• .config/ - I've spent quite some effort to make my dotfiles adhere to the XDG Base Directory Standard as much as possible, using and contributing to the Arch wiki page. As far from all programs that I use support this natively, quite some custom configuration needed to be done. Grep for XDG in shell/commons.
  • dotbot/install.conf.yaml - how these dotfiles are installed.
  • nvim/ - check out my Neovim configurations; they are pretty cool!
• bin/ - many handy and time saving scripts.
  • brew_upgrade.sh - interactively upgrade a Homebrew system.
  • macos_touchid_sudo_enable.sh - enable sudo with TouchID.
  • pdf_compress.sh - compress file size of PDFs!
  • permute_aliases.sh - generate shell aliases on all permutations of a command; for fast typers!
  • ssh-keygen.sh - interactively create SSH keys using a nicely structured .ssh/config file.

Installation

Bootstrap

Bootstrap using bin/dotfiles_bootstrap.sh:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/erikw/dotfiles/main/bin/dotfiles_bootstrap.sh)"

This will interactively set up a GitHub SSH key, clone this repo and run ./install.

Local branch

Switch to a local branch for secret changes:

cd ~/src/github.com/erikw/dotfiles
git checkout -b local

and after making some changes to the branch, squash to one commit:

git commit -m "SQUASHED passwords"

Host-specific configuration

• Passwords and other secretes are censored. To find these and substitute them for the real thing, do:

   grep -nr GIT-CENSORED . | grep -v README.md | grep -v "/.git/"

• Set DESKTYPE in $XDG_CONFIG_HOME/shell/commons, unless system is macos.
• Default desktop is assumed to be macOS. Go through host-specific manual settings by searching for the corresponding tag.

   grep -nr MACOS-CONFIG . 2>/dev/null | grep -v README.md
   grep -nr LINUX-CONFIG . 2>/dev/null | grep -v README.md
   grep -nr FREEBSD-CONFIG . 2>/dev/null | grep -v README.md

GitHub SSH Config File

To ensure success, use a manual entry like this (modify output from [bin/ssh-keygen.sh]:

~/.ssh/config

Host github.com
	User git
	Port 22
	PreferredAuthentications publickey
	IdentityFile ~/.ssh/identityfiles/REDACT