 ██▀███   ▒█████   ▒█████  ▄▄▄█████▓ ██▓▓█████   ██████ ▄▄▄█████▓
▓██ ▒ ██▒▒██▒  ██▒▒██▒  ██▒▓  ██▒ ▓▒▓██▒▓█   ▀ ▒██    ▒ ▓  ██▒ ▓▒
▓██ ░▄█ ▒▒██░  ██▒▒██░  ██▒▒ ▓██░ ▒░▒██▒▒███   ░ ▓██▄   ▒ ▓██░ ▒░
▒██▀▀█▄  ▒██   ██░▒██   ██░░ ▓██▓ ░ ░██░▒▓█  ▄   ▒   ██▒░ ▓██▓ ░
░██▓ ▒██▒░ ████▓▒░░ ████▓▒░  ▒██▒ ░ ░██░░▒████▒▒██████▒▒  ▒██▒ ░
░ ▒▓ ░▒▓░░ ▒░▒░▒░ ░ ▒░▒░▒░   ▒ ░░   ░▓  ░░ ▒░ ░▒ ▒▓▒ ▒ ░  ▒ ░░
  ░▒ ░ ▒░  ░ ▒ ▒░   ░ ▒ ▒░     ░     ▒ ░ ░ ░  ░░ ░▒  ░ ░    ░
  ░░   ░ ░ ░ ░ ▒  ░ ░ ░ ▒    ░       ▒ ░   ░   ░  ░  ░    ░
   ░         ░ ░      ░ ░            ░     ░  ░      ░

 ██     ██ ███████ ███████ ████████ ███████ ██████  ███    ███
 ██     ██ ██         ███     ██    ██      ██   ██ ████  ████
 ██  █  ██ █████     ███      ██    █████   ██████  ██ ████ ██
 ██ ███ ██ ██       ███       ██    ██      ██   ██ ██  ██  ██
  ███ ███  ███████ ███████    ██    ███████ ██   ██ ██      ██

        ▄████▄   ▒█████   ███▄    █   █████▒
        ▒██▀ ▀█  ▒██▒  ██▒ ██ ▀█   █ ▓██   ▒
        ▒▓█    ▄ ▒██░  ██▒▓██  ▀█ ██▒▒████ ░
        ▒▓▓▄ ▄██▒▒██   ██░▓██▒  ▐▌██▒░▓█▒  ░
        ▒ ▓███▀ ░░ ████▓▒░▒██░   ▓██░░▒█░
        ░ ░▒ ▒  ░░ ▒░▒░▒░ ░ ▒░   ▒ ▒  ▒ ░
        ░  ▒     ░ ▒ ▒░ ░ ░░   ░ ▒░ ░
        ░        ░ ░ ░ ▒     ░   ░ ░  ░ ░
        ░ ░          ░ ░           ░
        ░
                 ╭─────────────╮
                 ╭─────────────╮
                 │ $W          │
                 │             │
                 │             │
                 ╰─────────────╯

The rootiest WezTerm configuration you will ever see!

Installation

Install WezTerm (nightly)
Install pre-requisites
- Required
  - Rootiest Iosevka fonts
- Optional
  - fish
  - neovim

Backup your current WezTerm configuration (if you have one)

mv ~/.config/wezterm ~/.config/wezterm.bak
mv ~/.wezterm.lua ~/.wezterm.lua.bak

Clone the repository

git clone https://git.rootiest.dev/rootiest/wezterm-config.git ~/.config/wezterm

Enjoy! 🎉

Windows Users

Install PowerShell
Install Rootiest Iosevka fonts
Install WezTerm

Clone the repository

$home = $env:USERPROFILE
git clone https://git.rootiest.dev/rootiest/wezterm-config.git $home/.config/wezterm

Enjoy! 🎉

Features

Smart key bindings
Leader key and modal mode
Session mux/management/resurrection
Advanced tab management
Splits and panes integrate seamlessly with NeoVim
Seamless integration with fish shell
Catppuccin theme by default
Integrates cleanly with other Rootiest projects

Customization

User customizations can be added by creating a user.lua file in the ~/.config/wezterm directory.

General Configuration

The file should be structured in the following manner:

return {
  -- Ex:
  color_scheme = "Catppuccin Mocha",
  leader = { key = "a", mods = "CTRL", timeout_milliseconds = 1000 },
  default_prog = { "/bin/zsh", "-l" },
}

Config options can be found in the wezterm Configuration documentation.

Options in the user.lua file are written as key = value pairs (without the config. prefix).

The configuration loading code will detect the user file and merge it with the rest of the configuration.

This is applied after the default config so user options will override any defaults.

Further, the user.lua file is ignored by git and will not impact your ability to pull updates.

Session Encryption

The default configuration attempts to use my personal encryption keys.

If the keyfile cannot be found, encryption is disabled.

You can customize this by adding (above the return{} table):

MYKEY = "/path/to/keyfile.txt" -- Path to the keyfile
MYPUBKEY = "age1q80h5jsp9d48kggf9kra82xkgyaqdnehqenm003ftapem9re7ytqp9hr6h"

return {
  -- Etc..
}

These global variables will be detected and used to apply the encryption.

As with the default configuration, if the keyfile is not found, encryption is disabled.

Tabline Customization

The tabline configuration can also be customized.

This is done by adding (above the return{} table):

local wezterm = WEZTERM -- Link to the main wezterm object

MYTABLINE = {
  options = {
    icons_enabled = true,
    theme = 'Catppuccin Mocha',
    color_overrides = {},
    section_separators = {
      left = wezterm.nerdfonts.pl_left_hard_divider,
      right = wezterm.nerdfonts.pl_right_hard_divider,
    },
    component_separators = {
      left = wezterm.nerdfonts.pl_left_soft_divider,
      right = wezterm.nerdfonts.pl_right_soft_divider,
    },
    tab_separators = {
      left = wezterm.nerdfonts.pl_left_hard_divider,
      right = wezterm.nerdfonts.pl_right_hard_divider,
    },
  },
  sections = {
    tabline_a = { 'mode' },
    tabline_b = { 'workspace' },
    tabline_c = { ' ' },
    tab_active = {
      'index',
      { 'parent', padding = 0 },
      '/',
      { 'cwd', padding = { left = 0, right = 1 } },
      { 'zoomed', padding = 0 },
    },
    tab_inactive = { 'index', { 'process', padding = { left = 0, right = 1 } } },
    tabline_x = { 'ram', 'cpu' },
    tabline_y = { 'datetime', 'battery' },
    tabline_z = { 'hostname' },
  },
  extensions = {},
}

return {
  -- Etc..
}

The table above is taken from the example in the tabline.wez documentation.

This is the table that will be passed to tabline.setup() and loaded by the tabline plugin.

Screenshots

Companion Tools

Rootiest Fish Conf - Fish shell configuration that pairs well with this WezTerm configuration and the NeoVim configuration.

Rootiest Tmux - A tmux configuration that is designed to work with this WezTerm config.

Rootiest Neovim - A NeoVim config built to work alongside this and the fish config.

Rootiest Iosevka Font - A custom Iosevka font that is designed by developers, for developers.

Nerd Fonts - A collection of fonts that include many icons and glyphs that are used in this configuration.

Dotfiles

Rootiest Dotfiles

README.md

Rootiest WezTerm Configuration