macOS Personal Profile Dotfiles

This project contains all of the configuration files I use for all of my macOS computers. When these files are linked to their appropriate places (using the configure.sh install script), my standard settings will be set up on that computer. These settings include important environment variables, terminal aliases, and scripts.

Installation

To install this project, run the following commands:

git clone https://github.com/garrettheath4/dotfiles-mac.git ~/dotfiles
cd ~/dotfiles
git submodule init && git submodule update
./configure.sh
./installApps.sh  # optional

mVim

mvim is a Bash script I created that launches a "mini Vim" window for quickly taking notes or temporarily pasting and manipulating text from the clipboard.

BetterTouchTool Shortcut

To make it easy to run this script, use BetterTouchTool to create a global keyboard shortcut (such as Control+Option+Command+V) that launches this script when the shortcut is pressed.

Moom

Use the ArrangeDualScreenWindows.scpt AppleScript script to resize the apps I like to put on the MacBook screen desktops when I have an external monitor attached (Spotify, Airmail 2, Calendar, and Todoist).

To use this script, make sure "When switching to an application, switch to a Space with open windows for the application" is checked in the Mission Control preference pane.

BetterTouchTool Shortcut

To make it easy to activate this script, use BetterTouchTool to create a global keyboard shortcut (such as Control+Shift+2) that runs this script when the shortcut is pressed.

Repository Contents

Repository Item	Description	Linking by configure.sh
configure.sh	A Bash script that creates links from the user's profile to the corresponding item in this repository (run once after cloning this repo)	self (run configure.sh once to create the links below)
installApps.sh	A Bash script that detects installed Mac applications and suggests the user to install any suggested apps that are not already installed	none (run installApps.sh once to install suggested apps)
Todoist-Tasks-macOS.csv	CSV file of tasks to set up a new macOS computer that can be imported into Todoist (Must be new project.)	none (import into Todoist to create tasks for setting up macOS)
Todoist-Tasks-Apps.csv	CSV file of tasks to configure apps on a new computer that can be imported into Todoist (Must be new project.)	none (import into Todoist to create tasks for configuring apps)
.bash_profile	Contains user Bash settings (runs every time the user opens up a Terminal window)	~/.bash_profile --> dotfiles-mac/.bash_profile
.tmux.conf	Contains Tmux configuration settings (Tmux is launched by .bash_profile every time the iTerm2 Hotkey window is opened)	~/.tmux.conf --> dotfiles-mac/.tmux.conf
.tmux-osx.conf	Contains Tmux configuration settings that are specific to an OS X environment (mostly just UI configuration)	~/.tmux-osx.conf --> dotfiles-mac/.tmux-osx.conf
.git-completion.bash	Allows tab-completion of Git commands in Bash	~/.git-completion.bash --> dotfiles-mac/.git-completion.bash
bin/	Contains Bash user scripts (mostly convenience scripts)	~/bin --> dotfiles-mac/bin/
sbin/	Contains Bash administrative scripts (mostly scripts containing sudo)	~/sbin --> dotfiles-mac/sbin/
.vimrc	Contains Vim startup settings	~/.vimrc --> dotfiles-mac/.vimrc
.vim/	Contains Vim plugins (mostly just the Vundle plugin manager for Vim stored as a Git submodule at .vim/bundle/Vundle.vim)	~/.vim --> dotfiles-mac/.vim/
.idlerc/	Contains Python IDLE settings	~/.idlerc --> dotfiles-mac/.idlerc/
.ideavimrc	Vim emulator configuration settings for IntelliJ IDEA when Vim-like edit mode is enabled	~/.ideavimrc --> dotfiles-mac/.ideavimrc
git-pre-commit-show-todos.sh	Git pre-commit script that searches for and shows any TODO items in a repo's files before commits (must be manually installed per repo)	none
Fractals-2560x1600/	HD wallpaper images from Beautiful Fractals	none
BetterTouchTool/	Backup of the default profile settings from the BetterTouchTool app	none
Moom/	Scripts that use the Moom app to rearrange windows to their desired locations on one or more screens	none
xbar/Scripts/	Scripts used by the xbar app to display script results in the OS X menubar	none
iTerm/	Backup location for iTerm2 preferences folder (Note: Set iTerm2 to load preferences from ~/dotfiles/iTerm)	none
Sounds/	Contains user sound files	none
README.md	This README file	none
.gitignore	Tells Git which files to ignore in this repository if they're changed	none
.gitmodules	Tells Git that there is a Git submodule in this repo (at .vim/bundle/Vundle.vim) that needs to be checked out with this repository	git submodule init && git submodule update

Terminal Initialization

1. System basic initialization (Zsh=/etc/zprofile and Bash=/etc/profile)
   1. Set PATH
2. System interactive initialization (Zsh=/etc/zshrc and Bash=/etc/bashrc)
   1. Set PS1
3. User basic entrypoint (Zsh=~/.zshrc and Bash=~/.bash_profile)
   1. Source ~/.ghk_profile (see below)
4. Source ~/.ghk_profile (main shell-agnostic init for all shells)
   1. brew shellenv
   2. Ensure <brew>/bin in PATH
   3. Set BROWSER=open VISUAL=vim EDITOR=vim
   4. Ensure Homebrew Ruby in PATH (silent)
   5. Ensure user Python packages in PATH
   6. Ensure ~/bin and ~/sbin in PATH
   7. Exit if non-interactive (if i not in $-)
   8. Source ~/.ghkrc if exists (see below)
5. Source ~/.ghkrc (main shell-agnostic init for interactive shells)
   1. Is gdate installed?
   2. Start printing SSH key fingerprint
   3. Start Tmux if in iTerm Hotkey window
   4. Source ~/.ghkrc.local if exists
   5. Set user aliases
   6. Enable Tmux wrappers for ssh and cd
6. Continue ~/.zshrc (Zsh only)
   1. Source ~/.zshrc.local if exists (see below)
   2. TODO: Initialize oh-my-zsh
7. Source ~/.zshrc.local (local-only initializations specific to the Z Shell)
   1. Colorize PS1 Z Shell prompt environment variable
8. Continue ~/.bash_profile (Bash only)
   1. Source ~/.bash_profile.local if exists
   2. Initialize oh-my-git
   3. Enable read-alias (for which to identify aliases too)
   4. Source ~/.git-completion.bash if exists
   5. Source Homebrew Bash Completion if installed
   6. Source Vagrant Bash Completion if installed
   7. Colorize PS1 Bash prompt environment variable

Z Shell Initialization Files

#	File	Constraint	Notes
1	/etc/zshenv
2	~/.zshenv
3	/etc/zprofile	login shell	Sets PATH
4	~/.zprofile	login shell
5	/etc/zshrc	interactive	Sets PS1
6	~/.zshrc	interactive
7	/etc/zlogin	login shell
8	~/.zlogin	login shell

Bash Initialization Files

#	File	Constraint	Notes
1	/etc/profile	login shell	Sets PATH and calls /etc/bashrc
2	/etc/bashrc	login shell	Sets PS1
3	~/.bash_profile	login shell
4	~/.bash_login	login shell
5	~/.profile	login shell
6	~/.bashrc	interactive non-login shell OR remote shell
7	$BASH_ENV	non-interactive

Future Tasks

• Merge dotfiles-linux repository into this repository.