My WezTerm Config

Features

• Background Image Selector

  • Cycle images
  • Fuzzy search for image
  • Toggle background image

  See: key bindings for usage

• GPU Adapter Selector

  :bulb: Only works if the front_end option is set to WebGpu.

  A small utility to select the best GPU + Adapter (graphics API) combo for your machine.

  GPU + Adapter combo is selected based on the following criteria:

  1. Best GPU available

     `Discrete` > `Integrated` > `Other` (for `wgpu`'s OpenGl implementation on Discrete GPU) > `Cpu`
  2. Best graphics API available (based off my very scientific scroll a big log file in Neovim test 😁)

     > :bulb:
     > The available graphics API choices change based on your OS.
     > These options correspond to the APIs the `wgpu` crate (which powers WezTerm's gui in `WebGpu` mode)
     > currently has support implemented for.
     > See: for more info - Windows: `Dx12` > `Vulkan` > `OpenGl` - Linux: `Vulkan` > `OpenGl` - Mac: `Metal`

Getting Started

• Requirements:

  • WezTerm

  Minimum Version: 20240127-113634-bbcac864
  Recommended Version: Nightly

  Official Installation Page

  Windows

  • Install Stable

    - Install with Scoop (non-portable) ```sh scoop bucket add extras scoop install wezterm ``` - Install with Scoop (portable) ```sh scoop bucket add k https://github.com/KevinSilvester/scoop-bucket scoop install k/wezterm ``` - Install with winget ```sh winget install wez.wezterm ``` - Install with choco ```sh choco install wezterm -y ```
  • Install Nightly

    - Install with Scoop (non-portable) ```sh scoop bucket add versions scoop install wezterm-nightly ``` - Install with Scoop (portable) ```sh scoop bucket add k https://github.com/KevinSilvester/scoop-bucket scoop install k/wezterm-nightly ```

  :bulb:
  Toast notifications don't work in non-portable installations.
  See issue https://github.com/wez/wezterm/issues/5166 for more details

  ---

  MacOS

  • Install Stable

    - Install with Homebrew ```sh brew install --cask wezterm ``` - Install with MacPort ```sh sudo port selfupdate sudo port install wezterm ```
  • Install Nighlty

    - Install with Homebrew ```sh brew install --cask wezterm@nightly ``` - Upgrade with Homebrew ```sh brew install --cask wezterm@nightly --no-quarantine --greedy-latest ```

  ---

  Linux

  Refer to the Linux installation page.
  https://wezfurlong.org/wezterm/install/linux.html

  • JetBrainsMono Nerd Font

  Install with Homebrew (Macos)

  brew tap homebrew/cask-fonts
  brew install font-jetbrains-mono-nerd-font

  Install with Scoop (Windows)

  scoop bucket add nerd-fonts
  scoop install JetBrainsMono-NF

  More Info:

  • https://www.nerdfonts.com/#home
  • https://github.com/ryanoasis/nerd-fonts?#font-installation </details/>

• Steps:

  1. # On Windows and Unix systems
     git clone https://github.com/KevinSilvester/wezterm-config.git ~/.config/wezterm

  2. And Done!!! 🎉🎉

• Things You Might Want to Change:

  • ./config/domains.lua for custom SSH/WSL domains
  • ./config/launch.lua for preferred shells and its paths

All Key Bindings

Most of the key bindings revolve around a SUPER and SUPER_REV(super reversed) keys.

• On MacOs:
  • SUPER ⇨ Super
  • SUPER_REV ⇨ Super+Ctrl
• On Windows and Linux
  • SUPER ⇨ Alt
  • SUPER_REV ⇨ Alt+Ctrl

To avoid confusion when switching between different OS and to avoid conflicting
with OS's built-in keyboard shortcuts.

• On all platforms: LEADER ⇨ SUPER_REV+Space

Miscellaneous/Useful

Copy+Paste

Cursor Movements

Tabs

Tabs: Spawn+Close

Tabs: Navigation

Tabs: Title

Tabs: Toggle Tab-bar

Windows

Panes

Panes: Split Panes

Panes: Zoom+Close Pane

Panes: Navigation

Panes: Scroll Pane

Background Images

Key Tables

See: https://wezfurlong.org/wezterm/config/key-tables.html

Key Table: resize_font

Key Table: resize_pane

References/Inspirations

• https://github.com/rxi/lume
• https://github.com/catppuccin/wezterm
• https://github.com/wez/wezterm/discussions/628#discussioncomment-1874614
• https://github.com/wez/wezterm/discussions/628#discussioncomment-5942139