Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



Requirement: Xcode

Install Xcode through the Mac App Store.

Then, open the terminal and type:

sudo xcodebuild -license

Requirement: SSH Key

Generate a new key:

ssh-keygen -t rsa -b 4096 -C ""
pbcopy < ~/.ssh/

Then, add it on Github.

For the name, use either:

  • Private — $NAME

Where $NAME is taken from the "About This Mac" panel.

For example:

  • Private — MacBook Pro (15-inch, 2016)


cd ~
mkdir Developer
chmod 700 Developer
chmod +a "group:everyone deny delete" Developer
cd Developer

# Repo.
git clone

cd dotfiles

Note: we use Developer instead of Code. macOS adds an icon to folders named "Developer".

Manual Configuration


To set your git &, create a .gitconfig file manually in your $HOME folder and copy those values there:

  name = Firstname Lastname
  email =


Move to $HOME/Developer/dotfiles. Then:

# Install brew (get up-to-date method on

# Temporarily add brew to $PATH (before using fish).
export PATH=/opt/homebrew/bin:$PATH

# Install stow.
brew install stow

# Configure stow (see stow.bash in `scripts`).
stow --target=$HOME -R stow

# Configure fish.
stow -R fish

# Install fish.
brew install fish

# Then, read below to setup fish as default shell.


Stow is configured to use "../.." as the default target. That means that you should put the dotfiles in a folder in your home. Like "$HOME/Developer/dotfiles".

If you have followed the previous instructions, it should already be there, making this step useless.


Set fish as default shell:

  • Check where fish is installed: which fish
  • Add one of those:
    • Add /opt/homebrew/bin/fish to /etc/shells
    • Add /usr/local/bin/fish to /etc/shells
    • (Just need to be there, at the end, nothing more)
  • Run one of those:
    • chsh -s /opt/homebrew/bin/fish
    • chsh -s /usr/local/bin/fish


fish_theme_classic # "Install" the theme
fisher install jethrokuan/z
fisher install jorgebucaran/


change_computer_name $NAME

Next Steps

Follow the different scripts in the scripts folder. Use the lines (or full script) if applicable to your situation.

I don't recommend to blindly run everything, but those are a good knowledge base to bootstrap a mac.


Contact Card

Sync your contact, then in the Contacts app, choose your contact card, click on the "Card" menu, then "Make this my card".

Input Sources

Use the alternative (and better) French keyboard in system/Keyboard/frenumin.keylayout and install it.

Copy the .keylayout to ~/Library/Keyboard Layouts/.

Retina or non-retina?

If you use a non-retina monitor, run this command:

defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO

macOS Mojave removed the "Use LCD font smoothing when available" option in "General". It's better for retina screen, but awful on non-retina. This command will re-activate this option.

DO NOT USE with retina screens.

Thanks to Peter Hajas and OSX for Hackers for the inspiration.