4.0 KiB
My Dotfiles
This is a repository for my dotfiles. Be warned that these may often change and that the installation documentation may not always be correct as things progress. In general the setup process is something that is only done when a new machine is purchased or I feel like testing in a virtual machine (which does not happen often). It is helpful to have an understanding of what these commands do on your own.
In general no pull-requests or changes will be accepted, however you can generate an issue if you find a problem.
It currently will install homebrew and the following homebrew formula.
fd
git
mas
node
ripgrep
stow
swift-format
zsh
zsh-completions
It will also install the following homebrew casks in the ~/Applications directory.
docker
google-chrome
iterm2
microsoft-teams
obs
rapid-api
sketchup-pro
And the following fonts.
font-inconsolata-nerd-font
The following applications will be installed from the macOS app store.
pwSafe
Xcode
The following non-app-store applications will be downloaded for later installation / setup. These will be placed in ~/Downloads
Logi Options # logitech mouse / keyboard settings
AmazonWorkDocsDrive
Installation
Clone the repository.
git clone https://m-housh/dotfiles.git ~/.dotfiles && \
cd ~/.dotfiles
The Makefile includes commands to install dependencies and link the
configuration using gnu-stow.
On a fresh system run the following command from the dotfiles root.
make bootstrap
This start by installing homebrew, then install the required homebrew formulas and casks. Next it will use
gnu-stow to symlink configuration files to the appropriate locations. And finally, it will download
applications from the App Store. When the bootstrap command is done it will open up the ~/Downloads folder
for the few applications that get downloaded from the internet, so that you can finish the installation of those applications.
Minimal Setup
If you would like to just setup minimal stuff, link dotfiles, and install brews (no casks except for Iterm2). Then you can run the following command.
make bootstrap-minimal
To set macOS settings
source scripts/setup_defaults
Post Installation
After everything has finished up, you will be able to open iTerm2 and load
the profile which should now be symlinked to ~/.config/macOS/iterm/profile.json
Make commands
It is also possible to not do the full bootstrapping. If you would only like to install homebrew (without any formula or casks) then you can run the following command.
make bootstrap-homebrew
Once homebrew is installed, if you'd like to install the homebrew
formula (located in macOS/.config/macOS/Brewfile) then you can run the
following command.
make bootstrap-brews
To install homebrew casks (located in macOS/.config/macOS/Casks.Brewfile) then you
can run the following command.
make bootstrap-casks
To symlink the configuration files only then you can run. (Note this will likely be removed in the future, as most of the installation is done by custom scripts currently).
make stow
To download the logitech options application and place in your ~/Downloads folder, you can run.
make bootstrap-logitech
To download the amazon workdocs drive installer and place in your ~/Downloads
folder, you can run. (Note the Amazon workdocs app does not work on newer M1
macOS architectures, and will likely be removed in the future).
make bootstrap-amazon-workdocs
And finally to download the app store applications run.
make bootstrap-app-store
Other Make Commands
If you would like to setup any specific zsh configuration that is only for
the local machine then you can run the following command.
make zshrc-local
This will generate and symlink a file that you can use to extend the default
zshrc configuration. In general, I use this to set custom location for
homebrew casks to be installed on certain machines.