wavto / .dotfiles

.dotfiles

This is my dotfiles repository. The repository needs to be installed directly within the $HOME directory of a macOS environment.

---

Install

.dotfiles

Requires SSH to work, see SSH.

Clone the .dotfiles as bare repository within your $HOME directory

git clone --bare [email protected]:avanthay/.dotfiles ~/.dotfiles

Create the alias dot to use instead of git for handling with your .dotfiles

alias dot='/usr/bin/git --git-dir=$HOME/.dotfiles --work-tree=$HOME'

Backup the existing files which will be overridden with the ones of this repo, checkout the current version and set the upsteam for the local branch master

dot checkout

Update the local repository config to hide untracked files when doing dot status

dot config status.showUntrackedFiles no

Initialize and update the submodules

dot submodule update --init --recursive

Set your git credentials by copying .gitconfig.local.sample to .gitconfig.local and editing it

It may be a good idea to reboot your mac.

Setup a new Mac

Set the hostname in System preferences > Sharing

Disable Guest Account in System preferences > Users and Groups

Enable harddisk encryption and the Firewall in System preferences > Security and Confidentiality

Check the remaining System preferences, maybe check the screenshots at .dot/config/macOS

Enable developer tools

sudo softwareupdate -i -a
xcode-select --install

Disable accented characters when holding down a key with defaults write -g ApplePressAndHoldEnabled -bool false

SSH

Install your SSH key pair into ~/.ssh

Start the SSH agent in background

eval "$(ssh-agent -s)"

Add your key to the ssh-agent

ssh-add -K ~/.ssh/{your private key}

Homebrew

Install Homebrew

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

Install Homebrew Taps

brew tap homebrew/cask
brew tap homebrew/cask-versions
brew tap homebrew/completions
brew tap homebrew/core
brew tap homebrew/dupes
brew tap homebrew/services
brew tap homebrew/versions

Update & upgrade Homebrew

brew update
brew upgrade

iTerm2

Install iTerm2

brew cask install iterm2

Set custom preferences folder

defaults write com.googlecode.iterm2 PrefsCustomFolder -string ~/.iterm/

Open the iTerm2 settings and check Load preferences from a custom..., make sure to uncheck Save changes ... when iTerm2 quits.

Quit iTerm2 and restart it. You may need to close the window / quit iTerm2 multiple times until the oh-my-zsh theme gets displayed correctly.

Oh-My-ZSH

Oh-My-ZSH gets installed with .dotfiles (submodule)

Install ZSH autocompletion

brew install zsh-completions

Change default shell to zsh

chsh -s /bin/zsh

Install powerline fonts needed for the oh-my-zsh theme agnoster

git clone [email protected]:powerline/fonts /tmp/fonts
/tmp/fonts/install.sh
rm -r /tmp/fonts

Sublime Text

Install Sublime Text

brew cask install sublime-text

Install the package control as described here by pasting the code there into the sublime console.

Run the following commands to remove the settings directory and symlink it to ´~/.sublime` instead

rm -rf ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User
ln -s ~/.sublime/ ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User

You may want to install Pandoc for Markup conversion

Pandoc

Install Pandoc (needed for the Sublime Text extention)

brew install pandoc

For pandoc to work, you need to install LaTex

LaTex

Install BasicTex

brew cask install basictex

Spectacle

Install

brew cask install spectacle

Install shortcuts

cp ~/.dot/config/Spectacle/Shortcuts.json ~/Library/Application\ Support/Spectacle/Shortcuts.json

Firefox

Install Firefox (develper edition + normal)

brew cask install firefoxdeveloperedition
brew cask install firefox

Link the user.js file to the Firefox profile directories. Replace {profile} with your profile directory and repeat for each profile.

ln -s ~/.dot/config/Firefox/user.js ~/Library/Application\ Support/Firefox/Profiles/{profile}/user.js

Caffeine

    brew cask install caffeine

Mac App Store

Installed those Apps manually from the App Store

• PasteBox – Clipboard Manager
• OneDrive
• Google Drive
• Brave Browser
• NotePlan 3
• Notion

Quicklook

Install

brew cask install qlmarkdown quicklook-csv quicklook-json

PHP

Add the Homebrew tap

brew tap homebrew/php
brew tap kyslik/php

Install the PHP packages

brew install composer
brew install php70
brew install php70-apcu
brew install php70-opcache
brew install php70-xdebug
brew install php70-yaml

To enable debugging add the following line to the file /usr/local/etc/php/7.0/conf.d/ext-xdebug.ini

xdebug.remote_enable=1

---

Usage

Feel free to use my dotfile repository, ideally you go throught the settings instead of just copying my repos as it is. The usage of this repository is at your own risk!

---

Credits

• Nicola Paolucci and his article The best way to store your dotfiles: A bare Git repository
• Mathias Bynens and his dotfile repository
• Chris Arcand and his article Sublime Text Settings and Dotfiles
• Kevin Suttle and his great macOS Defaults documentation
• Lars Kappert and his dotfile repository
• Henrik Gustafsson and his answer to a post about submodules on stackoverflow
• Simon Owen and his article Setting Up a Mac Dev Machine From Zero to Hero With Dotfiles

.dotfiles's Issues

macos config

add the following config to .install/.macos

• remove download directory from dock
• set clock format
• set selection color
• set default browser
• remove screensaver
• set mission control shortcuts
• set preferred mouse and trackpad config

macos esc key

defaults write -g NSUseSpellCheckerForCompletions -bool false

TODO : check if the bug is fixed in macOS Sierra

More Informations in this Apple forum post

add error handling to install script

At the moment, the installation script continues (at least with the next script) when errors occurs. That should be improved somehow...