Installation

cd ~
git clone git@github.com:kortina/dotfiles.git
cd dotfiles
git submodule update --init
./setup.sh

You should see the following output on successful install:

✅ ✅ ✅ 🎉 🎉 🎉

NB: If you want s3screenshots, you will need to install following the README

Docs

You will need to do the following if you are setting up a new machine with MacOS.

At generating a new ssh key do this:

ssh-keygen -t ed25519 -C "your_email@example.com"

Then:

eval "$(ssh-agent -s)"
> Agent pid 59566

touch ~/.ssh/config
Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Then at connecting to GitHub with ssh

pbcopy < ~/.ssh/id_ed25519.pub

And at Settings → Keys, paste the new key into the text area.

Other Pre-Requirements

• Must install Xcode before running ./setup.sh
• 1Password
  • Copy ~/.sh_secrets to HOME
• GitHub
• Google Drive
  • 
  • Set the local path to ~/gd
  • Set the Drive to Mirror files
• Applications → Screenshot → Options → Show Floating Thumbnail

Other Post-Requirements

• Ad Block Plus for Safari ABP
• Alfred
  • In Left Bar, choose Advanced then Set preferences folder... to ~/dotfiles/Alfred-Settings
• Cyberduck
• brew
  • brew install --cask calibre
• dotfiles
  • dotfiles/ses-emailer-cli - this SHOULD just work (assuming you have ~/.sh_secrets setup)
  • dotfiles/s3screenshots
  • dotfiles/themes/fonts - install the MesloLGS NF fonts
  • src/sq - install secrets and run sq dev project-init dev eg
• iStat Menus
• Resolve
  • ~/gd/__z/Fonts/_unzipped - install these
• Spotify
• System Settings
  • Connect Google Contacts in Internet Accounts
  • Turn on:
    • Keyboard: Key Repeat Rate and Delay Until Repeat
    • Keyboard → Keyboard shortcuts...
      • Spotlight: Show Spotlight search to ⌥Space
      • App Shortcuts
        • Safari
          • Show Reader to ⌥R
          • Safari Help to ⌥⇧/
    • Reduce Motion
    • Reduce Transparency
    • Trackpad: Tracking speed and Click
    • Notifications: Alfred
• Transmission
• VLC
• Visual Studio Code
  • Run > Shell Command: Install 'code' command in PATH
• Zoom
• Amphetamine
• Resolve

Details

setup.sh will run all of the following setup scripts:

• setup-homebrew.sh - install and update homebrew.
• setup-deps.sh - install all dependencies, such as docker and other libs and packages.
• setup-symlinks.sh - create symlinks from your home directory to any files that begin with a . in your ~/dotfiles directory.
• setup-osx.sh - configure some osx preferences.

Each of this scripts can also be run independently (which may be faster for making small changes).

FAQ

• If you get a permissions error, I recommended setting yourself as owner of /usr/local:

sudo chown -R "`id -u -n`:admin" /usr/local

Themes

    # install terminal theme
    open "themes/tomorrow-theme/OS X Terminal/Tomorrow Night.terminal"

fzf

setup-deps.sh will run brew install fzf which creates ~/.fzf.bash and ~/.fzf/. In my ~/.bash_mac I source ~/.fzf.bash to get all of the default terminal keybindings for fzf like ctrl-r for history search. Then, I have my personal fzf settings in ~/.fzf.conf.bash

Last time I setup a machine, I had to run the vim setup to get fzf working...

Questions

If something is unclear, please add an issue: https://github.com/kortina/dotfiles/issues