Theo's dotfiles

my macbook

Here are dotfiles for my systems, M1 MacBook Air and Lenovo ThinkPad X270. MBA runs the latest version of macOS, and X270 runs the latest version of Fedora Sway Spin.

Tools in this repository are mostly open-source utilities for development.

Important

Read the code if you decide to use them!

Installation

# Clone the repository
git git@github.com:theopn/dotfiles.git

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

# Install formulae
cd $HOME/dotfiles
brew bundle --file ./homebrew/Brewfile_core
brew bundle --file ./homebrew/Brewfile_optional

# tap font repository and install Ubuntu Mono Nerd Font
brew tap homebrew/cask-fonts &&
brew install --cask font-ubuntu-mono-nerd-font

# Deploy dotfiles using custom Stow bootstrap script
./bootstrap.sh

# macOS settings
./misc/macos-settings.sh

Utilities

Shells

• Bash: Basic configuration for my school SSH server
• ZSH: $SHELL
  • Functions utilizing fzf (cdf, sshf, etc.)
  • Minimal plugin manager (plug, update) to download and source zsh-autocompletion
  • Rudimentary implementation of trash-cli (trash)
  • Git info in the prompt
• Fish: Main interactive shell
  • Run fish $HOME/dotfiles/fish/.config/fish/set-universal.fish to create fish_variables that will persist
  • Abbreviations in conf.d/abbreviations.fish
  • Functions in functions/
  • Other modular configurations in conf.d and config.fish (in the order of source priority)

Terminal emulators and multiplexers

• Tmux - things different from the defaults:
  • Settings: Some terminal information, all indexing starts from 1, increased history limit, and reduced escape time
  • C-a is the prefix, and PFX + C-a sends C-a to the terminal
  • PFX + C-r reloads the config
  • PFX + c creates a new window with the same CWD as the current pane
  • PFX + %/" creates a new pane with the same CWD as the current pane
  • PFX + hjkl navigates panes (the default l is unbound which is :last-window)
  • PFX + C-s prompts you to send the current pane to a selected window
  • Vi-copy-mode is set, y in copy mode yanks the selection -- I do not know what this is not the default since y is not bound to anything by default
  • Dracula themed status bar displaying the current session & window information, CWD, and current command running
  • Use PFX + ? (list keys) and PFX + / + <key> (describe key) for more help
• Wezterm: My favorite terminal emulator. Watch my YouTube video Configure Wezterm terminal emulator in Lua with me [ASMR Coding] :)
  • Many keybindings in the video now has been changed to match the Tmux keybindings, but the overall functionality remains the same
  • LDR = C-a
  • LDR [: enters the copy mode
  • LDR :: opens the command palette
  • LDR s: opens the fuzzy picker for workspace (similar to sessions in Tmux)
  • Tabs (similar to windows in Tmux)
    • LDR w: opens the picker for tabs
    • LDR c: creates a new tab
    • LDR p/n: navigates previous/next tabs
    • LDR ,: renames the tab
    • LDR .: enters the move_tab mode where you can use hj/kl to order tabs and ESC or RET to confirm
    • LDR 1-9: moves to the tab with the given index
  • Panes
    • LDR %/": creates a new pane vertically/horizontally
    • LDR hjkl: navigates pane
    • LDR SPC: zooms the current pane
    • LDR x: closes the current pane
    • LDR !: breaks the current pane into a new tab
    • LDR r: enters the resize_pane mode where you can resize the pane with <>-+ and ESC or RET to confirm
  • $ wezterm show-keys --lua to get the Lua table of all keybindings available
• Kitty: The secondary terminal

Text editors:

• Neovim: So many things to talk about, use :h theovim to access the help documentation I wrote
• Vim: Because Neovim is my main text editor, Vim is kept as a simple Vim config with Vimwiki for my journal writing
  • My Vimrc is built using Kickstart.vim, features 40-line Vimscript bufferline

Others

• LF: Simple and fast terminal file manager
  • ee: Open a file in $EDITOR
  • ec: You choose what editor you want to open a file in
  • DD: Move a file to ~/.theoshell/trash
  • gs: [g]it [s]tatus
  • ml, mr, ms: [m]ark [l]oad, [m]ark [r]emove, [m]ark [s]ave
  • md: mkdir
  • mf: Create a file and open in $EDITOR
  • mo: chmod
• Git: Some Git settings and global .gitignore file

macOS

macOS Tiling WM Setup

Tools used to create my Tokyo-Night-themed tiling WM setup for my macOS environment:

• Aerospace
• Sketchybar

Install Aerospace and Sketchybar

brew install nikitabobko/tap/aerospace FelixKratz/formulae/sketchybar

Add Aerospace to your login item in System Settings. Aerospace will automatically launch Sketchybar on the startup.

The configuration and keybindings are very close to the default with a couple of tweaks (the opt/alt/⌥ key is the modifier):

• alt-shift-space: Toggle between floating and tiling for the current window
• alt-enter: Open Wezterm
• alt-slash: Toggle between horizontal and vertical tiling
• alt-comma: Toggle between horizontal and vertical accordion mode
• alt-h/j/k/l: Focus windows
• alt-shift-h/j/k/l: Move windows
• alt-minus/equal (-/+): Resize window
• alt-1 - 9: Move to workspace 1 - 9
• alt-shift-1 - 9: Move the current tree to workspace 1 - 9
• alt-tab: Switch between previously used workspaces
• alt-shift-tab: Move current workspace to a different monitor
• alt-shift-space: Enter the service mode
  • esc: Reload the config and exit the service mode
  • r: Reset layout and exit the service mode
  • alt-shift-h/j/k/l: Join windows into different trees

Homebrew

Bolded items are in Brewfile_core, and other items are in Brewfile_optional, either because I don't want them to be installed on every machine or are too large.

Formulae:

• fd: faster alternative to find (Neovim Telescope dependency)
• ffmpeg: ffmpeg -i in.xxx out.yyy
• figlet: ASCII art generator
• fish: De facto default shell
• fzf: Command line fuzzy finder
• git-filter-repo: tool to rewrite Git history
• htop: System monitor
• hugo: Static website generator
• imagemagick: Command line image manipulation
• lf: My favorite CLI file manager
• lua
• neovim: My second home
• node
• ripgrep: faster alternative to grep (Neovim Telescope dependency)
• rust
• tmux: Universal terminal multiplexer
• tree: Tree-like directory view
• wget: Be careful with what you download

Casks:

Development	Fun	Productivity	Sync	System	Tools	Web
Docker	Discord	Itsycal	Cryptomator	Aerospace	Bitwarden	Chromium
IntelliJ CE	Minecraft	Notion	Filen	Ice	GIMP	Firefox
kitty	Spotify		Syncthing	Maccy	OBS	Thunderbird
MacTex (no GUI)				Stats	Skim
Macvim					VLC
Wezterm

Settings

./misc/macos-settings.sh includes some macOS settings like adding a Dock spacer, show hidden files in Finder, changing screenshot format and location, etc.

Archive

Warning

Configuration files in the archive directory are no longer maintained

See the list of archived configurations.

Inspirations and Shameless Plug

• macOS wallpaper: arsenicxs
• Aerospace: default-config.toml and DevOps Toolbox's Dotfiles
• LF: example lfrc and Brodie Robertson's Dotfiles
• Neovim: Theovim but it has changed a lot since Neovim 0.11
• Sketchybar: the default plugins
• Vim: kickstart.vim hehe
• Wezterm: my Wezterm config video