sstoyanov7 / dotfiles

.files, including ~/.osx — sensible hacker defaults for OS X

hkdobrev’s dotfiles

Installation

Using Git and the install script

The repository is made for use inside your $HOME directory. It will ignore everything other than what it explicitly is tracking already.

cd $HOME
git init
git remote add origin [e-mail]:hkdobrev/dotfiles.git
git fetch origin master
git reset --hard origin/master

It is recommended to fork the repo and adjust it as needed.

Installing initial tools

When setting up a new computer use the install.sh script to install Homebrew, Homebrew budle, rbenv, vim-plug, Composer, set up Bash 4 and the XCode CLI tools.

./init/install.sh

Updating

To later update the dotfiles configuration:

cd $HOME
git pull

To update your software run the update command which will update Ruby gems, Homebrew formulae, Composer globals and others.

Specify the $PATH

If ~/.path exists, it will be sourced along with the other files, before any feature testing (such as detecting which version of ls is being used) takes place.

Here’s an example ~/.path file that adds ~/utils to the $PATH:

export PATH="$HOME/utils:$PATH"

Add custom commands without creating a new fork

If ~/.extra exists, it will be sourced along with the other files. You can use this to add a few custom commands without the need to fork this entire repository, or to add commands you don’t want to commit to a public repository.

My ~/.extra looks something like this:

# Git credentials
# Not in the repository, to prevent people from accidentally committing under my name
GIT_AUTHOR_NAME="Mathias Bynens"
GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"
git config --file=$HOME/.gitconfig.extra user.name "$GIT_AUTHOR_NAME"
GIT_AUTHOR_EMAIL="[e-mail]"
GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"
git config --file=$HOME/.gitconfig.extra user.email "$GIT_AUTHOR_EMAIL"

You could also use ~/.extra to override settings, functions and aliases from my dotfiles repository. It’s probably better to fork this repository instead, though.

Sensible OS X defaults

When setting up a new Mac, you may want to set some sensible OS X defaults:

./.osx

Install Homebrew formulae and Cask apps

When setting up a new Mac, you may want to install some common Homebrew formulae (after installing Homebrew, of course):

brew bundle ~/Brewfile

Feedback

Suggestions/improvements welcome!

Author

Mathias Bynens

This repo is a fork of the originial dotfiles of Mathias Bynens, it is heavily modified by Haralan Dobrev for his own purposes.

Thanks to…

• @ptb and his OS X Lion Setup repository

• Ben Alman and his dotfiles repository

• Chris Gerke and his tutorial on creating an OS X SOE master image + Insta repository

• Cãtãlin Mariş and his dotfiles repository

• Gianni Chiappetta for sharing his amazing collection of dotfiles

• Jan Moesen and his ancient .bash_profile + shiny tilde repository

• Lauri ‘Lri’ Ranta for sharing loads of hidden preferences

• Matijs Brinkhuis and his dotfiles repository

• Nicolas Gallagher and his dotfiles repository

• Sindre Sorhus

• Tom Ryder and his dotfiles repository

• Kevin Suttle and his dotfiles repository and OSXDefaults project, which aims to provide better documentation for ~/.osx

• Haralan Dobrev

• anyone who contributed a patch or made a helpful suggestion