mirror of
https://github.com/m-housh/dotfiles.git
synced 2026-02-14 14:12:41 +00:00
168 lines
4.0 KiB
Markdown
168 lines
4.0 KiB
Markdown
# 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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
make bootstrap-minimal
|
|
```
|
|
|
|
## To set macOS settings
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|