RobertAudi / .dotfiles

🏠 My dotfiles

...

This repository contains my dotfiles managed by GNU Stow.

Table of Contents

• Toolchain
• Usage
• The setup script
• Homebrew
  • Install/Update
  • Packages
• License

Toolchain

• GNU Stow: Manage bundles of dotfiles and symlink them to the home directory
• Homebrew: Package manager for macOS
• Homebrew Bundle: Bundler for dependencies from Homebrew, Homebrew Cask and the Mac App Store
• mas: Mac App Store command line interface
• Iterm2: Terminal emulator for macOS
• Zsh: Unix shell
• Zinit: Flexible Zsh plugin manager
• tmux: Terminal multiplexer
• ghq: Manage remote repository clones
• fzf: A command-line fuzzy finder
• Universal Ctags: A maintained ctags implementation
• Neovim: Vim-based text editor
• TextMate: Powerful and customizable GUI text editor for macOS
• Hammerspoon: Powerful macOS automation tool

...and a bunch more...

Usage

Don't use this as your dotfiles. Just don't. This setup is highly customized for my needs specifically. That's not a restriction or anything like that, it's just an advice.

A better approach would be to browse the files and steal bits and pieces that you might find useful, and don't hesitate to create an issue if you have any questions and/or you found a bug, or for any reason really.

The setup script

There is a script to install and setup some of the tools. To be able to use it, you need to stow the "setup" bundle:

$ stow setup

Homebrew

Install/Update

Use the setup script to update Homebrew or install it if needed:

$ setup brew

If you just want to update brew packages (including casks), use the update script:

$ update brew

Packages

Packages and dependencies are managed using Homebrew Bundle and are organized in multiple "bundles" (files with the .brewfile extension).

To install a bundle, you need to specify its file to the brew bundle command:

$ brew bundle install --file="./Homebrew/common.brewfile"

Or you can install all bundles:

# In ZSH:
for f in ./Homebrew/*.brewfile(:A); do
  brew bundle install --file="$f"
done

License

WTFPL – Do What the Fuck You Want to Public License

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
                    Version 2, December 2004

 Copyright (C) 2019 Robert Audi

 Everyone is permitted to copy and distribute verbatim or modified
 copies of this license document, and changing it is allowed as long
 as the name is changed.

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. You just DO WHAT THE FUCK YOU WANT TO.