/dotfiles

⚙ OS X configuration kit.

Primary LanguageShellMIT LicenseMIT

gears image for dotfiles banner

~/.dotfiles

OS X configuration kit.

Usage

To use this repository for setting up your personal computer after initial purchase or after reformatting it, I would recommend that you fork the repository and edit the files based on your needs.

For example, you should definitely edit the /dots/.gitconfig file and change the information for the [user] to reflect your specific GitHub user information for submitting commits and pushing up code.

Alternatively, you can also just use this repository as a guide for setting up your own custom dotfiles or you can try and run only specific scripts instead of the full setup.

Whatever floats your boat is cool with me 💃!

Setup Steps

  1. Install Xcode from the Mac App Store and run it to accept the license and install git.

  2. Generate an SSH key for the computer. Use these instructions if you don't remember how to do it.

  3. Add SSH key to GitHub (and/or any other git versioning service, like BitBucket for example).

You can copy your public SSH key using the following command:

$ pbcopy < ~/.ssh/id_rsa.pub
  1. Run the following command from the terminal to download the install.sh script file from this repo, and subsequently run it to begin the installation and setup process:
$ curl https://raw.githubusercontent.com/weerd/dotfiles/master/install.sh | sh

Installation Script Sequence

When the install.sh script runs, the following things will happen:

  1. A Code directory will be created in the Home (~) directory.
  2. Next, it will download this dotfiles repository into ~/Code and run the bootstrap.sh script.

Bootstrap Script Sequence

When the bootstrap.sh script runs, the following things will happen:

  1. A selection of dotfiles will be symlinked into the ~/ home directory.
  2. Install Homebrew if it's not already installed.
  3. Using Homebrew, install specified binary packages (utilities, tools, etc).
  4. Using Homebrew Cask, install specified native Mac applications.

Available Aliases

Change directories into the ~/Desktop directory:

$ desk

Change directories into the ~/Code directory:

$ code

Open the /etc/hosts file in Sublime Text:

$ hosts

Show hidden files in the Finder:

$ showFiles

Hide files that should be hidden in the Finder:

$ hideFiles

Application Specific Setups

Moom

Moom is a great application for moving around and zooming OSX windows, however there is currently no easy way to sync its great customizable configurations across computers.

This repository provides two scripts that copy back and forth the Moom system preference file. Unfortunately, due to how OSX handles the preferences files, they cannot be symlinked to this repository since everytime the application settings are updated, the system preferences file is completed replaced.

Instead, we can run the included export script to copy the preferences (once configured) into this repository, and back from the repository to the system (on another computer with Moom for example) using the import script:

$ bash ~/path/to/this/repo/dotfiles/moom/export.sh
$ bash ~/path/to/this/repo/dotfiles/moom/import.sh