README.md

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
• ripgrep - fast file search
• stylua - lua formatter
• gnu-sed - text manipulation
• LazyGit - terminal UI for git with VI bindings
• 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
• XCodes - XCode version manager
• Insomnia - REST GUI
• Raycast - replacement for Mac Spotlight
• CleanShot X - better screenshots
• Microsoft Edge - personal Browser
• Beyond Compare - 3-way merge
• DisplayLink Manager - external display support through Dell dock

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 main tools

brew tap homebrew/cask-fonts
brew install \
  neovim  \
  ripgrep \
  stylua  \
  lazygit \
  gnu-sed \
  font-jetbrains-mono-nerd-font \
  starship \
  fd \
  bat \
  eza \
  procs \
  sd \
  zoxide \
  dust \
  tokei \
  hyperfine \
  git-delta

6. Install quality-of-life tools

brew install \
  bluesnooze

brew install --cask \
  wezterm \
  1password \
  xcodes \
  insomnia \
  raycast \
  cleanshot \
  microsoft-edge \
  beyond-compare \
  displaylink