Nothin' to see here but some invisible files.

prereqs

iTerm

Set up SSH... generate new keypair add GitHub stuff to ~/.ssh/config if it's not there already ssh-add the privkey... finally let GitHub know about the pubkey

Clone the repo

setup

zsh

Install oh-my-zsh to configure zsh.

Homebrew

Install Homebrew and then:

brew install \
  asdf \
  lua luarocks \
  neovim \
  ripgrep fzf fd \
  chafa \
  entr \
  difftastic \
  dos2unix

install these dotfiles

ln -s .zshrc   ~
ln -s .zshenv  ~
ln -s alxndr.zsh-theme  ~/.oh-my-zsh/themes
mkdir -p ~/.config
ln -s nvim        ~/.config/
ln -s .gitconfig  ~/.config/

asdf setup

asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git \
  && asdf install nodejs latest
asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git \
  && asdf install ruby latest

neovim setup

It'll start off saying "module 'paq' not found" because you gotta install it separately first...

git clone --depth=1 https://github.com/savq/paq-nvim.git \
    "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/pack/paqs/start/paq-nvim

Then install the other modules...

nvim -c 'PaqInstall|TSUpdate'

Might then complain about "Node JS not found: node is not executable!" if you haven't done something like asdf install nodejs latest...

...or Vim(lua):E5108: Error executing lua .../start/nvim-treesitter/lua/nvim-treesitter/highlight.lua:14: attempt to index local 'hlmap' (a nil value)

[Unison] backup tool

• docs
• wiki
• home

other things

• Inconsolata for Powerline or other patched fonts
• iTerm 2
  • Settings > General
    • in Window tab, uncheck "Native full screen windows"
      • in earlier versions, this was labeled "Use Lion-style fullscreen windows"
  • Settings > Profile
    • newer versions have "Use built-in Powerline glyphs": Prefs > Profiles > Text > Text Rendering
      • older: use Inconsolata for Powerline as the font
    • /bin/zsh as the login shell
    • blinking cursor
    • unlimited scrollback
• LittleSnitch
• SizeUp

OS/version-specific notes

macOS 13 (Ventura)

2021 MBP

• Prefs...
  • Keyboard
    • Dvorak layout inder Input Sources
    • turn on "Keyboard navigation" (tab / shift-tab)
    • "Press 🌐 key to": "Show Emoji & Symbols" 🎉
    • "Keyboard Shortcuts…" button opens a panel, "Modifier Keys" tab lets you map Caps Lock to Control
  • Mouse / Trackpad
    • tap-to-click
    • double-tap-to-right-click
  • Accessibility
    • "three-finger drag" is in Accessibility > Pointer Control > Trackpad Options button, "Enable dragging": "with three finger drag" (make sure there's no 'normal' 3-finger gesture which conflicts)
    • "Reduce motion" option in Display
• Auto-Hide Dock (right-click the dock, "Turn Hiding On")
• iTerm 2
• Karabiner
• Bartender

macOS 12 (Monterey)

2020 MBP

• Prefs...
  • "three-finger drag" is in Accessibility > Pointer Control > Trackpad Options button, "Enable dragging": "with three finger drag" (make sure there's no 'normal' 3-finger gesture which conflicts)
  • "Reduce motion" option 🎉 🍾 Accessibility > Display
  • use Tab to skip through buttons: Keyboard > Shortcuts tab > checkbox at the bottom "Use keyboard navigation to move focus forward..."
    • not the one in Accessibility > Keyboard > Navigation tab > "Enable Full Keyboard Access"
• Apps...
  • iTerm2 (of course)
  • Karabiner (to turn Enter into Control when held)
    • Complex Modifications > "Change return to control if pressed with other keys..."
    • installing Karabiner seems to moot the built-in CL-to-Ctrl mapping, so have to set it up in Karabiner as well
  • Markdown Editor

OS X 10.13 (High Sierra)

• dvorak keyboard
• karabiner needs permissions
• restore from Time Machine works pretty pretty pretty well

OS X 10.12

• Dvorak keyboard
• Karabiner
• Chrome: Warn Before Quitting

OS X 10.10.5

• Dvorak keyboard:
  • System Preferences > Keyboard > Input Sources, + button, English > Dvorak
• restore F-number keys:
  • System Preferences > Keyboard > Keyboard, check "Use all F1, F2, etc. keys as standard function keys"
• rip out the spell checker:
  • System Preferences > Keyboard > Text, uncheck "Correct spelling automatically"
• rip out a bunch of keyboard shortcuts:
  • System Preferences > Keyboard > Shortcuts, uncheck pretty much everything except for the Screen Shots
• turn off hold-letter-for-accent-marks:
  • defaults write -g ApplePressAndHoldEnabled -bool false
• enable using Tab to move keyboard focus between all sorts of GUI controls
  • System Preferences > Keyboard > Shortcuts, under "Full Keyboard Access […]" select the "All controls" radio button
• turn Caps Lock into Control
  • System Preferences > Keyboard > Modifier Keys button > set Caps Lock to Control
• make the trackpad make sense:
  • System Preferences > Trackpad > Point & Click > check only "Tap to click", "Secondary click", "Three finger drag"
  • System Preferences > Trackpad > Scroll & Zoom > check only "Scroll direction: natural"
  • System Preferences > Trackpad > Scroll & Zoom > check only "Notification Center", "Mission Control", "Show Desktop"
• only show one OS X Menu Bar when using multiple monitors:
  • System Preferences > Mission Control > uncheck "Displays have separate Spaces", then re-login