README.md

Dotfiles

For more information about dotfiles, Rosco Kalis wrote these articles on his blog:

• Dotfiles: automating macOS system configuration
• Increasing development productivity with repository management
• Set up a Hyper Key with Hammerspoon on macOS

Usage

1. Restore your safely backed up ssh keys to ~/.ssh/
   1. Alternatively, generate new ssh keys, and add these to your GitHub account
2. Install Homebrew and git

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git

3. Clone this repository

git clone [email protected]:devinpearson/dotfiles.git

4. Run the bootstrap.sh script
   1. Alternatively, only run the setup.sh scripts in specific subfolders if you don't need everything
5. (Optional) Install missing applications from the internet

• Popcorn Time

6. (Optional) Point the Alfred preference sync to the right folder

Customisation

I strongly encourage you to play around with the configurations, and add or remove features. If you would like to use these dotfiles for yourself, I'd recommend changing at least the following:

Git

• The .gitconfig file includes my [user] config, replace these with your own user name and email

OSX

• At the top of the setup.sh file, my computer name is set, replace this with your own computer name

Packages

This folder is a collection of the programs and utilities I use frequently. These lists can easily be amended to your liking.

Repos

This folder is a collection of my own repos, some of which are even private. The existing lists can easily be edited or replaced by custom lists.

Contents

Root (/)

• bootstrap.sh - Calls all setup.sh scripts

User Bin (bin/)

• setup.sh - Symlinks the other contents of the folder to ~/bin/
• imgcat - A utility to display images inline in iTerm 2
• sethidden - A shell script which takes command line arguments to show or hide hidden files
• togglehidden - A shell script that toggles between showing and hiding hidden files

Git (git/)

• setup.sh - Symlinks all git files to ~/
• .gitignore_global - Contains global gitignores, such as OS-specific files and several compiled files
• .gitconfig - Sets several global Git variables

macOS Preferences (macos/)

• setup.sh - Executes a long list of commands pertaining to macOS Preferences

Packages (packages/)

• setup.sh - Installs the contents of the .list files and the Brewfile

Repositories (repos/)

• setup.sh - Clones the repositories in the .list files at the corresponding locations

Helper Scripts (scripts/)

• functions.sh - Contains helper functions for symlinking files and printing progress messages