Mike's XDG config

This repo uses the XDG Base Direction Specification to organise config files. The official documentation is fairly sparse, so to get a better understanding of the system I'd recommend looking at the archlinux wiki.

This is just a recommendation. Feel free to deviate, but remember to update the values for the XDG environment variables. The defaults are defined in .zshenv.

NOTE: Only intended to be used on a Mac.

Requirements

• bash
• zsh
• git

Quickstart

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/mikeduminy/dotfiles/HEAD/bootstrap.sh)"

Software

• WezTerm - terminal emulator
• Neovim - new vim
• tmux - terminal multiplexer
• ripgrep - fast file search
• stylua - lua formatter
• gnu-sed - text manipulation
• LazyGit - terminal UI for git
• Starship - custom shell prompt
• fd - faster find
• bat - cat with syntax highlighting
• eza - better ls
• procs - modern ps
• sd - better, more intuitive sed
• zoxide - better cd
• dust - newer, faster du
• tokei - code line counter
• hyperfine - benchmarking tool
• git-delta - better git diff

Quality-of-life software

• Bluesnooze - sleeping mac = bluetooth off
• 1Password - password manager
• Bartender - menu bar management for mac
• Karabiner-Elements - keyboard customisation
• CleanShot X - better screenshots
• Firefox - personal Browser
• Beyond Compare - 3-way merge
• Colemak-dh - Colemak-dh keyboard layout

Manual installation

1. Clone this repo into ~/.xdg/config
2. Link the zsh config files from this repo to the root ones

ln -s ~/.xdg/config/zsh/.zshrc ~/.zshrc
ln -s ~/.xdg/config/zsh/.zshenv ~/.zshenv
ln -s ~/.xdg/config/zsh/.zprofile ~/.zprofile

3. If you are on Mac then for GUI programs launched from outside the terminal to detect your XDG config home you may also need to run this. This script is only run on log-in so log out and in to see it apply.

ln -s ~/.xdg/config/LaunchAgents/xdg-env-launch-agent.plist ~/Library/LaunchAgents/xdg-env-launch-agent.plist

4. Install homebrew (if you don't have it)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

5. Install all software

brew bundle install