NOTE: While this once was a dedicated place where you could find every computer/OS configuration customization, it's not quite as comprehensive anymore since I've started doing cloud backups for my entire filesystem. Moving to this saves me energy (don't need to find a way to automate it in this repository, e.g. with a shell script). It also gives me confidence that my computer, its files, config, etc. will never be lost. That being said, this repository is not a wasteland -- it still has many useful auomations, my config for things like shells and Vim, and I still put other things in here from time to time.
You may need to restart your mac between some of these steps, but if you can defer until as late in this process as possible, do so to keep the number of reboots to a minimum.
On a brand new installation of macOS:
sudo softwareupdate -i -a
xcode-select --install
sudo softwareupdate -i -a
(updates Apple software like Safari)xcode-select --install
(install dev tools, likegit
andmake
)bash -c "`curl -fsSL https://raw.githubusercontent.com/bowernite/dotfiles/master/remote-install.sh`"
(clones this repo to the machine)cd ~/src/personal/dotfiles && source bootstrap.sh
- Add any sensitive data to zshrc__private
export __a_secret=
macos/dock.sh
(sets up the dock for the first time on a new machine)
I try to automate everything I can, but here's everything I haven't yet (or won't at all).
Go through all apps in saved Bitwarden License Keys
note, and activate necessary apps with them.
- Turn off Spotlight keyboard shortcut (Alfred instead).
System Preferences
>Keyboard
>Shortcuts
>Spotlight
> Uncheck spotlight search - Save Trello (and Slack) as "apps" from Chrome (overflow menu >
More Tools
>Create shortcutβ¦
> checkOpen as new window
) - Rectangle β»οΈ: Open up Rectangle, and configure it how you'd like
- Bartender οΈπΈ: Open up Bartender, and configure it how you'd like
- Set
user.email
in~/src/work/.gitconfig
to work GitHub/GitLab account email (if applicable) - Follow the instructions here to set up iTerm theming based on macOS dark mode
- Use the script at the bottom of the page
- Install GitHub themes using these instructions
- In the script, change the dark and light themes to
GitHub Dark
andGitHub Light
(found [])
Keyboard remapping is done with the Karabiner-Elements app.
- Open up the Karabiner-Elements app >
Profile
> Rename the default toGoku
.
- If you use Dropbox, open the app and log in. Make sure any preferences are set up properly.
- Activate Powerpack with license key (without this, it won't look at the folder you're pointing at for synced settings, so this comes first)
- Sync settings with Dropbox using the "second mac" instructions here
- Set non-synced settings
- Global Alfred hotkey
- Theme (set one for dark theme and one for light theme, based on macOS dark/light)
- Set auto-expansion for snippets (top right checkbox in Snippets settings)
- Set Clipboard History preservation (probably to the max time limit)
- Make sure Alfred and its workflows have proper OS access. In Alfred's preferences, go to
General
>Permissions
>Request Permissions
, and let Alfred guide you π§ββοΈ - Exclude all
node_modules
from Spotlight:System Preferences
>Spotlight
>Privacy
: Drag folders from Finder into the drop area. You can easily find these by triggering Alfred and querying fornode_modules
- For use in VS Code and your terminal:
- Download the Dank Mono font (link to download it is in your password manager)
- Extract and open the downloaded zip
- Open the
OpenType-PS
directory - Double click on all the fonts, and click
Install Font
for each
- Configure vanilla macOS Terminal app:
- Open Terminal
- Open
Preferences > Profile
- Drag macos/terminal-theme.terminal into the pane with all of the profiles
- Select the font to be
Dank Mono Regular
,18 pt.
- Elsewhere in preferences, set that to be the default theme and window
- Authenticate with GitHub so that you can push from the CLI
- Follow the instructions here to create a personal access token (you'll need to do this, since having 2FA enabled on your GitHub account prevents you from using username+password from the CLI).
- Copy the generated token
- Go to any repo that's been cloned for you in
~/src/personal/
- Make a small change and commit it
git push
- Use your GitHub username (not email), and the token for the password
- If you want to be thorough and get as much of the setup done now vs. things popping up later, go through all of your apps and common websites and do anything applicable from the following. This will save a lot of interruptions and annoyance in your first week or so of starting to use the apps and websites you typically use.
NOTE: These might not be necessary if you're using a Time Machine/cloud backup.
- Login
- For apps, make sure any settings are properly synced or manually set
- Browsers
- Music Players
- VS Code/editor
- Apple Apps like iMessage and Contacts
- Super common websites, like GitHub, Google, email
The Issues page on GitHub contains concrete to-dos.
Here are some places to poke around at for inspiration for things you might want to do
- https://github.com/nikitavoloboev/dotfiles
- https://github.com/webpro/dotfiles
- https://github.com/mjackson/dotfiles
- Nikita's shell aliases: https://github.com/nikitavoloboev/dotfiles/blob/43568152bdade89cd331b45ee4db39a7036b2663/zsh/alias.zsh
- https://github.com/Kharacternyk/dotcommon
β¨ https://github.com/search?q=dotfiles β¨
- https://medium.com/@pechyonkin/how-to-map-capslock-to-control-and-escape-on-mac-60523a64022b
- https://www.legeektrotteur.com/mac-os-x-lock-caps-with-the-shift-key
- Remapping Cocoa Keybindings
- https://github.com/drliangjin/karabiner.d
- https://wiki.nikitavoloboev.xyz/macos/macos-apps/karabiner
- https://medium.com/@nikitavoloboev/karabiner-god-mode-7407a5ddc8f6