Note: If you want to give these dotfiles a try, you should first fork this repository, review the code, and remove things you don’t want or need. Don’t blindly use the settings unless you know what that entails. Use at your own risk!
You should have the following tools installed to follow further steps:
- Git
- ZSH
If you don't have these tools (starting with a new mac let's say), then use the following command to get the pre-requisites setted up.
xcode-select --install
Then follow the prompts till the installation is complete.
Check if git is installed by running git --version
. It should spit out some version (not concerned about what version it is because we will install git later from brew).
Run echo $0
. If it didn't spit out -zsh, then use run chsh -s $(which zsh)
to change your shell to zsh (assuming you have zsh installed already).
Once shell is changed restart your terminal.
You can clone the repository wherever you want. (I keep it in ~/.dotfiles
).
The below command will get the repository and place it in .dotfiles
folder inside you user home directory and export that directory path.
git clone https://github.com/anadinema/dotfiles.git $HOME/.dotfiles && cd $HOME/.dotfiles && export DOTFILES=$(pwd)
Then to start the setup, run:
zsh install.zsh
By default, it will run the defaults.zsh script as well and set some sensible macos defaults. In case you don't want that, then add the DEFAULTS variable as false and run:
DEFAULTS=false zsh install.zsh
Some of the functionality of these dotfiles depends on formulae present in brew/Brewfile
. If you plan to not install brew
or it's formulae, you should look carefully through the script and manually install any particularly important ones. A good example is stow: the GNU utility to manage the symlinks for the dotfiles.
Suggestions/improvements welcome!
- Mathias Bynens and his dotfiles repository
- Gianni Chiappetta for inspiring lot of dotfiles
- Kevin Suttle for sharing lots of macos defaults
- Matijs Brinkhuis and his dotfiles repository
- Anyone who (already have or will) contributed a patch or made a helpful suggestion