wezterm
1.
Install
❱
1.1.
Windows
1.2.
macOS
1.3.
Linux
1.4.
FreeBSD
1.5.
Build from source
2.
Features
3.
Change Log
4.
Configuration
❱
4.1.
Launching Programs
4.2.
Fonts
4.3.
Font Shaping
4.4.
Keyboard Concepts
4.5.
Key Binding
4.6.
Key Tables
4.7.
Default Key Assignments
4.8.
Keyboard Encoding
4.9.
Mouse Binding
4.10.
Colors & Appearance
4.11.
Color Schemes
❱
4.11.1.
3
4.11.2.
a
4.11.3.
b
4.11.4.
c
4.11.5.
d
4.11.6.
e
4.11.7.
f
4.11.8.
g
4.11.9.
h
4.11.10.
i
4.11.11.
j
4.11.12.
k
4.11.13.
l
4.11.14.
m
4.11.15.
n
4.11.16.
o
4.11.17.
p
4.11.18.
r
4.11.19.
s
4.11.20.
t
4.11.21.
u
4.11.22.
v
4.11.23.
w
4.11.24.
z
5.
Scrollback
6.
Quick Select Mode
7.
Copy Mode
8.
Hyperlinks
9.
Shell Integration
10.
iTerm Image Protocol
11.
SSH
12.
Serial Ports & Arduino
13.
Multiplexing
14.
Escape Sequences
15.
F.A.Q.
16.
Getting Help
17.
Contributing
18.
CLI Reference
❱
18.1.
cli
❱
18.1.1.
list-clients
18.1.2.
list
18.1.3.
move-pane-to-new-tab
18.1.4.
send-text
18.1.5.
spawn
18.1.6.
split-pane
18.2.
show-keys
19.
Lua Reference
❱
19.1.
module: wezterm
❱
19.1.1.
GLOBAL
19.1.2.
action
19.1.3.
action_callback
19.1.4.
add_to_config_reload_watch_list
19.1.5.
background_child_process
19.1.6.
battery_info
19.1.7.
column_width
19.1.8.
config_dir
19.1.9.
config_file
19.1.10.
default_wsl_domains
19.1.11.
emit
19.1.12.
enumerate_ssh_hosts
19.1.13.
executable_dir
19.1.14.
font
19.1.15.
font_with_fallback
19.1.16.
format
19.1.17.
get_builtin_color_schemes
19.1.18.
glob
19.1.19.
gradient_colors
19.1.20.
home_dir
19.1.21.
hostname
19.1.22.
log_error
19.1.23.
log_info
19.1.24.
log_warn
19.1.25.
nerdfonts
19.1.26.
on
19.1.27.
open_with
19.1.28.
pad_left
19.1.29.
pad_right
19.1.30.
permute_any_mods
19.1.31.
permute_any_or_no_mods
19.1.32.
read_dir
19.1.33.
run_child_process
19.1.34.
running_under_wsl
19.1.35.
sleep_ms
19.1.36.
split_by_newlines
19.1.37.
strftime
19.1.38.
strftime_utc
19.1.39.
target_triple
19.1.40.
truncate_left
19.1.41.
truncate_right
19.1.42.
utf16_to_utf8
19.1.43.
version
19.2.
module: wezterm.mux
❱
19.2.1.
all_windows
19.2.2.
get_active_workspace
19.2.3.
get_pane
19.2.4.
get_tab
19.2.5.
get_window
19.2.6.
get_workspace_names
19.2.7.
set_active_workspace
19.2.8.
spawn_window
19.3.
struct: Config
❱
19.3.1.
adjust_window_size_when_changing_font_size
19.3.2.
allow_square_glyphs_to_overflow_width
19.3.3.
allow_win32_input_mode
19.3.4.
alternate_buffer_wheel_scroll_speed
19.3.5.
animation_fps
19.3.6.
audible_bell
19.3.7.
automatically_reload_config
19.3.8.
background
19.3.9.
bold_brightens_ansi_colors
19.3.10.
bypass_mouse_reporting_modifiers
19.3.11.
canonicalize_pasted_newlines
19.3.12.
cell_width
19.3.13.
check_for_updates
19.3.14.
clean_exit_codes
19.3.15.
color_schemes
19.3.16.
colors
19.3.17.
cursor_blink_ease_in
19.3.18.
cursor_blink_ease_out
19.3.19.
cursor_blink_rate
19.3.20.
custom_block_glyphs
19.3.21.
daemon_options
19.3.22.
debug_key_events
19.3.23.
default_cursor_style
19.3.24.
default_cwd
19.3.25.
default_domain
19.3.26.
default_gui_startup_args
19.3.27.
default_prog
19.3.28.
default_workspace
19.3.29.
disable_default_quick_select_patterns
19.3.30.
dpi
19.3.31.
enable_csi_u_key_encoding
19.3.32.
enable_kitty_keyboard
19.3.33.
enable_scroll_bar
19.3.34.
enable_tab_bar
19.3.35.
enable_wayland
19.3.36.
exit_behavior
19.3.37.
font
19.3.38.
font_antialias
19.3.39.
font_dirs
19.3.40.
font_hinting
19.3.41.
font_locator
19.3.42.
font_rasterizer
19.3.43.
font_rules
19.3.44.
font_shaper
19.3.45.
font_size
19.3.46.
force_reverse_video_cursor
19.3.47.
foreground_text_hsb
19.3.48.
freetype_interpreter_version
19.3.49.
freetype_load_flags
19.3.50.
freetype_load_target
19.3.51.
freetype_pcf_long_family_names
19.3.52.
freetype_render_target
19.3.53.
front_end
19.3.54.
harfbuzz_features
19.3.55.
hide_tab_bar_if_only_one_tab
19.3.56.
hyperlink_rules
19.3.57.
ime_preedit_rendering
19.3.58.
initial_cols
19.3.59.
initial_rows
19.3.60.
key_map_preference
19.3.61.
key_tables
19.3.62.
launch_menu
19.3.63.
line_height
19.3.64.
min_scroll_bar_height
19.3.65.
mux_env_remove
19.3.66.
native_macos_fullscreen_mode
19.3.67.
pane_focus_follows_mouse
19.3.68.
prefer_egl
19.3.69.
quick_select_alphabet
19.3.70.
quick_select_patterns
19.3.71.
quote_dropped_files
19.3.72.
scroll_to_bottom_on_input
19.3.73.
scrollback_lines
19.3.74.
selection_word_boundary
19.3.75.
set_environment_variables
19.3.76.
show_tab_index_in_tab_bar
19.3.77.
show_update_window
19.3.78.
skip_close_confirmation_for_processes_named
19.3.79.
ssh_backend
19.3.80.
ssh_domains
19.3.81.
status_update_interval
19.3.82.
swallow_mouse_click_on_pane_focus
19.3.83.
swallow_mouse_click_on_window_focus
19.3.84.
swap_backspace_and_delete
19.3.85.
tab_and_split_indices_are_zero_based
19.3.86.
tab_bar_at_bottom
19.3.87.
tab_bar_style
19.3.88.
tab_max_width
19.3.89.
term
19.3.90.
text_blink_ease_in
19.3.91.
text_blink_ease_out
19.3.92.
text_blink_rapid_ease_in
19.3.93.
text_blink_rapid_ease_out
19.3.94.
text_blink_rate
19.3.95.
text_blink_rate_rapid
19.3.96.
tls_clients
19.3.97.
tls_servers
19.3.98.
treat_east_asian_ambiguous_width_as_wide
19.3.99.
treat_left_ctrlalt_as_altgr
19.3.100.
unicode_version
19.3.101.
unix_domains
19.3.102.
unzoom_on_switch_pane
19.3.103.
use_cap_height_to_scale_fallback_fonts
19.3.104.
use_fancy_tab_bar
19.3.105.
use_ime
19.3.106.
use_resize_increments
19.3.107.
visual_bell
19.3.108.
warn_about_missing_glyphs
19.3.109.
window_background_gradient
19.3.110.
window_close_confirmation
19.3.111.
window_decorations
19.3.112.
window_frame
19.3.113.
window_padding
19.3.114.
wsl_domains
19.3.115.
xim_im_name
19.4.
enum: KeyAssignment
❱
19.4.1.
ActivateCopyMode
19.4.2.
ActivateKeyTable
19.4.3.
ActivateLastTab
19.4.4.
ActivatePaneByIndex
19.4.5.
ActivatePaneDirection
19.4.6.
ActivateTab
19.4.7.
ActivateTabRelative
19.4.8.
ActivateTabRelativeNoWrap
19.4.9.
AdjustPaneSize
19.4.10.
AttachDomain
19.4.11.
ClearKeyTableStack
19.4.12.
ClearScrollback
19.4.13.
ClearSelection
19.4.14.
CloseCurrentPane
19.4.15.
CloseCurrentTab
19.4.16.
CompleteSelection
19.4.17.
CompleteSelectionOrOpenLinkAtMouseCursor
19.4.18.
Copy
19.4.19.
CopyTo
19.4.20.
DecreaseFontSize
19.4.21.
DetachDomain
19.4.22.
DisableDefaultAssignment
19.4.23.
EmitEvent
19.4.24.
ExtendSelectionToMouseCursor
19.4.25.
Hide
19.4.26.
HideApplication
19.4.27.
IncreaseFontSize
19.4.28.
MoveTab
19.4.29.
MoveTabRelative
19.4.30.
Multiple
19.4.31.
Nop
19.4.32.
OpenLinkAtMouseCursor
19.4.33.
PaneSelect
19.4.34.
Paste
19.4.35.
PasteFrom
19.4.36.
PastePrimarySelection
19.4.37.
PopKeyTable
19.4.38.
QuickSelect
19.4.39.
QuickSelectArgs
19.4.40.
QuitApplication
19.4.41.
ReloadConfiguration
19.4.42.
ResetFontAndWindowSize
19.4.43.
ResetFontSize
19.4.44.
RotatePanes
19.4.45.
ScrollByLine
19.4.46.
ScrollByPage
19.4.47.
ScrollToBottom
19.4.48.
ScrollToPrompt
19.4.49.
ScrollToTop
19.4.50.
Search
19.4.51.
SelectTextAtMouseCursor
19.4.52.
SendKey
19.4.53.
SendString
19.4.54.
Show
19.4.55.
ShowDebugOverlay
19.4.56.
ShowLauncher
19.4.57.
ShowLauncherArgs
19.4.58.
ShowTabNavigator
19.4.59.
SpawnCommandInNewTab
19.4.60.
SpawnCommandInNewWindow
19.4.61.
SpawnTab
19.4.62.
SpawnWindow
19.4.63.
SplitHorizontal
19.4.64.
SplitPane
19.4.65.
SplitVertical
19.4.66.
StartWindowDrag
19.4.67.
SwitchToWorkspace
19.4.68.
SwitchWorkspaceRelative
19.4.69.
ToggleFullScreen
19.4.70.
TogglePaneZoomState
19.5.
object: LocalProcessInfo
19.6.
object: MuxWindow
19.7.
object: MuxTab
19.8.
object: MuxPane
19.9.
object: PaneInformation
19.10.
object: TabInformation
19.11.
object: SshDomain
19.12.
object: SpawnCommand
19.13.
object: TlsDomainClient
19.14.
object: TlsDomainServer
19.15.
object: Pane
❱
19.15.1.
get_current_working_dir
19.15.2.
get_cursor_position
19.15.3.
get_dimensions
19.15.4.
get_domain_name
19.15.5.
get_foreground_process_info
19.15.6.
get_foreground_process_name
19.15.7.
get_lines_as_text
19.15.8.
get_logical_lines_as_text
19.15.9.
get_title
19.15.10.
get_user_vars
19.15.11.
has_unseen_output
19.15.12.
mux_pane
19.15.13.
pane_id
19.15.14.
paste
19.16.
object: Window
❱
19.16.1.
active_key_table
19.16.2.
active_workspace
19.16.3.
composition_status
19.16.4.
effective_config
19.16.5.
get_appearance
19.16.6.
get_config_overrides
19.16.7.
get_dimensions
19.16.8.
get_selection_text_for_pane
19.16.9.
leader_is_active
19.16.10.
mux_window
19.16.11.
perform_action
19.16.12.
set_config_overrides
19.16.13.
set_right_status
19.16.14.
toast_notification
19.16.15.
window_id
19.17.
object: WslDomain
19.18.
events: Gui
❱
19.18.1.
gui-startup
19.19.
events: Multiplexer
❱
19.19.1.
mux-is-process-stateful
19.19.2.
mux-startup
19.20.
events: Window
❱
19.20.1.
bell
19.20.2.
format-tab-title
19.20.3.
format-window-title
19.20.4.
open-uri
19.20.5.
update-right-status
19.20.6.
window-config-reloaded
19.20.7.
window-resized
Light
Rust
Coal
Navy
Ayu (default)
Wez's Terminal Emulator
Events emitted by the Multiplexer
The following events can be handled using
wezterm.on
:
mux-is-process-stateful
mux-startup