README.md

wez-tmux

Port tmux key bindings to WezTerm.

Installation

Clone this repository to your $XDG_CONFIG_HOME/wezterm:

git clone https://github.com/sei40kr/wez-tmux.git $XDG_CONFIG_HOME/wezterm

Usage

local wezterm = require("wezterm")

local config = {}

if wezterm.config_builder then
    config = wezterm.config_builder()
end

-- If you have your own leader key, make sure to set it before loading this
-- plugin.
config.leader = { key = "b", mods = "CTRL" }

-- Add these lines:
require("wez-tmux.plugin").apply_to_config(config, {})

return config

Key Bindings

Key	Action
leader+leader	Send leader key
leader+[	Activate Copy Mode

Workspaces

Key	Action
leader+$	Rename the active workspace
leader+d	Unsupported
leader+s	List workspaces and switch to the selected one
leader+w	Unsupported
leader+(	Switch to the previous workspace
leader+)	Switch to the next workspace

Tabs

Key	Action
leader+c	Create a new tab in the current window
leader+,	Unsupported
leader+&	Close the current tab
leader+w	Unsupported
leader+p	Activate the previous tab
leader+n	Activate the next tab
leader+1..9	Activate the tab at the specified index
leader+l	Activate the previously active tab

Panes

Key	Action
leader+%	Split the current pane horizontally
leader+"	Split the current pane vertically
leader+{	Rotate the sequence of panes counter-clockwise
leader+}	Rotate the sequence of panes clockwise
leader+left	Activate the pane to the left
leader+down	Activate the pane below
leader+up	Activate the pane above
leader+right	Activate the pane to the right
leader+q	Activate the pane selection modal display
leader+z	Toggle the zoom state of the current pane
leader+!	Create a new tab in the current window and moves the current pane into that tab
leader+ctrl+left	Resize the current pane to the left
leader+ctrl+down	Resize the current pane below
leader+ctrl+up	Resize the current pane above
leader+ctrl+right	Resize the current pane to the right
leader+x	Close the current pane

Misc

Key	Action
leader+space	Activate Quick Select Mode

Copy Mode

Key	Action
y	Copy and exit copy mode
escape	Clear selection / Clear search pattern / Exit copy mode
v	Cell selection
shift+v	Line selection
ctrl+v	Rectangular selection
h	Move Left
j	Move Down
k	Move Up
l	Move Right
w	Move forward one word
b	Move backward one word
e	Move forward one word end
0	Move to start of this line
$	Move to end of this line
^	Move to start of indented line
shift+g	Move to bottom of scrollback
g	Move to top of scrollback
shift+h	Move to top of viewport
shift+m	Move to middle of viewport
shift+l	Move to bottom of viewport
ctrl+b	Move up one screen
ctrl+u	Move up half screen
ctrl+f	Move down one screen
ctrl+d	Move down half screen
/	Search forward
?	Search backward
n	Next keyword occurrence
N	Previous keyword occurrence

Troubleshooting

ctrl+b in Copy Mode does not work

If you don't set the leader key or explicitly set it to ctrl+b, it will conflict with ctrl+b (Move up one screen) in Copy Mode. Please set the leader key to something other than ctrl+b.