README.md

May 4, 2026 · View on GitHub

My WezTerm Config

Stargazers Issues Build

screenshot

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: https://github.com/gfx-rs/wgpu#supported-platforms 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)

          scoop bucket add extras
scoop install wezterm

        • Install with Scoop (portable)

          scoop bucket add k https://github.com/KevinSilvester/scoop-bucket
scoop install k/wezterm

        • Install with winget

          winget install wez.wezterm

        • Install with choco

          choco install wezterm -y
      • Install Nightly

        • Install with Scoop (non-portable)

          scoop bucket add versions
scoop install wezterm-nightly

        • Install with Scoop (portable)

          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

          brew install --cask wezterm

        • Install with MacPort

          sudo port selfupdate
sudo port install wezterm
      • Install Nighlty

        • Install with Homebrew

          brew install --cask wezterm@nightly

        • Upgrade with Homebrew

          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 install --cask font-jetbrains-mono-nerd-font

      Install with Scoop (Windows)

      scoop bucket add nerd-fonts
scoop install JetBrainsMono-NF

      More Info:

 

  • Steps:

    1. # On Windows and Unix systems
git clone https://github.com/KevinSilvester/wezterm-config.git ~/.config/wezterm
    2. Update launch and domain related option:
    3. And Done!!! 🎉🎉

 

  • Optional But Useful:

    • wezterm-types: Highly recommend setting this up for type completion and inline documentation of every configuration option, events and actions method signatures, etc. Includes type definitions for some popular Wezterm plugins as well.

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

KeysAction
F1ActivateCopyMode
F2ActivateCommandPalette
F3ShowLauncher
F4ShowLauncher (tabs only)
F5ShowLauncher (workspaces only)
F11ToggleFullScreen
F12ShowDebugOverlay
SUPER+fSearch Text
SUPER_REV+uOpen URL

 

Copy+Paste

KeysAction
Ctrl+Shift+cCopy to Clipboard
Ctrl+Shift+vPaste from Clipboard

 

Cursor Movements

KeysAction
SUPER+LeftArrowMove cursor to Line Start
SUPER+RightArrowMove cursor to Line End
SUPER+BackspaceClear Line (does not work in PowerShell or cmd)

 

Tabs

Tabs: Spawn+Close
KeysAction
SUPER+tSpawnTab (DefaultDomain)
SUPER_REV+tSpawnTab (WSL:Ubuntu)
SUPER_REV+wCloseCurrentTab
Tabs: Navigation
KeysAction
SUPER+[Next Tab
SUPER+]Previous Tab
SUPER_REV+[Move Tab Left
SUPER_REV+]Move Tab Right
Tabs: Toggle Tab-bar
KeysAction
SUPER+9Toggle tab bar
Tabs: Title
KeysAction
SUPER+0Rename Current Tab
SUPER_REV+0Undo Rename

 

Windows

KeysAction
SUPER+nSpawnWindow
SUPER+=Increase Window Size (disabled on Windows due to a bug)
SUPER+-Decrease Window Size (disabled on Windows due to a bug)

 

Panes

Panes: Split Panes
KeysAction
SUPER+\SplitVertical (CurrentPaneDomain)
SUPER_REV+\SplitHorizontal (CurrentPaneDomain)
Panes: Zoom+Close Pane
KeysAction
SUPER+EnterTogglePaneZoomState
SUPER+wCloseCurrentPane
Panes: Navigation
KeysAction
SUPER_REV+kMove to Pane (Up)
SUPER_REV+jMove to Pane (Down)
SUPER_REV+hMove to Pane (Left)
SUPER_REV+lMove to Pane (Right)
SUPER_REV+pSwap with selected Pane
Panes: Scroll Pane
KeysAction
SUPER+uScroll Lines up 5 lines
SUPER+dScroll Lines down 5 lines
PageUpScroll Page up
PageDownScroll Page down

 

Background Images

KeysAction
SUPER+/Select Random Image
SUPER+,Cycle to next Image
SUPER+.Cycle to previous Image
SUPER_REV+/Fuzzy select Image
SUPER+bToggle background focus mode

 

Key Tables

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

KeysAction
LEADER+fresize_font
LEADER+presize_pane
Key Table: resize_font
KeysAction
kIncreaseFontSize
jDecreaseFontSize
rResetFontSize
qPopKeyTable (exit)
EscPopKeyTable (exit)
Key Table: resize_pane
KeysAction
kAdjustPaneSize (Direction: Up)
jAdjustPaneSize (Direction: Down)
hAdjustPaneSize (Direction: Left)
lAdjustPaneSize (Direction: Right)
qPopKeyTable (exit)
EscPopKeyTable (exit)

References/Inspirations