qiansong1 WezTerm Configuration

repository·main·Indexed 42 days ago

https://github.com/qiansong1/wezterm-config

A customized configuration for the WezTerm terminal emulator featuring optimized keybindings, pane management, and visual styling using Nerd Fonts and Catppuccin.

Tokens
628
Snippets
1
Records
4
Agent score
5%

What's inside wezterm-config

  1. Configure Windows Right-Click Context Menu for WezTerm

    main

    To add an "Open WezTerm Here" option to the Windows directory context menu, modify the Windows Registry (regedit) as follows:

    1. Navigate to the following keys:
      • HKEY_CLASSES_ROOT\Directory
      • HKEY_CLASSES_ROOT\Directory\Background
      • HKEY_CLASSES_ROOT\Directory\Background\shell
    2. Create a new key named wezterm under shell.
      • Set the Icon data to the path of your WezTerm executable icon.
      • Set the (Default) value to the menu name (e.g., Open Wezterm Here).
    3. Create a new sub-key under wezterm named command.
      • Set the (Default) value to the command string below (adjusting the path to your actual installation directory).

    Note: Replace C:\soft\WezTerm-windows\wezterm-gui with your actual installation path.

    "C:\soft\WezTerm-windows\wezterm-gui" start --no-auto-connect --cwd "%V\"
  2. Prerequisites for the WezTerm configuration

    main

    Before applying this configuration, ensure the following are installed:

    1. WezTerm Terminal

    Install the WezTerm terminal from the official releases.

    2. Nerd Fonts

    You must install Nerd Fonts to prevent icon corruption/garbled text. It is critical that the font version matches the icon set used in the configuration.

    Recommended fonts:

    • MesloLGM Nerd Font
    • JetBrainsMono NF

    Note: If icons appear broken, ensure your font version (e.g., v3.2.1) is compatible with the icon set used in the config.

  3. Install the WezTerm configuration

    main

    To use this configuration, follow these steps:

    1. Download the repository as a compressed archive.
    2. Extract the files.
    3. Move the extracted files into your WezTerm configuration directory:
      • Linux/macOS: $HOME/.config/wezterm
      • Windows: C:\Users\<YourUsername>\.config\wezterm (e.g., C:\Users\Fizz\.config\wezterm)
  4. Keyboard shortcuts for the configuration

    main

    The following keyboard shortcuts are configured for this setup:

    ActionShortcut
    CopyCtrl+shift+c
    PasteCtrl+shift+v
    Rename Tab BarCtrl+shift+r
    Split Pane Horizontally (Left/Right)Ctrl+alt+[\]
    Split Pane Vertically (Up/Down)Ctrl+alt+[ / ]
    Close Current PaneCtrl+alt+[-]
    Maximize/Minimize Current PaneCtrl+alt+z
    FullscreenF11
    Expand Pane UpCtrl+alt+[↑]
    Expand Pane DownCtrl+alt+[↓]
    Expand Pane LeftCtrl+alt+[←]
    Expand Pane RightCtrl+alt+[→]
    Increase Font SizeAlt+[↑]
    Decrease Font SizeAlt+[↓]
    Reset Font SizeAlt+r