dotfiles

UNIX is basically a simple operating system, but you have to be a genius to understand the simplicity. — Dennis Ritchie

---

My macOS environment, profiles, setup, and various dotfiles

Getting Started

This repository could be installed using the provided install script.

via curl (Mac)

curl --proto '=https' --tlsv1.2 -sSf https://zakhary.dev/dotfiles/install.sh | sh

Manual Installation (Mac)

Start by cloning this repository to your home directory:

git clone https://github.com/kaplanz/dotfiles.git ~/.dots

Next, you should be able to run the installer locally:

~/.dots/bin/dots install

Manual Installation (Ubuntu/Debian)

First, ensure you have all dependencies installed:

1. Install zsh, for example: sudo apt install zsh
2. Install fdfind (ensure that you also symlink to fd, if applicable)
3. Install eza
4. Install neovim (often the version in apt is out of date)
5. Install all other dependencies in the Brewfile, for example: sudo apt install bat coreutils fzf ripgrep stow tmux

Then clone the repository:

git clone https://github.com/kaplanz/dotfiles.git ~/.dots

Before you run the installation script, set the DOTS env:

export DOTS=~/.dots

Now you should be able to run the installer locally, as normal:

~/.dots/bin/dots install

Of course, don't forget to change your default shell to zsh:

chsh -s $(which zsh)

Log out and log in again, then open a terminal to confirm that zsh is now the default.

Dependencies

Some features of this repository have dependencies as listed in the Brewfile. Before installing, ensure brew and zsh are installed.

Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

For more information on using brew, see its website.

Symlinks

Dotfiles are installed through symlinks to various home subdirectories. To set up directories and link all dotfiles, use the Makefile.

make --directory=~/.dots

Uninstallation

All managed dotfiles can be uninstalled using the Makefile with:

make --directory=~/.dots uninstall