Fast, powerful & friendly configs ("dotfiles") for Zsh, Git, SSH, Terminal.app, Karabiner-Elements and your web browser on macOS

SSH config:

• Automatically load SSH keys from macOS login keychain into SSH agent, so you don't have to type any passwords for SSH connections.

User style sheet:

• Style all code in your web browser with the Fira Code font.

Terminal.app theme:

• Translucent dark mode with macOS system colors and Fira Code font

Karabiner-Elements config:

• Ergoemacs mode
• Navigation in terminal apps
• Undo and Redo in terminal apps

Git config:

• Colored output
• Automatic rebase when you pull
• Use Xcode's FileMerge for diffs and merges.
• Use Atom for editing commit messages.

Atom config:

• Format code on save.
• Use Fira Code as the font.
• Set line length to 99 characters.
• Configure ide-python to work with pipenv, flake8, pycodestyle and pylint.

Z Shell config:

• Fast start-up thanks to asynchronous plugin loading
• Sensible defaults
• Activates Zsh's built-in help function, so you can press ⌥H on any command for online help.
• Pure prompt
• Upgraded commands for
  • cd,
  • ls,
  • find and tree, and
  • tail
• Command-line syntax highlighting
• Code syntax highlighting in less
• Colored output in ls, grep and command-line completion
• Fuzzy history search and file completion
• Homebrew "command not found" suggestions
• Additional command-line completions
• Automatic closing brackets and quotes
• Automatic suggestions while you type, based on your command history
• Automatic Pyenv init and Pipenv shell

• These dotfiles were written for macOS. If you are using some other (Unix-based) OS, they might need some editing before you can use them. I have not tested them on anything else than macOS.
• You need to have Homebrew installed, which is available for both macOS and Linux. (Or you need to modify the brew target in the makefile to use another package manager of your choosing.)
• To benefit from the Z Shell part, you obviously need to be running zsh as your shell —which I highly recommend. Here's the best way to install the latest version:
  1. Open Terminal.app (or whatever terminal you like to use) and use Homebrew (see above) to install the latest version of zsh:

     brew install zsh

  2. Edit your /etc/shells file and change the line that says

     /bin/zsh

     to

     /usr/local/bin/zsh

     (Or if the first line isn't there, just add the second line to the end of the file.)
  3. Change your shell to zsh:

     chsh -s /usr/local/bin/zsh

  4. Restart your terminal.

1. Fork this repo.
2. Edit the .gitconfig file in your fork so it has your name and email address, not mine!
3. Open Terminal.app (or whatever terminal you like to use) and back up your existing ~/.config/ folder (if any):

   mv -iv ~/.config/ ~/.config\~

4. Git clone your fork into your home folder. You will now have a new ~/.config/ folder.
5. Go into the new ~/.config folder and run make:

   cd ~/.config/
   make

   This will…
   • back up your existing config files,
   • use Homebrew (see Requirements) to install dependencies, and
   • install new config files.
6. Merge anything you'd like to keep from your old config files back into your new ones.
7. (optional) In Terminal.app, go to Preferences and import the Dark Mode theme and set it as the default.
8. Restart your terminal.

© 2020 Marlon Richert

This project is licensed under the MIT License - see the LICENSE file for details