WezTerm Changelog

What's new in WezTerm 20240203-110809

Feb 11, 2024

Changed:
The default for freetype_load_flags is now NO_HINTING when the dpi is >= 100, otherwise DEFAULT.
wezterm -e will now wait for the spawned program to terminate before it will itself terminate.
Reverted the text cursor cell dimension change due to overwhelming and sometimes toxic feedback.
New:
We now show the Lua version in the debug overlay.
wezterm start --new-tab and wezterm connect --new-tab to request a new tab rather than a new window when spawning via an existing GUI instance. The new prefer_to_spawn_tabs option allows you to make this happen by default.
Fixed:
It was not possible to specify freetype_load_flags = 'DEFAULT'.
Changing the palette via escape sequences didn't invalidate caches correctly, so those escapes sequences wouldn't take effect.
Unix: spawning a command using a relative path, with the cwd set to a directory that contains a directory with the same name as the relative path to the command would fail with an obscure error message. #4920
x11: incorrect handling of the space key when grp:win_space_toggle was enabled via setxkbmap.
wezterm set-working-directory and wezterm imgcat didn't correctly apply tmux passthrough escape encoding.
Tab bar wouldn't immediately reflect the result of calling tab:set_title.
Command Palette: Missing space between keycaps on macOS.
macOS: stale/invalid cwd used when spawning new panes when shell integration is NOT in use.
Command Palette: would show default key assignments next to actions even if disable_default_key_bindings was configured.

New in WezTerm 20240128-202157 (Jan 29, 2024)

New in WezTerm 20240127-113634 (Jan 28, 2024)

Changed:
The default for front_end is now WebGpu.
The return type of pane.get_current_working_dir and PaneInformation.current_working_dir has changed to the new Url object, which makes it easier to handle things like percent-encoding for paths with spaces or non-ASCII characters. Please see the revised example on set_right_status for example usage with backwards compatibility in mind. #4000
Added split out github short codes from the various charselect sections into their own new Short Codes section.
CharSelect now shows emoji variations such as skin tones
Improved fuzzy matching performance in CharSelect
PaneSelect new modes MoveToNewTab, MoveToNewWindow, and SwapWithActiveKeepFocus, as well as show_pane_ids=true to show the pane ids. #4147 #3014
Nightly .deb packages are now named wezterm-nightly rather than wezterm, and are set to conflict with wezterm.
Allow window_frame colors now allow specifying the alpha channel value, which enables transparent fancy tab bar backgrounds. ?4816 #3580 ?4311
New:
wezterm imgcat now has --position, --no-move-cursor and --hold options. #3716
wezterm set-working-directory will now wrap its OSC 7 escape sequence in the tmux passthru sequence when necessary. This can be controlled via new --tmux-passthru option.
wezterm imgcat will now wrap the image transfer OSC escape sequences in the tmux passthru sequence when necessary. This can be controlled via new --tmux-passthru option. Note that tmux doesn't natively understand these sequences, and tmux will wipe out the image when it redraws the screen as part of scrolling back through its history. imgcat support in tmux is very basic effort
wezterm imgcat will compensate for tmux and conpty, which do not natively understand image protocols, and adjust the cursor position in order to avoid the shell/prompt from mangling the image after it is printing. Support for this has limitations and will not take effect when the new --position argument is used. #3624
wezterm imgcat will now resample very large images in order to increase the chances of successfully displaying an arbitrary image. In addition, there are now a number of options for explicitly resizing as a preprocessing step, and controlling the filtering and format used by the resizing, along with showing diagnostics around the resize operation. #3264
Color schemes: Aardvark Blue, alacritty, Apple System Colors, Bamboo Light, Campbell (Gogh), Ef-Arbutus, Ef-Cyprus, Ef-Day, Ef-Deuteranopia-Dark, Ef-Deuteranopia-Light, Ef-Duo-Dark, Ef-Duo-Light, Ef-Elea-Dark, Ef-Elea-Light, Ef-Frost, Ef-Kassio, Ef-Light, Ef-Maris-Dark, Ef-Maris-Light, Ef-Melissa-Dark, Ef-Melissa-Light, Ef-Night, Ef-Rosa, Ef-Symbiosis, farmhouse-dark, farmhouse-light, Firefly Traditional, flexoki-dark, flexoki-light, Github Dark (Gogh), iTerm2 Dark Background, iTerm2 Default, iTerm2 Light Background, iTerm2 Pastel Dark Background, iTerm2 Smoooooth, iTerm2 Tango Dark, iTerm2 Tango Light, Modus-Operandi-Deuteranopia, Modus-Operandi-Tinted, Modus-Vivendi-Deuteranopia, Modus-Vivendi-Tinted, Modus-Vivendi-Tritanopia, Moonfly (Gogh), Nightfly (Gogh), Oxocarbon Dark (Gogh), Rosé Pine Moon (base16), Selenized Dark (Gogh), Selenized Light (Gogh), Website (Gogh)
Preliminary support for rasterizing fonts with COLR v1 glyphs, such as more recent versions of Noto Color Emoji. #4148
wezterm cli zoom-pane. Thanks to @quantonganh! #4160
InputSelector has been enhanced to allow setting an alphabet for quickly launching items beyond the first 10 items, as well as customizing the description/label text. Thanks to @Danielkonge! #4226 #4227
notification_handling to control whether notifications are suppressed based on focus. #3727
command_palette_rows to control how many rows are displayed in the command palette. Thanks to @exastone! #4595
ToggleAlwaysOnTop, ToggleAlwaysOnBottom and SetWindowLevel key assignments for manipulating the window level. These are currently implemented only on macOS. Thanks to @rawnly! #4567
Double click on the tab bar to toggle maximize/normal state. Thanks to @junnplus! #3698 #3699
freetype_load_target and freetype_render_target can now be set to VerticalLcd for vertically decimated LCD displays. Thanks to @xiaopengli89! #4426
Pressing CTRL-[ in the launcher menu will close it. #4722
pane:get_lines_as_escapes() to retrieve text + style/formatting. #4780
Fixed:
Command Palette was using now-invalid Nerd Font 2.0 symbols for macOS keyboard shortcuts. #3988
Windows: couldn't use shifted keys like ( in the Debug Overlay. #3999
X11: fd leak on each call to wezterm.gui.enumerate_gpus. #3612
Charselect and repl recency/history were not persisted across restarts. #4047 ?4019
macOS: system font fallback didn't always find a workable fallback font. #4099 #849
F13-F24 keys are now supported. Thanks to @ovidiu-ionescu! #3937
Strikethrough position was not centered when setting line_height #4196
Text cursor filled the scaled-by line_height and cell_width dimensions rather than the native font dimensions and looked weird when either config option was not set to 1.0. #2882
Using CloseCurrentPane could sometimes leave a stranded pane in a tab. #4030
Wayland: wezterm wouldn't start on Plasma 6 or newer versions of sway. Thanks to @hexchain! #3996 #4322.
font-config: when resolving a fallback font for a text cluster like U+3065,U+2686 where no single font contains both glyphs, wezterm would fail to show a glyph for either codepoint. We now split the fallback query up and query for each individual codepoint separately. #4310
Gogh color schemes all had the incorrect cursor foreground color. #4257
Windows: crash on Windows 11 when using DX 12 with the WebGpu frontend. #4279
macOS: Leak of NSWindow and NSView objects. Thanks to @0f-0b! #4457
Initial G1 state is non-conformant. Thanks to @ninjalj! #4534 #3962
Make RIS also clear the alternate screen. Thanks to @ninjalj! #4563
DECRQCRA: treat uninitialized cells as spaces. Thanks to @ninjalj! #4565
Clamp cursor position reported by CPR. Thanks to @ninjalj! #4564
Correct SUPER modifier key handling in kitty protocol. Thanks to @gabyx! #4605
macOS: honor the window_close_confirmation config option when quitting the application. Thanks to @quantonganh! #4420 #4362
terminfo: added missing terminator to Sync capability. Thanks to @gpanders! #4578
bracketed paste escape sequences are now always stripped out of text that is pasted into the terminal. This happens even if bracketed paste mode is disabled. #4765
Sixel parser ignores P2 parameter if P1 is blank. Thanks to @joouha! #4730
X11: synthesize raw modifiers to resolve some issues with synthetic/injected key press events experienced by Espanso. Thanks to @bew! #4151 #3840
freetype_load_target had no effect. Thanks to @dkoukola! #4775 #4770
Incorrect sunset / sunrise progression. Thanks to @mikyk10! #4809 #4810
retro tab bar indented too far on macOS when using integrated titlebar buttons. Thanks to @0xdead10cd! #4505
x11/wayland: avoid including keysym name in deadkey compose cursor. #4511
Mouse wheel scrolling now works correctly when hovering over the inactive pane. Thanks to @tradiff! #4339 #2373
Scrolling glitch in Command Palette, Launcher and InputSelector. Thanks to @metiftikci! #4839
Pane resizing, especially around zooming, could sometimes leave artifacts due to a cache invalidation issue. #4828
X11: Fix an issue where SHIFT and other modifiers could be inaccurate for automated or high speed keyboard inputs. #4615 #3840
X11: can now paste STRING (latin-1) data from the clipboard, in addition to UTF-8 string data. #4402
use_resize_increments now accounts for window padding. Thanks to @jknockel! #4824
Bar shaped text cursors are now rendered above text. Thanks to @ErrorNoInternet! #4850
format-tab-title event was triggered excessively for background tabs/panes. Thanks to @crides for investigating! #4788
Updated¶
Bundled harfbuzz to 8.3.0
Bundled freetype to 2.13.1
Bundled Noto Color Emoji font to 2.038
Bundled Nerd Font Symbols font to v3.1.1.
wgpu to 0.18, which improves OpenGL compatibility with older GPUs when using WebGpu with its GL backend on Windows

New in WezTerm 20230712-072601 (Jul 12, 2023)

Changed:
The default for adjust_window_size_when_changing_font_size now depends on the window environment and the contents of tiling_desktop_environments.
Added eigth block corner glyphs to custom block glyphs. Thanks to @joouha! #3559
Don't hide mouse cursor when pressing only modifier keys. #3570
PaneSelect will now un-zoom to show all panes, then re-zoom after performing its action. #3573
Images, especially animated images, are now decoded in the background. When used as a background layer for the terminal, we now use the normal terminal background color as a placeholder until the first frame has been decoded. In other circumstances, you may observe a brief black frame while waiting for the image to decode.
You may now use CTRL-J/K to change the selection in the launcher menu, in addition to CTRL-N/P which always worked previously. #3909
Duplicate entries in CharSelect are now suppressed, making it less cluttered. Thanks to @vimpostor! #3674
New:
window:keyboard_modifiers #3444
win32_system_backdrop. Thanks to @kingavatar! #3528 #1614
wezterm cli adjust-pane-size. Thanks to @mrjones2014! #3471 #3491
augment-command-palette event for adding entries to the command palette without assigning keyboard shortcuts. #3595
char_select_bg_color and char_select_fg_color options to customize the appearance of CharSelect mode. Thanks to @junnplus! #3703
Horizontal mouse wheel events are now passed through to the terminal. Thanks to @calops! #3856
exit_behavior_messaging option to control output when holding a pane open after a process completes. #3423
default_mux_server_domain for the (almost!) equivalent to default_domain in the context of the mux server.
Fixed:
Modals, such as CharSelect and CommandPalette did not respect alternative OS-level key maps. #3470
X11/Wayland: CTRL-key presses for non-US latin keymaps regressed due to changes to improve handling of CTRL-key presses for non-latin layouts. #3610
Numerous issues with the kitty keyboard protocol implementation #2546 #3220 #3315 #3473 #3474 #3476 #3478 #3479 #3484 #3526
mux: Attempting to spawn into an ad-hoc SSH domain after the last tab could fail with a cryptic error message. The connection is now re-established. ?3480
Laggy behavior when processing a continual stream of output, for example, serial data received at a rate of 1 byte just slightly faster than mux_output_parser_coalesce_delay_ms (3ms by default). Thanks to @pcc! #3497 #3466 #837.
user-var-changed event would incorrectly trigger for every GUI window, rather than just the GUI window which contained the pane in which the variable was changed. #3524
PNG images without an alpha channel, or that were grayscale, could not be displayed by in the terminal. #3529 #3742
tab width calculation when returning a string with embedded escape sequences from a format-tab-title event handler. #3481
Windows: clicking the maximize button didn't work unless using integrated titlebar buttons. #3499
Windows: closing a window while the debug overlay was active could leave a lingering wezterm-gui.exe running. #3522
Windows: inconsistencies with win32 input mode. Thanks to @kreudom! #2235
macOS: font size is zoomed or window appears empty when first launched on a secondary monitor with different scaling settings from the primary monitor. #3503
X11/Wayland: CTRL/ALT didn't work as expected for non-latin keyboard layouts. #2845
X11: panic after a lot of horizontal touchpad scrolling. #3564
Wayland: mouse cursor wouldn't reappear after keyboard input hides it. #3334
WebGPU: window_background_opacity was not always enabled when using a vulkan backend. #3589
macOS: hang or crash when trying to copy or right click the about dialog. The about dialog has been replaced with a menu item that you can click to copy the version number. #3507 #3585
Synthesized italics were double-skewed. Thanks to @rozbb! #3613 #3555
Panic when using corrupt/invalid webp images as window background #3614
imgcat broken when using wezterm ssh. #3624
macOS: pasting file(s) will now paste the quoted full path(s) rather than just the basename of the path. Thanks to @junnplus! #3663 #3665
WebGpu: don't panic when trying to allocate a texture larger than is supported by the GPU. #3713
CopyMode("EditPattern") didn't switch the key table to search_mode #3746.
Windows: access denied error when using wezterm.plugin.require. Thanks to @nyxkrage! #3767
Windows: when shell integration was used, the last line of output could get overwritten due to a conpty issue. #3531
Changing the color palette back to the default without resetting the terminal would prevent changes to color_scheme from taking effect. #3685
ClearToEndOfLine performed in the last column of the display, when it is prepped to wrap to the next line, would incorrectly clear the last cell. #3548
WEZTERM_UNIX_SOCKET didn't get set when using wezterm start -- something. #3679
Pasting large amounts of text in helix caused issues. #3683
Wayland: Copying to clipboard was not always successful when triggered by the keyboard. Thanks to @osandov! #3929
wezterm ssh connection errors were not shown; the window would close immediately with the default exit_behavior setting. Now ssh sessions override exit_behavior="CloseOnCleanExit" while connecting so that error information can be displayed. #3941
Divide by zero panic with lots of splits and resizing panes. #3921
Spawn failures were not shown; the window would close immediately with the default exit_behavior setting. Now local commands override exit_behavior="CloseOnCleanExit" if the command fails to spawn, and a more detailed error message is shown explaining what failed. #3928 #3950
macOS: middle mouse button dragging. Thanks to @JacobMalloy! #3908
Attempting to spawn a non-local domain via the mux server would fail with invalid domain because none of the additional domains from your config were registered with the mux server. #3907
Updated:
Bundled harfbuzz to 8.0.1
Bundled freetype to 2.13.0
Bundled Nerd Font Symbols font to v3.0.1. Note that there are several breaking changes in v3.
Color schemes: 3024 (dark) (terminal.sexy), 3024 Day (Gogh), 3024 Night (Gogh), Adventure Time (Gogh), Alien Blood (Gogh), Apprentice (Gogh), Argonaut (Gogh), Arthur (Gogh), Ashes (dark) (terminal.sexy), Atom (Gogh), Bamboo, Bamboo Multiplex, Belafonte Day (Gogh), Belafonte Night (Gogh), Bespin (dark) (terminal.sexy), Birds Of Paradise (Gogh), Blazer (Gogh), Borland (Gogh), Brewer (dark) (terminal.sexy), Broadcast (Gogh), Brogrammer (Gogh), C64 (Gogh), Catppuccin Frappé (Gogh), Catppuccin Latte (Gogh), Catppuccin Macchiato (Gogh), Catppuccin Mocha (Gogh), catppuccin-frappe, catppuccin-macchiato, catppuccin-mocha, Chalk (dark) (terminal.sexy), Chalkboard (Gogh), Ciapre (Gogh), Clrs (Gogh), Cobalt 2 (Gogh), Cobalt Neon (Gogh), Codeschool (dark) (terminal.sexy), Crayon Pony Fish (Gogh), Dark Pastel (Gogh), Darkside (Gogh), Default (dark) (terminal.sexy), Desert (Gogh), Dimmed Monokai (Gogh), Earthsong (Gogh), Ef-Tritanopia-Light, Eighties (dark) (terminal.sexy), Elemental (Gogh), Embers (dark) (terminal.sexy), Espresso (Gogh), Espresso Libre (Gogh), Everblush (Gogh), Fishtank (Gogh), Flatland (Gogh), Frontend Delight (Gogh), Frontend Fun Forrest (Gogh), Frontend Galaxy (Gogh), Github (Gogh), Gnometerm (terminal.sexy), Google (dark) (terminal.sexy), Gotham (terminal.sexy), Grape (Gogh), Grass (Gogh), Grayscale (dark) (terminal.sexy), Greenscreen (dark) (terminal.sexy), Gruvbox Dark (Gogh), Hardcore (Gogh), hardhacker, Harper (Gogh), Highway (Gogh), Hipster Green (Gogh), Homebrew (Gogh), Homebrew Light (Gogh), Homebrew Ocean (Gogh), Hopscotch (base16), Hurtado (Gogh), Ic Orange Ppl (Gogh), Idle Toes (Gogh), Isotope (dark) (terminal.sexy), Jackie Brown (Gogh), Japanesque (Gogh), Jellybeans (Gogh), Kibble (Gogh), Later This Evening (Gogh), Lavandula (Gogh), Liquid Carbon (Gogh), Liquid Carbon Transparent (Gogh), Londontube (dark) (terminal.sexy), Man Page (Gogh), Marrakesh (dark) (terminal.sexy), Mathias (Gogh), Medallion (Gogh), Misterioso (Gogh), Mocha (dark) (terminal.sexy), Mona Lisa (Gogh), Monokai (dark) (terminal.sexy), Monokai Soda (Gogh), N0Tch2K (Gogh), Neopolitan (Gogh), Neutron (Gogh), Nightlion V1 (Gogh), Nightlion V2 (Gogh), niji, Nord (Gogh), Novel (Gogh), Obsidian (Gogh), Ocean (dark) (terminal.sexy), Oceanic Next (Gogh), Ollie (Gogh), Paraiso (base16), Paraiso (dark) (terminal.sexy), Paraiso Dark (Gogh), Pencil Dark (Gogh), Pencil Light (Gogh), Pnevma (Gogh), Pro (Gogh), Railscasts (dark) (terminal.sexy), Red Alert (Gogh), Red Sands (Gogh), Relaxed (Gogh), Rippedcasts (Gogh), Rosé Pine (Gogh), Rosé Pine Dawn (Gogh), Rosé Pine Moon (Gogh), Royal (Gogh), Sea Shells (Gogh), Seafoam Pastel (Gogh), Seti (Gogh), Shaman (Gogh), Slate (Gogh), Soft Server (Gogh), Solarized Darcula (Gogh), Solarized Dark Higher Contrast (Gogh), Solarized Light (Gogh), Spacedust (Gogh), Spacegray (Gogh), Spacegray Eighties (Gogh), Spacegray Eighties Dull (Gogh), Sundried (Gogh), Symphonic (Gogh), Teerb (Gogh), Terminal Basic (Gogh), Thayer Bright (Gogh), Tokyo Night, Tokyo Night Day, Tokyo Night Moon, Tokyo Night Storm, tokyonight, tokyonight-day, tokyonight-storm, Toy Chest (Gogh), Treehouse (Gogh), Twilight (dark) (terminal.sexy), Twilight (Gogh), Urple (Gogh), Vaughn (Gogh), Vibrant Ink (Gogh), Warm Neon (Gogh), Wez (Gogh), Wild Cherry (Gogh), Wombat (Gogh), Wryan (Gogh), Zenburn (Gogh)

New in WezTerm 20230408-112425 (Apr 9, 2023)

Changed:
macOS: Japanese IME users: CTRL-modified keys are no long routed to the IME by default, as it introduced problems with CTRL-key combinations for other users. A new macos_forward_to_ime_modifier_mask option has been introduced to allow you to control which modifier keys get routed to the IME, so that you can opt back in to that behavior. #2630 #2771 #2435
Multiplexer client can now send the locally configured color palette to the mux server, which makes it more straightforward to configure color schemes when using multiplexing.
Multiplexer: closing a window that has any mux client panes will now detach the associated domain(s) on close. Previous behavior was to treat just the panes in the window as detached without actually detaching the whole domain, which would cause the window to recycle and activate a different workspace. With a definitive detach, the window will close and wezterm will terminate if the only panes were associated with that domain, which is what most users expect. #2644
quick_select_patterns and hyperlink_rules now support backreferences and look around assertions. #3247
wezterm replay new options --explain-only, --cat. #3446
New:
PromptInputLine action for prompting the user for a line of text and then doing something with it. Can be used to prompt for (re)naming new or existing tabs, workspaces and so on.
InputSelector action for prompting the user to select an item from a list and then doing something with it.
pane:activate() and tab:activate(). #3217
ulimit_nofile and ulimint_nproc options. ?3353
serial_ports for more convenient access to serial ports
ssh_domains now auto-populate from your ~/.ssh/config file. You can use wezterm.default_ssh_domains() to obtain that same information and amend/extend it.
display_pixel_geometry to specify subpixel antialiasing geometry. ?3422
Integrated title and tab bar. See also window_decorations, integrated_title_button_style, integrated_title_buttons, integrated_title_button_alignment integrated_title_button_color and, if you are using the retro tab bar, tab_bar_style. Thanks to @yuraiz for getting things moving! #2722 #1180
Lua: gui_window:active_tab(), gui_window:active_pane() (surprise! this was already there, just undocumented!), mux_window:active_tab(), mux_window:active_pane(), tab:active_pane() methods for conveniently getting at the active tab/pane from a window/tab.
wezterm cli set-tab-title and wezterm cli set-window-title. #522 #1598
wezterm cli rename-workspace. #2787
wezterm.mux.rename_workspace. #2787
wezterm cli get-pane-direction
pane:get_tty_name() and PaneInformation.tty_name to reason about the tty name on local unix systems.
wezterm.has_action() makes it easier to author a wezterm config that works across different wezterm versions. #3454
Color schemes: Ef-Autumn, Ef-Bio, Ef-Cherie, Ef-Dark, Ef-Spring, Ef-Summer, Ef-Trio-Dark, Ef-Trio-Light, Ef-Tritanopia-Dark, Ef-Winter, Gruvbox Material (Gogh), Modus-Operandi, Modus-Vivendi
Fixed:
mux: Stale remote window mapping could prevent spawning new tabs in remote domain. #2759
mux: Splitting then killing a pane could result in incorrect pane sizes. #3386
Windows: "error converting Lua string to &str" on systems with an ACP that was not compatible with UTF-8 when wezterm was placed in a directory with a non UTF-8, non-ASCII name. #3390
mux: --config related command line options passed to wezterm-mux-server were not propagated when using --daemonize. #3397 #2686
mux: server would lock and then unlock the pid/lock file when it re-executed, rendering it useless.
tab:panes_with_info() reported incorrect is_zoomed value. #3404
window:perform_action() now awaits the dispatch of the key assignment action, making it less racy to script multiple actions in a row. Note that clipboard operations are still asynchronous with respect to the dispatch of the assignment. #3405
window:perform_action() now correctly resolves overlay panes such as Copy Mode. #3209
macOS: CTRL-Q had to be pressed twice to register when use_ime=true. #2630
mux: tab:set_title() didn't get passed to the remote server, so any tab title changes were lost when reconnecting. #1598
wezterm connect --workspace WS DOM didn't use the provided workspace when starting up the mux server. #2734
mux: ClearScrollback was not forwarded to remote server. #2624
ssh: %r %h and %p tokens were implicitly supported by libssh but stopped working in ProxyCommand when we took over running the proxy command. #3437
mux: Improved latency for large window sizes. #1872
mux: pane:has_unseen_output() and PaneInformation.has_unseen_output now work with multiplexer panes. #2625
mux: attempting to split a remote pane into a different target domain could produce a warning about the remote home directory not being readable to the local machine or vice versa. #3442
wezterm.config_builder now works with table.insert(config.keys, {..})
mux: wezterm cli activate-pane-direction inconsistent behavior with remote mux. #3387 #3448
quick_select_patterns didn't take precedence over built-in rules. #3456
Painted pane background color behind the tab bar when there was only one pane. Matters when the tab bar is transparent! #3450
Wayland: window not repainting consistently when using the keyboard when using front_end="WebGpu". Thanks to @jokeyrhyme for working through different iterations of this fix! #3126
Windows: reloading the config could partially knock the window out of full screen mode. #3439

New in WezTerm 20230320-124340 (Mar 21, 2023)

New:
Copy Mode now supports using CTRL-u and CTRL-d to move by half a page at a time. Thanks to @pengux! #2662
macOS: allow association with .command, .sh, .zsh, .bash, .fish and .tool scripts, so that those can open and show their output in the terminal. #2871 #2741
macOS: initial cut at macOS native menu bar #1485
mux: exposed MuxDomain to lua, along with wezterm.mux.get_domain(), wezterm.mux.all_domains() and wezterm.mux.set_default_domain().
hide_mouse_cursor_when_typing option to control whether the mouse cursor is hidden when typing. Thanks to @ProspectPyxis! #2946
pane:get_text_from_region(), pane:get_text_from_semantic_zone(), pane:get_semantic_zones(), pane:get_semantic_zone_at()
Color schemes: Apple Classic, Breath (Gogh), Breath Darker (Gogh), Breath Light (Gogh), Breath Silverfox (Gogh), Breeze (Gogh), catppuccin-latte, Everblush, Everforest Dark (Gogh), Everforest Light (Gogh), GruvboxDark, GruvboxDarkHard, Kanagawa (Gogh), Predawn (Gogh), rose-pine, rose-pine-dawn, rose-pine-moon, Solarized (dark) (terminal.sexy), tokyonight_moon
window:focus(), ActivateWindow, ActivateWindowRelative, ActivateWindowRelativeNoWrap
Copy Mode: added MoveForwardWordEnd, thanks to @GZLiew! #2908
tab:get_size(), tab:rotate_counter_clockwise(). tab:rotate_counter_clockwise().
wezterm.config_builder()
gui-attached event provides some more flexibility at startup.
wezterm cli get-text command for capturing the content of a pane.
macOS: added a dock menu that allows spawning new windows. Thanks to @dahlia! #3054
quit_when_all_windows_are_closed configuration option.
CTRL-SHIFT-P now activates the new command palette #1485
wezterm ssh now supports %l and %L tokens in config files. #3176
hyperlink_rules now support specifying which capture group should be highlighted.
wezterm.default_hyperlink_rules function makes it easier to extend the default set of hyperlink rules.
Fixed:
X11: hanging or killing the IME could hang wezterm #2819
wezterm ssh now respects the AddressFamily option when connecting #2893
Windows: panic when minimizing a window when front_end='WebGpu' #2881
X11: wezterm.screens().active is now populated based on the currently focused window, rather than just copying the main screen data. Thanks to @NBonaparte! #2928
Resizing windows when overriding the dpi in the config would not respect the specified dpi. Thanks to @niclashoyer! #2914 #2978
Wayland: mouse cursor didn't auto-hide when typing. Thanks to @jmbaur! #2977
mux: default_workspace was not always respected when spawning #2981
window:active_key_table() now factors in pane-specific key table stacks for things like CopyMode. #2986
modal overlays like CharSelect and the command palette sometimes wouldn't render when first activated until pressing a key.
lag when making heavy use of foreground process information in tab titles. #2991
X11: always update selection owner even if our window already owns it #2926
command output would not be displayed if the command exited almost immediately after starting up.
Windows: ALT key was not recognized when processing mouse events. Thanks to @mbikovitsky! #3053
Copy Mode: MoveForwardWord not always moving to next line. thanks to @GZLiew! #2955
Wayland: fixup hidpi scaling when front_end="WebGpu". Thanks to @valpackett! #2877
Reloading the config while a pane was zoomed could result in visual artifacts #3068
SSH: Closing an individual pane via CloseCurrentPane would kill the remote pane but not detect that it had exited. #3095
Panic when decoding animated webp images #3250
Config was not applied to non-zoomed panes when config was reloaded #3259
Default hyperlink_rules now match URLs with port numbers #928
Incorrect cursor position after processing iTerm2 image escape sequence #3266
Images are now buffered to temporary files and decoded in background threads. This reduces the RAM overhead especially of long animations and reduces the render latency due to decoding frames; animations now render as soon as the first frame is decoded. #3263
Improved compatiblity with the Kitty Image Protocol #2716
wezterm.time.call_after would not work when used in an event callback. #3026
Hover state not correctly indicated for retro tab bar when showing at the bottom of the window #3113
Changed:
CTRL-SHIFT-P now activates the new command palette, instead of PaneSelect #1485
Window title reporting escape sequences are now disabled by default. See here for more details
Withdraw DEC private SGR escapes that affect superscript and subscript due to xterm/vim conflict mintty/#1189
Removed deprecated Copy, Paste and PastePrimarySelection actions. Use CopyTo and PasteFrom instead.
wezterm -e is now an alias for wezterm start. Thanks to @Abdiramen! #2889 #2782
bold_brightens_ansi_colors now supports "BrightOnly" to use the bright color without selecting a bold font. #2932
Color schemes: Gruvbox Dark was renamed to GruvboxDark and adjusted in the upstream iTerm2-Color-Schemes repo
Config warnings, such as using deprecated or invalid fields will now cause the configuration error window to be shown. Previously, only hard errors were shown, which meant that a number of minor config issues could be overlooked.
Referencing wezterm.GLOBAL now returns references rather than copies, making it less cumbersome to code read/modify/write with global state
wezterm start now accepts --domain and --attach options. wezterm connect DOMAIN is now implemented internally as wezterm start --domain DOMAIN --attach.
X11: spurious pointer focus events no longer influence terminal focus events. Thanks to @NBonaparte! #2959
Copy Mode: Added Home and End default assignments. Thanks to @cunha! #2762
wezterm.mux.spawn_window and SpawnCommandInNewWindow now accept a position field to control initial gui window position. #2976
X11/Wayland: Mouse based selection once again copies to both the clipboard and the primary selection. This was the original intended behavior but a regression in an earlier release changed it by accident and it's been annoying me ever since. You are welcome to define your own mouse bindings if you want to change that behavior.
WSL Domains returned from wezterm.default_wsl_domains now set default_cwd="~" #2826
wezterm now also searches $XDG_CONFIG_DIRS as well as $XDG_CONFIG_HOME when searching for config files. Thanks to @jmbaur! #3146
wezterm.time.call_after now accepts fractional numbers of seconds. #3287
Updated:
Bundled harfbuzz updated to version 6.0.0
Bundled Nerd Font Symbols font to v2.3.3

New in WezTerm 20221119-145034 (Nov 20, 2022)

Improved:
Reduced CPU and RAM utilization, reduced overhead of parsing output and rendering to the GPU.
New:
Wezterm.gui.default_key_tables and wezterm.gui.default_keys for more conveniently copying and extending the default configuration.
Normalize_output_to_unicode_nfc option to normalize terminal output to Unicode NFC prior to applying it to the terminal model. #2482
Cursor_thickness, underline_thickness, underline_position and strikethrough_position options to fine tune appearance. #2505 #2326
Support for modifyOtherKeys keyboard encoding #2527
Superscript and subscript text attributes via SGR 73 and SGR 74
Wezterm cli activate-pane-direction command. Thanks to @abusch! #2526
Window:is_focused() method for testing whether a GUI window has focus. #2537
Window-focus-changed event.
Pane:inject_output method
ResetTerminal key assignment
Support for Utf8 mouse reporting (DECSET 1005). #2613
ActivateKeyTable now also supports prevent_fallback = true as a parameter. #2702
Show_tabs_in_tab_bar and show_new_tab_button_in_tab_bar config options to customize the tab bar appearance. #2082
Fixed:
Wayland: key repeat gets stuck after pressing two keys in quick succession. Thanks to @unrelentingtech! #2492 #2452
If the underline attribute was active and CRLF scrolled a new line into the bottom of the display, we'd fill that new line with underlines. #2489
Correctly invalidate the display when using wezterm.action.ClearScrollback("ScrollbackAndViewport") #2498
Hyperlinks didn't underline on hover #2496
Base16 color schemes cursor fg/bg were the same. We now also set the indexed colors. Thanks to @unrelentingtech! #2491
Panic when processing a sixel with inconsistent width information #2500
Cells with the invisible/hidden attribute are now invisible
Panic when trying to activate the search overlay when the launcher menu is active #2529
Overlays did not see config overrides set via window:set_config_overrides #2544
Closing a window while tab had a zoomed pane would leave the other panes untouched and wezterm would linger in the background #2548
CharSelect panic when pressing enter when no matches were found #2580
Panic when setting initial_rows or initial_cols to 0 #2593
X11: Crash on systems using DRI2 based Intel graphics #2559
Missing validation of conflicting domain names #2618
Creating tabs in a multiplexing domain could fail after previously closing all tabs connected to that domain in that window #2614
CharSelect now uppercases hex digit input for better compatibility with QMK-based keyboards that send eg: CTRL-SHIFT-U e 1 <ENTER>. #2581
Multiple active multiplexer client domain connections could result in showing duplicate tabs in a window #2616
Incorrect line width when applying hyperlink rules to a wrapped line containing double-wide cells. #2568
Incorrect shaping for U+28 U+FF9F #2572
Panic when hitting enter in launcher menu when no fuzzy results match #2629
Default CTRL-SHIFT-<NUM> assignments didn't work on Windows and X11 systems when key_map_preference = "Mapped" #2623
Panic when calling window:set_workspace when the default domain is a multiplexer domain. #2638
Nvim's title and titlestring options don't work when TERM=wezterm. #2112
Horizontal wheel scrolling generated incorrect mouse events #2649
Cursor color changes did not always render #2708
Unable to set cursor on Wayland/X11 #2687 #2743
Default MoveTabRelative assignments were incorrectly set to SUPER+SHIFT+Page(Up|Down) instead of the documented CTRL+SHIFT+Page(Up|Down) #2705
Dragging by retro tab bar left or right status area would jump around erratically. #2758
Fixed background Cover algorithm. Thanks to @xiaopengli89! #2636
Wezterm start --cwd . didn't use the cwd of the spawned process when the wezterm gui was already running. Thanks to @exactly-one-kas! #2661
IME composition text and cursor color incorrectly applied to all panes rather than just the active pane. #2569
Changed:
Removed Last Resort fallback font
X11: use _NET_WM_MOVERESIZE to drag by tab bar, when supported by the WM #2530
Tab:panes() and tab:panes_with_info() now return the full list of panes in the tab regardless of whether a pane was zoomed. Previously, if a pane was zoomed, only that pane would be returned by those methods.
MacOS: CTRL-modified keys are now routed to the IME #2435
Multiplexer: The lag indicator that gets overlaid on the pane content when waiting a long time for a response now defaults to disabled. It is recommended that you put it into your status bar, but you may re-enable the old way using overlay_lag_indicator = true in the appropriate domain configuration.
Added dummy -e command line option to support programs that assume that all terminal emulators support a -e option. Thanks to @vimpostor!. #2670 #2622 #2271
Windows: installer no longer prevents installing the x64 binary on arm64 systems. The x64 executable is installed and run via emulation. Thanks to @xeysz! #2746 #2667
Updated:
Bundled Nerd Font Symbols font to v2.2.2
Bundled harfbuzz to 5.3.1

New in WezTerm 20220905-102802 (Sep 6, 2022)

New in WezTerm 20220904-064125 (Sep 4, 2022)

New in WezTerm 20220807-113146 (Aug 10, 2022)

New:
ActivateKeyTable now supports until_unknown=true to implicitly pop the table when a key not defined by that table is pressed. #2178
window:copy_to_clipboard method for putting arbitrary text into the clipboard/selection.
window:set_inner_size method for controlling window size.
window:set_position method for controlling window position.
window:maximize and window:restore methods for controlling window maximization state.
window:get_selection_escapes_for_pane method for getting the current selection including escape sequences. #2223
window:current_event method for getting the current event. #2296
wezterm.color module for working with colors and importing color schemes.
wezterm.gui module and mux_window:gui_window method.
wezterm.gui.screens() function for getting information about the available screens/monitors/displays
wezterm.gui.get_appearance() function for a simpler way to get system dark mode state
wezterm.procinfo module for querying local process information.
wezterm.time module for working with time, including methods for determining sun rise/set.
You may now use wezterm.format (or otherwise use strings with escape sequences) in the labels of the Launcher Menu.
You may now specify assume_emoji_presentation = true (or false) in wezterm.font() and wezterm.font_with_fallback()
Wayland: zwp_text_input_v3 is now supported, which enables IME to work in wezterm if your compositor also implements this protocol.
wezterm.json_parse() and wezterm.json_encode() functions for working with JSON.
Hundreds of new color schemes have been imported from base16, Gogh and terminal.sexy. Browse the schemes and look for themes with (base16), (Gogh) and (terminal.sexy) in the name to discover them!
pane:is_alt_screen_active() for testing whether the alt screen is active. Thanks to @Funami580! #2234
X11/Wayland: XDG desktop portal is now used to determine whether dark mode is in use #2258
SetPaneZoomState key assignment and MuxTab:set_zoomed() for explicitly setting the zoom state of a pane. #2284
mouse_bindings can now handle scroll events. Thanks to @Funami580! #2173 #2296
mouse_bindings may now also be defined based on whether the alt-screen is active and/or whether the application in the pane has enabled mouse reporting. #581
wezterm.action.CopyMode('ClearSelectionMode') allows clearing the selection mode without leaving Copy Mode. Thanks to @aznhe21! #2352
window:set_left_status for setting status to the left of the tabs in the tab bar #1561
Changed:
If timeout_milliseconds is specified in ActivateKeyTable, then the timeout duration is now reset each time a key press matches that key table activation. #1129
The lua examples in the docs are now syntax checked and formatted via Gelatyx and StyLua, thanks to @azzamsa! #2273 #2253
Internal scrollback datastructure improvements reduce per-cell overhead by up to ~40x depending on the composition of the line (lines with lots of varied attributes or image attachments will have more overhead).
Improved search performance
Quickselect: now defaults to searching 1000 lines above and below the current viewport, making it faster and the labels shorter for users with a larger scrollback. A new scope_lines parameter to QuickSelectArgs allows controlling the search region explicitly. Thanks to @yyogo for the initial PR! #1317
OSC 10, 11 and 12 (Set Default Text Background, Default Text Foreground Color, and Text Cursor Color) now support setting the alpha component #2313, and added CSI 38:6, CSI 48:6 and CSI 58:6 extensions to allow setting full color RGB with Alpha channel for spans of text.
Copy Mode: setting the same selection mode a second time will now toggle off that mode and clear the selection, preserving the current position #2246
Copy Mode: new default vim-style y "yank" key assignment will copy the selection and close copy mode
Fixed:
ActivateKeyTable's replace_current field was not actually optional. Made it optional. #2179
winget causes toast notification spam #2185
wezterm connect sshdomain could hang on startup if password authentication was required #2194
colors.indexed would error out with Cannot convert String to u8. #2197
X11: closing a window when multiple were open could result in an X protocol error that closed all windows #2198
Config will now automatically reload after error. Previously, you would need to manually reload the config using ReloadConfiguration. #1174
Config will now automatically reload for changes made to required lua files. Previously, only the main config file and any files that you explicitly passed to add_to_config_reload_watch_list would trigger a reload.
macOS: numeric keypad enter generated CTRL-C instead of enter. Regression of #739. #2204
Wayland: inconsistent pasting. Thanks to @Funami580! #2225 #2226
win32 input mode: fixed encoding of backspace and delete keys. Thanks to @kreudom! #2233
Tab bar could glitch and show incorrect contents when adjusting for monitor or changed font scaling #2208
Wayland: transparent gap under tab bar when window is transparent, split and using per-pane color schemes #1620
Tab bar could show a gap to the right when resizing
Padding could show window background rather than pane background around split panes at certain window sizes #2210
Loading dynamic escape sequence scripts from the iTerm2-Color-Scheme dynamic-colors directory would only apply the first 7 colors
Unix: Clicking a URL when no browser is open could cause wezterm to hang until the newly opened browser is closed. #2245
Quickselect: now selects the bottom-most match rather than the top-most match. #2250
Mux: wezterm.mux.set_active_workspace didn't update the current window to match the newly activated workspace. #2248
Overlays such as debug and launcher menu now handle resize better
Shift-F1 through F4 generated different encoding than xterm #2263
X11/Wayland: apps that extract the Exec field from wezterm.desktop (such as thunar, Dolphin and others) can now simply concatenate the command line they want to invoke, and it will spawn in the their current working directory. Thanks to @Anomalocaridid! #2271 #2103
gui-startup now passes a SpawnCommand parameter representing the wezterm start command arguments.
Tab x button is no longer obscured by tab title text for long tab titles #2269
Cursor position could end up in the wrong place when rewrapping lines and the cursor was on the rewrap boundary #2162
Two or more panes closing at the same time could result in their containing tab hanging and being stuck with "no pane" for a title #2304
Visual Bell now fills out to the adjacent window edges rather than being constrained by the padding. #2364

New in WezTerm 20220624-141144 (Jun 25, 2022)

New:
background option for rich background compositing and parallax scrolling effects.
Added docs for the cli
Support for the Kitty Keyboard Protocol. Use enable_kitty_keyboard=true to enable it.
New wezterm.mux module, gui-startup and mux-startup events for spawning programs into your preferred arrangement when wezterm starts.
ssh client now supports BindAddress. Thanks to @gpanders!
PaneInformation.domain_name and pane:get_domain_name() which return the name of the domain with which a pane is associated.
You may now use CTRL-n and CTRL-p (in addition to the up/down arrow and vi motion keys) to change the selected row in the Launcher. Thanks to @Junnplus!
Attaching multiplexer domains now attaches the first window as a tab in the active window, rather than opening a new window.
AttachDomain and DetachDomain key assignments
Specifying a domain name in a SpawnCommand will cause that domain to be attached if it is in the detached state. This is useful when combined with SwitchToWorkspace.
X11: wezterm now sets _NET_WM_NAME in addition to WM_NAME for clients that don't know how to fallback
treat_east_asian_ambiguous_width_as_wide for control over how ambiguous width characters are resolved.
clean_exit_codes config to fine tune exit_behavior
ClearSelection key assignment
wezterm cli list --format json and wezterm cli list-clients --format json allow retrieving data in json format. Thanks to @ratmice!
macOS, Windows, Wayland: you may now drag and drop files from other programs and have their paths paste into the terminal. The new quote_dropped_files option controls how the file names are quoted. Thanks to @junnplus, @datasone and @Funami580!
The mouse scroll wheel now cycles between tabs when hovering over the tab. Thanks to @junnplus!
Holding down ALT while dragging the left button will select a rectangular block. It is also possible to use ALT+SHIFT to select a rectangular block. ExtendSelectionToMouseCursor and SelectTextAtMouseCursor now accept "Block" as a selection mode. Thanks to @Funami580 for helping!
In Copy Mode, CTRL-v will enable rectangular block selection mode.
In Copy Mode, SHIFT-v will enable line selection mode. Thanks to @bew!
In Copy Mode, o and O can be used to move the cursor to the other end of the selection, as in vim. Thanks to @bew!
Copy Mode: key assignments are now configurable
Search Mode: key assignments are now configurable
Search Mode: the default CTRL-SHIFT-F key assignment now defaults to the new CurrentSelectionOrEmptyString mode to search for the current selection text, if any. See Search for more info.
Copy Mode and Search Mode can be toggled and remember search results and cursor positioning, making it easier to locate and select text without using the mouse
In the Launcher Menu, you may now use CTRL-G to cancel/exit the launcher
cell_width option to adjust the horizontal spacing when the availble font stretches are insufficient.
min_scroll_bar_height to control the minimum size of the scroll bar thumb
RotatePanes key assignment for re-arranging the panes in a tab
SplitPane key assignment that allows specifying the size and location of the split, as well as top-level (full width/height) splits. wezterm cli split-pane --help shows equivalent options you can use from the cli.
ime_preedit_rendering option to choose whether to use the builtin or the system IME preedit rendering mode. Thanks to @kumattau!
wezterm.strftime_utc for manipulating times in UTC rather than the local timezone
wezterm cli send-text --no-paste option to send text to a pain without wrapping it as a bracketed paste
PaneSelect key assignment to activate the pane selection UI to activate or swap the selected pane.
window_background_gradient now also supports Linear gradients with an angle of your choice. Thanks to @erf!
RPM and DEB packages now install zsh and bash wezterm CLI completions
Color schemes: arcoiris, duckbones, Grey-green, kanagawabones, Neon, neobones_dark, neobones_light, seoulbones_dark, seoulbones_light, tokyonight-day, tokyonight-storm, tokyonight, vimbones, zenbones, zenbones_dark, zenbones_light, zenburned, zenwritten_dark, zenwritten_light
wezterm.GLOBAL for persisting lua data across config reloads
wezterm show-keys command to show key and mouse binding assignments
Updated:
Bundled harfbuzz to 4.3.0
Changed:
Debian packages now register wezterm as an alternative for x-terminal-emulator. Thanks to @xpufx!
Windows: wezterm will now read the default environment variables from the HKLMSystemCurrentControlSetControlSession ManagerEnvironment and HKCUEnvironment and apply those to the base environment prior to applying set_environment_variables.
Key Table lookups will now keep searching the activation stack until a matching assignment is found, allowing for layered key tables.
Search mode's search term is now remembered per-tab between activations of search mode.
Quickselect no longer jumps to the bottom of the viewport when activated, allowing you to quickselect within the current viewport region
Quickselect now supports multi-line anchors such as ^ and $.
Overriding config using the cli --config option will now error out and prevent starting up if unknown config options are specified, or if the value evaluates to nil. Unknown options continue to generate warnings (rather than errors) when observed in the config file so that you're not "locked out" of wezterm if you make a typo in the config file.
Windows: allow_win32_input_mode now defaults to true and enables using win32-input-mode to send high-fidelity keyboard input to ConPTY. This means that win32 console applications, such as FAR Manager that use the low level INPUT_RECORD API will now receive key-up events as well as events for modifier-only key presses.
Wayland: enable_wayland now defaults to true.
exit_behavior now defaults to "Close".
Fixed:
Flush after replying to XTGETTCAP, DECRQM, XTVERSION, DA2, DA3
nf-mdi-contacts nerdfont symbol treated as zero-width
X11/Wayland: CTRL-i, CTRL-j, CTRL-m misinterpreted as CTRL-Tab, CTRL-Enter, CTRL-Return
Scrollbar stopped working after a lot of output scrolled outside of the scrollback limit. Thanks to @davidrios!
Windows: uncommitted IME composition could get stuck when switching input methods.
OSC sequences, such as those that change the window or tab title, that accept a single string parameter will now join multiple parameters together. This allows window and tab titles to contain a semicolon. Thanks to @kumattau!
Unable to use ALT as a modifier for the leader key.
IME Candidate window position was incorrect. Thanks to @kumattau and @aznhe21!
Prevent panic for some classes of invalid input, found while fuzzing. Thanks to @5225225!
Detaching an ssh multiplexer domain sometimes killed the associated panes!
DecreaseFontSize wasn't quite the inverse of IncreaseFontSize. Thanks to @Funami580!
Wayland: unable to paste text that was copied before starting the initial wezterm window. Thanks to @Funami580!
Unicode NFD text could incorrectly render with repeated glyphs
Windows: spawning new panes/tabs wouldn't automatically use the working directory of the current pane when OSC 7 was not being used
Wayland: panic when display scaling is enabled.
Dark+ color scheme background color
Synthesized bold didn't kick in for automatically computed font_rules.
Added freetype_pcf_long_family_names option to workaround PCF font naming issues on certain Linux distributions.
X11/Wayland: wezterm.desktop now specifies StartupWMClass. Thanks to @uncomfyhalomacro!
sudo -i in a pane would cause subsequent pane/tab creation to fail until the cwd was changed to an accessible directory
X11: Fixed an issue where some events could get lost around resize events, especially prevalent when using the NVIDIA proprietary drivers. Thanks to @pjones123 and @yuttie for working through this!
macOS: SHIFT-Tab and CTRL-SHIFT-Tab produced incorrect results
X11: Fixed an issue where copy and paste between two wezterm windows could produce stale results.
Mouse selection spanning multiple lines always included the first column even when the mouse was to the left of the first column. Thanks to @Funami580!
Fonts: Codepoints for eg: symbol glyphs that were not explicitly listed in your font fallback list may not be resolved when used in styled (eg: bold) text.

New in WezTerm 20220408-101518 (Apr 19, 2022)

New:
Key Tables feature for powerful modal key assignments
Wezterm start --position x,y, wezterm start --position displayname:30%,30% option to control starting window position on all systems except for Wayland. See wezterm start --help for more info. #1794
Changed:
Default key assignments are mapped: again. A new key_map_preference option allows the defaults to use "Mapped" or "Physical".
Disabled ligatures for "Monaco" and "Menlo" fonts, as those have "fi" ligatures that match even for words such as find. #1786 #1736
Removed the send_composed_key_when_alt_is_pressed option. When processing generic ALT (eg: that has neither left nor right), if either send_composed_key_when_left_alt_is_pressed or send_composed_key_when_right_alt_is_pressed is true, then the composed form of the key event will be generated.
Updated and Improved:
Bundled harfbuzz to 4.2.0
On macOS, non-native fullscreen mode now attempts to avoid the notch on systems that have one. #1737
Sixel parsing performance has been improved
You may now specify a scaling factor per fallback font, which is useful when your preferred CJK font renders smaller than your Roman primary font, for example.
Color schemes: Retro, GitHub Dark, Blazer
Wayland: touchpad scroll is now more responsive/precise. Thanks to @davidrios! #1800 #1840
Kitty image protocol: now also supports shared memory data transmission. Thanks to @tantei3! #1810
Secondary DA response bumped up to persuade vim to set ttymouse=sgr by default. #1825
Fixed:
Incorrect csi-u encoding with non-ascii characters. #1746
X11 _NET_WM_ICON had red/blue channels swapped #1754
Ls-fonts output didn't quote the style field #1762
Window_decorations = "RESIZE" on Windows prevented minimize/maximize and aerosnap, double click to maximize, and had an ugly top border. Many thanks to @davidrios! #1674 #1675 #1771
On Windows, explorer shortcut icons with the maximized setting would fall out of maximized state on startup. Thanks to @davidrios! #1502
LANG environment variable was not always set on macOS, leading to mojibake when entering CJK. #1761 #1765
Fonts with only non-unicode names (eg: only using a Chinese multibyte string encoding) were treated as having names like ????? and were not accessible. #1761
Hover state of leftmost retro style tab was overly sticky when the mouse moved out of the tab. #1764
On macOS, the font size could incorrectly double or halve after waking from sleep or moving the window to/from an external monitor. #1566 #1745
On Windows, touchpad scrolling was janky. Many thanks to @davidrios! #1773 #1725 #949
X11: workaround i3-gaps not sending initial CONFIGURE_NOTIFY or FOCUS events, leading to weird initial window size and broken focus status. #1710 #1757
Hyperlink rules with more captures than replacements could panic wezterm when text matched. #1780
Malformed XTGETTCAP response. #1781
Multiplexer performance with images was unusuable for all but tiny images. #1237
CloseCurrentPane{confirm=false} would leave behind a phantom tab/pane when used with the multiplexer. #1277
CloseCurrentPane{confirm=true} artifacts when used with the multiplexer. #783
Scrollbar thumb could jump around/move out of bounds. Thanks to @davidrios! #1525
OSC 52 could stop working for tabs/panes spawned into the GUI via the CLI. #1790
Workaround for fonts with broken horizontal advance metrics #1787
Improved mouse based selection. Thanks to @davidrios! #1805 #1199 #1386 #354
X11 KP_End wasn't recognized #1804
Fontconfig matches now also treat "charcell" spacing as monospace. #1820
Multiplexer render update laggy, especially when using multiple windows. #1814 #1841

New in WezTerm 20220319-142410 (Apr 19, 2022)

New in WezTerm 20220408-101518 (Apr 16, 2022)

New:
Key Tables feature for powerful modal key assignments
wezterm start --position x,y, wezterm start --position displayname:30%,30% option to control starting window position on all systems except for Wayland. See wezterm start --help for more info.
Changed:
Default key assignments are mapped: again. A new key_map_preference option allows the defaults to use "Mapped" or "Physical".
Disabled ligatures for "Monaco" and "Menlo" fonts, as those have "fi" ligatures that match even for words such as find.
Removed the send_composed_key_when_alt_is_pressed option. When processing generic ALT (eg: that has neither left nor right), if either send_composed_key_when_left_alt_is_pressed or send_composed_key_when_right_alt_is_pressed is true, then the composed form of the key event will be generated.
Updated and Improved:
Bundled harfbuzz to 4.2.0
On macOS, non-native fullscreen mode now attempts to avoid the notch on systems that have one.
Sixel parsing performance has been improved
You may now specify a scaling factor per fallback font, which is useful when your preferred CJK font renders smaller than your Roman primary font, for example.
Color schemes: Retro, GitHub Dark, Blazer
Wayland: touchpad scroll is now more responsive/precise.
Kitty image protocol: now also supports shared memory data transmission.
Secondary DA response bumped up to persuade vim to set ttymouse=sgr by default.
Fixed:
Incorrect csi-u encoding with non-ascii characters.
X11 _NET_WM_ICON had red/blue channels swapped
ls-fonts output didn't quote the style field
window_decorations = "RESIZE" on Windows prevented minimize/maximize and aerosnap, double click to maximize, and had an ugly top border. Many thanks to @davidrios!
On Windows, explorer shortcut icons with the maximized setting would fall out of maximized state on startup.
Fonts with only non-unicode names (eg: only using a Chinese multibyte string encoding) were treated as having names like ????? and were not accessible.
Hover state of leftmost retro style tab was overly sticky when the mouse moved out of the tab.
On macOS, the font size could incorrectly double or halve after waking from sleep or moving the window to/from an external monitor.
On Windows, touchpad scrolling was janky. Many thanks to @davidrios!
X11: workaround i3-gaps not sending initial CONFIGURE_NOTIFY or FOCUS events, leading to weird initial window size and broken focus status.
Hyperlink rules with more captures than replacements could panic wezterm when text matched.
Malformed XTGETTCAP response.
Multiplexer performance with images was unusuable for all but tiny images.
CloseCurrentPane{confirm=false} would leave behind a phantom tab/pane when used with the multiplexer.
CloseCurrentPane{confirm=true} artifacts when used with the multiplexer.
Scrollbar thumb could jump around/move out of bounds. Thanks to @davidrios!
OSC 52 could stop working for tabs/panes spawned into the GUI via the CLI.
Workaround for fonts with broken horizontal advance metrics
Improved mouse based selection. Thanks to @davidrios!
X11 KP_End wasn't recognized
fontconfig matches now also treat "charcell" spacing as monospace.
Multiplexer render update laggy, especially when using multiple windows.

New in WezTerm 20220319-142410 (Mar 21, 2022)

New:
Window:composition_status() and window:leader_is_active() methods that can help populate window:set_right_status() #686
You may now use colors = { compose_cursor = "orange" } to change the cursor color when IME, dead key or leader key composition states are active.
Support for SGR-Pixels mouse reporting. Thanks to Autumn Lamonte! #1457
ActivatePaneByIndex key assignment action. #1517
Windows: wezterm may now use win32-input-mode to send high-fidelity keyboard input to ConPTY. This means that win32 console applications, such as FAR Manager that use the low level INPUT_RECORD API will now receive key-up events as well as events for modifier-only key presses. Use allow_win32_input_mode=true to enable this. #318 #1509 #1510
Windows: default_domain, wsl_domains options and wezterm.default_wsl_domains() provide more flexibility for WSL users.
Symbols Nerd Font Mono is now bundled with WezTerm and is included as a default fallback font. This means that you may use any of the glyphs available in the Nerd Fonts collection with any font without patching fonts and without explicitly adding that font to your fallback list. Pomicons have an unclear license for distribution and are excluded from this bundled font, however, you may manually install the font with those icons from the Nerd Font site itself and it will take precedence over the bundled font. This font replaces the older PowerlineExtraSymbols font. #1521.
wezterm.nerdfonts as a convenient way to resolve Nerd Fonts glyphs by name in your config file
ShowLauncherArgs key assignment to show the launcher scoped to certain items, or to launch it directly in fuzzy matching mode
Workspaces. Follow work in progress on #1531 and #1322! window:active_workspace(), default_workspace, SwitchWorkspaceRelative, SwitchToWorkspace
wezterm cli send-text "hello" allows sending text, as though pasted, to a pane. See wezterm cli send-text --help for more information. #888
local_echo_threshold_ms option to adjust the predictive local echo timing for SshDomain, TlsDomainClient and unix domains. Thanks to @qperret! #1518
It is now possible to set selection_fg and selection_bg to be fully or partially transparent. Read more. #1615
Experimental (and incomplete!) support for Bidi/RTL can be enabled through the config. Follow along in the tracking issue
Primary selection is now supported on Wayland systems that implement primary-selection-unstable-v1 or the older Gtk primary selection protocol. Thanks to @lunaryorn! #1423
pane:has_unseen_output() and PaneInformation.has_unseen_output allow coloring or marking up tabs based on unseen output. #796
Context menu extension for Nautilus. Thanks to @lunaryorn! #1092
wezterm.enumerate_ssh_hosts() function that can be used to auto-generate ssh domain configuration
Changed:
Key Assignments now use Physical Key locations by default!! Read more #1483 #601 #1080 #1391
Key assignments now match prior to any dead-key or IME composition #877
Removed the ALT-[NUMBER] default key assignments as they are not good for non-US layouts. #1542
wezterm cli, when run outside of a wezterm pane, now prefers to connect to the main GUI instance rather than background mux server. Use wezterm cli --prefer-mux to ignore the GUI instance and talk only to the mux server. See wezterm cli --help for additional information.
ScrollByPage now accepts fractional numbers like 0.5 to scroll by half a page at time. Thanks to @hahuang65! #1534
use_ime now defaults to true on all platforms; previously it was not enabled by default on macOS.
canonicalize_pasted_newlines default has changed to be more compatible for nano users, and now provides more control over the text format that is pasted. #1575
Blinking text is now eased rather than binary-blinked. See text_blink_ease_in and text_blink_ease_out, text_blink_rapid_ease_in and text_blink_rapid_ease_out for more information.
Blinking text cursor is now eased rather than binary-blinked. See cursor_blink_ease_in and cursor_blink_ease_out.
Updated and Improved:
IME and dead key composition state now shows inline in the terminal using the terminal font (All platforms, except Wayland where we only support dead key composition)
macOS: use_ime=true no longer prevents key repeat from working with some keys #1131
Bundled harfbuzz to 4.0.1
Fixed:
Regression that broke fontconfig aliases such as "monospace" #1250
Windows/X11/Wayland: CTRL+C in non-latin keyboard layouts wouldn't send CTRL+C #678
The new tab button in the fancy tab didn't respect new_tab_hover colors #1498
Font baseline alignment when mixing symbols/emoji with the main text #1499
Glitchy window resize #1491
Ligatured glyphs no longer turn partially black when cursoring through them #478
Kitty Image Protocol: didn't respect c and r parameters to scale images
Cursor location on the primary screen wasn't updated correctly if the window was resized while the alternate screen was active #1512
Windows: latency issue with AltSnap and other window-managery things #1013 #1398 #1075 #1099
Multiplexer sessions now propagate user vars #1528
Config reloads on the multiplexer server didn't cause the palette to update on the client #1526
ScrollToPrompt could get confused when there were multiple prompts on the same line #1121
Hangul text in NFD was not always correctly composed when shaping fonts. #1573
Avoid OOM when processing sixels with huge repeat counts #1610
Set the sticky bit on socket and pid files created in XDG_RUNTIME_DIR to avoid removal by tmpwatch #1601
Shaping combining sequences like e U+20d7 could "lose" the vector symbol if the font produced an entry with no x_advance. #1617
Setting the cursor color via escape sequences now take precedence over force_reverse_video_cursor. #1625
Fixed Detection of DECSDM support via DECRQM/DECRPM, Correct sixel image placement when DECSDM is set and VT340 default sixel colors. Thanks to Autumn! #1577
Fixed missing whitespace from intermediate lines when copying a wrapped logical line #1635
Unable to match Iosevka Term when multiple iosevka ttc files were installed on macOS #1630
Incorrect umask for panes spawned via the multiplexer server #1633
Fall back from top_left_arrow to left_ptr when loading XCursor themes #1655
Fixed lingering hover state in titlebar when the mouse pointer left the window. Thanks to @davidrios! #1434
We now respect the difference between Italic and Oblique font styles when matching fonts. You may explicitly specify style="Oblique" rather than using italic=true for fonts that offer both italic and oblique variants. #1646
Hang when clicking a URL would launch the browser for the first time on unix systems #1721
Wayland input handling gets broken after suspend/resume. Thanks to @LawnGnome! #1497

New in WezTerm 20220101-133340 (Jan 2, 2022)

Fancy Tab Bars are now the default. The default tab bar colors have changed to accommodate the new more native look. You can turn them off by setting use_fancy_tab_bar = false.
Support for the Kitty Image Protocol is now enabled by default. Most of the protocol is supported; animation support is not yet implemented. Try the amazing notcurses if you want to see what modern terminal graphics can do! #986
unix domains now support an optional proxy_command to use in place of a direct unix socket connection. Read more about multiplexing unix domains
ScrollToTop and ScrollToBottom key assignments #1360
SSH Domains now support specifying ssh_config overrides. #1149
default_gui_startup_args allows defaulting to starting the ssh client (for example). #1030
mux-is-process-stateful event for finer control over prompting when closing panes. #1412
harfbuzz_features, freetype_load_target, freetype_render_target and freetype_load_flags can now be overridden on a per-font basis as described in wezterm.font and wezterm.font_with_fallback.
ActivateTabRelativeNoWrap key assignment #1414
QuickSelectArgs key assignment #846 #1362
wezterm.open_wth function for opening URLs/documents with the default or a specific application #1362
pane:get_foreground_process_name() method, PaneInformation now has foreground_process_name and current_working_dir fields, and pane:get_current_working_dir is now supported on Windows for local processes, even without using OSC 7. #1421 #915 #876
ActivatePaneDirection now also supports "Next" and "Prev" to cycle through panes #976
pane:get_logical_lines_as_text to retrieve unwrapped logical lines from a pane #1468
wezterm.get_builtin_color_schemes() function to eg: pick a random scheme per window, or otherwise reason about schemes. See the docs for examples!
Added color schemes: Alabaster, CGA, MaterialDesignColors, darkermatrix, nord-light
Changed:
quickselect: we now de-duplicate labels for results with the same textual content. #1271
The default CompleteSelectionOrOpenLinkAtMouseCursor left button release assignment now also accepts SHIFT being held in order to make SHIFT-click ExtendSelectionToMouseCursor feel more ergonomic if the mouse button is released before the SHIFT key. #1204
Unicode BIDI and other zero-width graphemes are now filtered out from the terminal model. It's not ideal in the sense that that information is essentially lost when copying to the clipboard, but it makes the presentation correct. #1422
use_ime now defaults to true on X11 systems
Updated and Improved:
Bundled harfbuzz to 3.2.0
Bundled freetype to 2.11.1
Bundled NotoColorEmoji to 2.034 (with Unicode 14 support) Thanks to @4cm4k1! #1440
macos: removing the titlebar from window_decorations now preserves rounded window corners #1034
Colors can now be specified in the HSL colorspace using syntax like "hsl:235 100 50" #1436
Line/Bar cursors in force_reverse_video_cursor mode now use the text foreground color rather than the cursor border color. #1076
Improved logo appearance. Thanks to @ghifarit53! #1454
You can now pass SendKey to wezterm.action and make your keys config look more consistent
Mouse wheel events are now routed to the hovered pane, rather than sent to the focused pane #798
Fixed:
DECSTR (terminal soft reset) now turns off DECLRMM (left and right margin mode). Thanks to @ninjalj! #1376
Improved conformance of CUP, HVP, SLRM, STBM escape sequences by support empty first parameter. Thanks to @ninjalj! #1377
tab bar didn't correctly handle double-wide cells and could truncate at edges when using format-tab-title #1371
wezterm cli --no-auto-start was not respected
Pixel geometry configured on the PTY in new windows could be incorrect on HiDPI displays until the window was resized #1387
Image attachment geometry for imgcat and sixels could stretch the image across the rounded up number of cells that contained the image. #1300, #1270
Closing a split pane created inside a wezterm ssh session wouldn't actually close the pane #1197
Clicking when unfocused could lead to unwanted text selection #1140 #1310
Changing font scaling on Windows no longer causes the initial terminal rows/cols to be under-sized #1381
New version update notifications are now more coordinated between multiple wezterm GUI instances, and update related configuration now respects configuration reloading. #1402
TLS domains bootstrapping via SSH now use the libssh backend by default and work more reliably on Windows
Closing a window will no longer recursively terminate contained multiplexer client panes; the window will instead be restored when you next connect to that multiplexer server. Killing/closing individual tabs/panes will kill the panes; this change only affects closing the window. #848 #917 #1224
Colors were too intense due to over gamma correction #1025
Mesa and EGL colors were too dim due to under gamma correction #1373
wezterm ssh no longer tries to use default_prog or default_cwd when spawning additional panes on the remote host #1456
Launcher menu WSL items now launch correctly on non-US versions of Windows #1462
Korean text in NFD form is now correctly sized and rendered #1474
macOS: use_ime=true conflicted with LEADER key assignments #1409
macOS: certain keys (eg: F8 and F9) did nothing when use_ime=true. #975

New in WezTerm 20211205-192649 (Dec 6, 2021)

New in WezTerm 20211204-082213 (Dec 6, 2021)

New:
X11 now supports IME. It currently defaults to disabled, but you can set use_ime = true in your config to enable it (you need to restart wezterm for this to take effect). Many thanks to @H-M-H for bringing xcb-imdkit to Rust and implementing this in wezterm! #250 #1043
It is now possible to define colors in the range 16-255 in colors and color scheme definitions. Thanks to @potamides! #841 #1056
Added SendKey key assignment action that makes it more convenient to rebind the key input that is sent to a pane.
Added Multiple key assignment action for combining multuple actions in a single press.
Added use_resize_increments option to tell X11, Wayland, macOS window resizing to prefers to step in increments of the cell size
Visual_bell and audible_bell configuration options, as well as a bell event allows you to trigger lua code when the bell is rung. #3
Wezterm.action_callback function to make it easier to use custom events. Thanks to @bew! #1151
Wezterm connect now also supports the --class parameter to override the window class
Window_padding now accepts values such as "1cell" or "30%" to compute values based on font or window metrics.
BSDish systems now support toast notifications
Wezterm.background_child_process function to spawn a process without waiting.
Mux_env_remove setting to control which environment variables should be cleared prior to spawning processes in the multiplexer server #1225
Canonicalize_pasted_newlines option to help Windows users manage newlines in pastes #1213
SSH client now uses libssh by default. ssh_backend can be used to change this.
Unzoom_on_switch_pane option. Thanks to @yyogo #1301
Unicode_version option and corresponding OSC escape sequences that affects how the width of certain unicode sequences are interpreted.
MacOS: binaries produced by wezterm's CI are now codesigned, which resolves some spurious permission dialogs that affected some users #482
Changed:
New default key assignments: CTRL+PageUp and CTRL+Tab activate next tab, CTRL+PageDown and CTRL+SHIFT+Tab activate previous tab. ALT+{1..8} directly select the first through 8th tabs. Thanks to @friederbluemle! #1132
X11: we now allow matching visuals with >= 8 bits per rgb value. Previously, we only matched exactly 8 bits. This improve compatibility with systems that have the COMPOSITE extension disabled. Thanks to @shizeeg! #1083
The incomplete Allsorts shaper was removed.
Windows: wezterm-gui.exe now only grabs the parent process' console handle when spawned from wezterm.exe, which prevents some frustrating interactions when launching wezterm-gui.exe via start in cmd/powershell. #1278
AppImage: take care to remove APPIMAGE related environment when spawning child processes. Thanks to @srevinsaju! #1338
Updated and Improved:
Bundled harfbuzz updated to version 3.0.0, bundled freetype updated to 2.11
Window close confirmations now accept both uppercase and lowercase Y/N key presses. Thanks to @SpyrosRoum! #1119
Multi-click-streaks are now interrupted by the cursor moving to a different cell. Thanks to @unrelentingtech! #1126
.deb packages now Provides: x-terminal-emulator. #1139
Use_cap_height_to_scale_fallback_fonts now computes cap-height based on the rasterized glyph bitmap which means that the data is accurate in more cases, including for bitmap fonts. Scaling is now also applied across varying text styles; previously it only applied to a font within an wezterm.font_with_fallback font list.
Can now match fontconfig aliases, such as monospace, on systems that use fontconfig. Thanks to @unrelentingtech! #1149
Powerline semicircle glyphs now look much better. Thanks to @bew and @sdrik! #1311
Splits now look better, especially when using escape sequences to change the default background color #1256
Fixed:
Wezterm cli spawn would use the initial terminal size for a new tab, rather than using the current tab size #920
Text_background_opacity opacity was not respected
Spawning commands via the mux didn't respect the PATH configured in set_environment_variables. #1029
Cursor could have a transparent "hole" through the window with certain cursor styles
Consolas font + random input could cause a divide-by-zero when computing glyph metrics #1042
Emoji fallback was too strict in respecting VS15/VS16 presentation selection, adjust the fallback to allow showing Emoji/Text presentation if Text/Emoji was requested but not found.
X11: laggy input after selecting text. #1027
MacOS: send_composed_key_when_left_alt_is_pressed and send_composed_key_when_right_alt_is_pressed are now respected when use_ime=true. Thanks to @jakelinnzy! #1096
X11: jittery resize with some window managers #1051
X11: window:get_appearance now actually returns Dark when the theme is dark. #1098
ALT + Arrow, PageUp/PageDown, Ins, Del, Home, End incorrectly sent ESC prefixed key sequences. #892
Crash due to Out of Memory condition when the iTerm2 protocol was used to send excessively large PNG files #1031
DCH (delete char) sequence would remove cells and replace them with default-blank cells instead of blank-cells-with-current-bg-color. #789
Invisible I-beam or underline cursor when force_reverse_video_cursor = true #1076
SU (scroll up) sequence would fill with default-blank cells instead of blank-cells-with-current-bg-color. #1102
X11: computed but did not use the correct DPI for HiDPI screens #947
Performance when resolving fallback fonts via fontconfig, and of coverage calculation with freetype. Thanks to @H-M-H!
Wayland: incorrect initial surface size for HiDPI screens. Thanks to @unrelentingtech! #1111 #1112
Invisible cursor in CopyMode when using kakoune #1113
Wayland: bypass_mouse_reporting_modifiers didn't work. Thanks to @unrelentingtech! #1122
New tabs could have the wrong number of rows and columns if a tiling WM resizes the window before OpenGL has been setup. #1074
Wayland: dragging the window using the tab bar now works. Thanks to @unrelentingtech! #1127
Error matching a font when that font is in a .ttc that contains multiple font families. #1137
Wayland: panic with most recent wlroots. Thanks to @unrelentingtech! #1144
Incorrect spacing for IDEOGRAPHIC SPACE. #1161
Italic fonts weren't always recognized as being italic, resulting in italic variants being used instead of the non-italic variants in some cases! #1162
Ask freetype for cell metrics in bitmap-only fonts, rather than simply taking the bitmap width. #1165
Wezterm can now match bitmap fonts that are spread across multiple font files #1189
Ssh config parser incorrectly split Host patterns with commas instead of whitespace #1196
Search now auto-updates when the pane content changes #1205
Fonts with emoji presentation are shifted to better align with the primary font baseline #1203
The whole tab was closed when only the zoomed pane exited. #1235
Multiplexer: wrong WEZTERM_UNIX_SOCKET environment passed to children when using unix domain sockets and connect_automatically=true #1222
Multiplexer: spawning remote tabs didn't correctly record local tab mapping, resulting in phantom additional tabs showing in the client. #1222
Wezterm ls-fonts --text "✘" didn't account for the system fallback list. #849
MacOS: The Menlo font is now implicitly included in the system fallback list, as it is the only font that contains U+2718 ✘
Wezterm cli spawn --cwd .. and wezterm cli split-pane --cwd .. now resolve relative paths #1243
Incorrect DECRPTUI response to DA3. Thanks to @ninjalj! #1330
Reloading config now loads newly defined multiplexer domains, however, existing domains are not updated. #1279

New in WezTerm 20210814-124438 (Oct 29, 2021)

Fixed: ssh client would read /etc/ssh/config rather than the proper /etc/ssh/ssh_config
Updated: ssh client now processes Include statements in ssh config
x11: support for VoidSymbol in key assignments. Thanks to @digitallyserviced! #759
Fixed: UTF8-encoded-C1 control codes were not always recognized as control codes, and could result in a panic when later attempting to update the line. #768
Fixed: wezterm cli split-pane didn't use the current working dir of the source pane. #766
Fixed: double-click-drag selection could panic when crossing line boundaries #762
Fixed: wrong scaling for ligatures in Recursive Mono font #699
Fixed: incorrect Sixel HLS hue handling #775
Fixed: we now recognize the CSI 48:2:0:214:255m form of specifying true color text attributes #785
Fixed: split separators didn't respect tab_bar_at_bottom=true and were rendered in the wrong place #797
Improved: messaging around exit_behavior
Fixed: errors loading custom color schemes are now logged to the error log #794
Fixed: OSC 7 (current working directory) now works with paths that contain spaces and other special characters. Thanks to @Arvedui! #799
Changed: the homebrew tap is now a Cask that installs to the /Applications directory on macOS. Thanks to @laggardkernel!
New: bold/dim and/or italics are now synthesized for fonts when the matching font is not actually italic or doesn't match the requested weight. #815
Updated: conpty.dll to v1.9.1445.0; fixes color bar artifacts when resizing window and allows win32 console applications to use mouse events
Fixed: Windows: pane could linger after the process has died, closing only when a new pane/tab event occurs
Fixed: Windows: first character after wezterm ssh keyboard authention was swallowed #771
Fixed: Windows: detect window resizes while authenticating for wezterm ssh #696
Fixed: OSC 52 clipboard escape didn't work in the initial pane spawned in the multiplexer server #764
Fixed: splitting panes in multiplexer could fail after a network reconnect #781
Fixed: multiplexer now propagates toast notifications and color palette to client #489 #748
Fixed: neovim interprets drags as double clicks #823
New: CTRL+SHIFT+L is assigned to ShowDebugOverlay #641
Improved: antialiasing for undercurl. Thanks to @ModProg! #838
Fixed: wezterm start --cwd c:/ didn't run default_prog. Thanks to @exactly-one-kas! #851
Improved: skip_close_confirmation_for_processes_named now includes common windows shell processes cmd.exe, pwsh.exe and powershell.exe. #843
Fixed: don't keep the window alive after running something & disown ; exit #839
Improved: we now draw sextant glyphs from the Unicode Symbols for Legacy Computing block (1FB00) when custom_block_glyphs is enabled.
Changed: COLORTERM=truecolor is now set in the environment. #875
New: wezterm cli spawn --new-window flag for creating a new window via the CLI #887
Fixed: closing last pane in a tab via CloseCurrentPane could cause the window to close #890
Improved: wezterm ls-fonts --list-system shows all available fonts, wezterm ls-fonts --text "hello" explains which fonts are used for each glyph in the supplied text
Fixed: mouse cursor is now Arrow rather than I-beam when the application in the terminal has enabled mouse reporting #859
Improved: DEC Special Graphics mode conformance and complete coverage of the graphics character set. Thanks to Autumn Lamonte! #891
Fixed: click to focus now focuses the pane under the mouse cursor #881
Removed: Parasio Dark color scheme; it was a duplicate of the correctly named Paraiso Dark scheme. Thanks to @adrian5! #906
Fixed: key repeat on Wayland now respects the system specified key repeat rate, and doesn't "stick". #669
Fixed: force_reverse_video_cursor wasn't correctly swapping the cursor colors in all cases. #706
Fixed: allow multuple IdentityFile lines in an ssh_config block to be considered
Improved: implement braille characters as custom glyphs, to have perfect rendering when custom_block_glyphs is enabled. Thanks to @bew!
Fixed: Mod3 is no longer treater as SUPER on X11 and Wayland #933
Fixed: paste now respects scroll_to_bottom_on_input. #931
New: bypass_mouse_reporting_modifiers to specify which modifier(s) override application mouse reporting mode.
Fixed: focus tracking events are now also generated when switching between panes #941
New: window_frame option to configure Wayland window decorations #761
New: window:get_appearance() to determine if the window has a dark mode appearance, and adjust color scheme to match #806
Improved: improve the new-tab button formatting. Thanks to @sdrik! #950
Fixed: if a line of text was exactly the width of the terminal it would get marked as wrappable even when followed by a newline, causing text to reflow incorrectly on resize. #971
Fixed: wezterm ssh could loop forever in the background if the connection drops and the window is closed. #857
Improved: VT102 conformance. Many thanks to Autumn Lamonte! #904
New: text_blink_rate and text_blink_rate_rapid options to control blinking text. Thanks to Autumn Lamonte! #904
New: Added support for Synchronized Rendering #882
New: wezterm now draws its own pixel-perfect versions of more block drawing glyphs. See custom_block_glyphs for more details. #584
Fixed: wayland: CursorNotFound error with the whiteglass theme. #532
Improved: Can now recover from exhausting available texture space by clearing the screen. #879
Updated bundled Noto Color Emoji font to version 2.028 featuring a design update. Thanks to @4cm4k1! #1003
Fixed: wayland: putting a window in the Sway scratchpad no longer blocks the wezterm process #884
Fixed: mouse reporting now correctly reports release events when multiple buttons are pressed and released at the same time. #973
Fixed: incorrect initial window/pty size when running with some tiling window managers. #695
New: CTRL-SHIFT-L shows the debug overlay, which shows the error log and a lua repl. #641
Fixed: macOS: bright window padding on Intel-based macs #653, #716 and #1000
Improved: wezterm now uses the Dual Source Blending feature of OpenGL to manage subpixel anti-aliasing alpha blending, resulting in improved appearance particularly when using a transparent window over the top of something with a light background. #932
Fixed: copying really long lines could falsely introduce line breaks on line wrap boundaries #874
New: wezterm.add_to_config_reload_watch_list function to aid with automatically reloading the config when you've split your config across multiple files. Thanks to @AusCyberman! #989
Improved: wezterm now respects default emoji presentation and explicit emoji variation selectors (VS15 and VS16) so that glyphs that have both textual (usually monochrome, single cell width) and emoji (color, double width) presentations can be more faithfully rendered. #997
New: window_background_gradient option to configure color gradients for your window background
New: wezterm.gradient_colors function to compute RGB values for gradients for use in your config.
New: color schemes: Abernathy, Ayu Mirage, darkmatrix, Fairyfloss, GitHub Dark, HaX0R_BLUE, HaX0R_GR33N, HaX0R_R3D, Mariana, matrix, Peppermint and UltraDark

New in WezTerm 20210404-111518 (Oct 24, 2021)

New:
X11 now supports IME. It currently defaults to disabled, but you can set use_ime = true in your config to enable it (you need to restart wezterm for this to take effect). Many thanks to @H-M-H for bringing xcb-imdkit to Rust and implementing this in wezterm! #250 #1043
it is now possible to define colors in the range 16-255 in colors and color scheme definitions. Thanks to @potamides! #841 #1056
Added SendKey key assignment action that makes it more convenient to rebind the key input that is sent to a pane.
Added Multiple key assignment action for combining multuple actions in a single press.
X11, Wayland, macOS: Window resizing now prefers to step in increments of the cell size
visual_bell and audible_bell configuration options, as well as a bell event allows you to trigger lua code when the bell is run. #3
wezterm.action_callback function to make it easier to use custom events. Thanks to @bew! #1151
wezterm connect now also supports the --class parameter to override the window class
window_padding now accepts values such as "1cell" or "30%" to compute values based on font or window metrics.
BSDish systems now support toast notifications
wezterm.background_child_process function to spawn a process without waiting.
mux_env_remove setting to control which environment variables should be cleared prior to spawning processes in the multiplexer server #1225
canonicalize_pasted_newlines option to help Windows users manage newlines in pastes #1213
SSH client now uses libssh by default. ssh_backend can be used to change this.
Changed:
New default key assignments: CTRL+PageUp and CTRL+Tab activate next tab, CTRL+PageDown and CTRL+SHIFT+Tab activate previous tab. ALT+{1..8} directly select the first through 8th tabs. Thanks to @friederbluemle! #1132
X11: we now allow matching visuals with >= 8 bits per rgb value. Previously, we only matched exactly 8 bits. This improve compatibility with systems that have the COMPOSITE extension disabled. Thanks to @shizeeg! #1083
Fixed:
wezterm cli spawn would use the initial terminal size for a new tab, rather than using the current tab size #920
Text_background_opacity opacity was not respected
Spawning commands via the mux didn't respect the PATH configured in set_environment_variables. #1029
Cursor could have a transparent "hole" through the window with certain cursor styles
Consolas font + random input could cause a divide-by-zero when computing glyph metrics #1042
Emoji fallback was too strict in respecting VS15/VS16 presentation selection, adjust the fallback to allow showing Emoji/Text presentation if Text/Emoji was requested but not found.
X11: laggy input after selecting text. #1027
macOS: send_composed_key_when_left_alt_is_pressed and send_composed_key_when_right_alt_is_pressed are now respected when use_ime=true. Thanks to @jakelinnzy! #1096
X11: jittery resize with some window managers #1051
X11: window:get_appearance now actually returns Dark when the theme is dark. #1098
ALT + Arrow, PageUp/PageDown, Ins, Del, Home, End incorrectly sent ESC prefixed key sequences. #892
Crash due to Out of Memory condition when the iTerm2 protocol was used to send excessively large PNG files #1031
DCH (delete char) sequence would remove cells and replace them with default-blank cells instead of blank-cells-with-current-bg-color. #789
invisible I-beam or underline cursor when force_reverse_video_cursor = true #1076
SU (scroll up) sequence would fill with default-blank cells instead of blank-cells-with-current-bg-color. #1102
X11: computed but did not use the correct DPI for HiDPI screens #947
d: performance when resolving fallback fonts via fontconfig, and of coverage calculation with freetype. Thanks to @H-M-H!
Wayland: incorrect initial surface size for HiDPI screens. Thanks to @unrelentingtech! #1111 #1112
Invisible cursor in CopyMode when using kakoune #1113
Wayland: bypass_mouse_reporting_modifiers didn't work. Thanks to @unrelentingtech! #1122
New tabs could have the wrong number of rows and columns if a tiling WM resizes the window before OpenGL has been setup. #1074
Wayland: dragging the window using the tab bar now works. Thanks to @unrelentingtech! #1127
Error matching a font when that font is in a .ttc that contains multiple font families. #1137
Wayland: panic with most recent wlroots. Thanks to @unrelentingtech! #1144
Incorrect spacing for IDEOGRAPHIC SPACE. #1161
Italic fonts weren't always recognized as being italic, resulting in italic variants being used instead of the non-italic variants in some cases! #1162
Ask freetype for cell metrics in bitmap-only fonts, rather than simply taking the bitmap width. #1165
wezterm can now match bitmap fonts that are spread across multiple font files #1189
Ssh config parser incorrectly split Host patterns with commas instead of whitespace #1196
Search now auto-updates when the pane content changes #1205
Fonts with emoji presentation are shifted to better align with the primary font baseline #1203
The whole tab was closed when only the zoomed pane exited. #1235
multiplexer: wrong WEZTERM_UNIX_SOCKET environment passed to children when using unix domain sockets and connect_automatically=true #1222
multiplexer: spawning remote tabs didn't correctly record local tab mapping, resulting in phantom additional tabs showing in the client. #1222
Updated and Improved:
Bundled harfbuzz updated to version 3.0.0, bundled freetype updated to 2.11
Window close confirmations now accept both uppercase and lowercase Y/N key presses. Thanks to @SpyrosRoum! #1119
Multi-click-streaks are now interrupted by the cursor moving to a different cell. Thanks to @unrelentingtech! #1126
.deb packages now Provides: x-terminal-emulator. #1139
use_cap_height_to_scale_fallback_fonts now computes cap-height based on the rasterized glyph bitmap which means that the data is accurate in more cases, including for bitmap fonts. Scaling is now also applied across varying text styles; previously it only applied to a font within an wezterm.font_with_fallback font list.

New in WezTerm 20210814-124438 (Aug 15, 2021)

Fixed: ssh client would read /etc/ssh/config rather than the proper /etc/ssh/ssh_config
Updated: ssh client now processes Include statements in ssh config
x11: support for VoidSymbol in key assignments. Thanks to @digitallyserviced! #759
Fixed: UTF8-encoded-C1 control codes were not always recognized as control codes, and could result in a panic when later attempting to update the line. #768
Fixed: wezterm cli split-pane didn't use the current working dir of the source pane. #766
Fixed: double-click-drag selection could panic when crossing line boundaries #762
Fixed: wrong scaling for ligatures in Recursive Mono font #699
Fixed: incorrect Sixel HLS hue handling #775
Fixed: we now recognize the CSI 48:2:0:214:255m form of specifying true color text attributes #785
Fixed: split separators didn't respect tab_bar_at_bottom=true and were rendered in the wrong place #797
Improved: messaging around exit_behavior
Fixed: errors loading custom color schemes are now logged to the error log #794
Fixed: OSC 7 (current working directory) now works with paths that contain spaces and other special characters. Thanks to @Arvedui! #799
Changed: the homebrew tap is now a Cask that installs to the /Applications directory on macOS. Thanks to @laggardkernel!
New: bold/dim and/or italics are now synthesized for fonts when the matching font is not actually italic or doesn't match the requested weight. #815
Updated: conpty.dll to v1.9.1445.0; fixes color bar artifacts when resizing window and allows win32 console applications to use mouse events
Fixed: Windows: pane could linger after the process has died, closing only when a new pane/tab event occurs
Fixed: Windows: first character after wezterm ssh keyboard authention was swallowed #771
Fixed: Windows: detect window resizes while authenticating for wezterm ssh #696
Fixed: OSC 52 clipboard escape didn't work in the initial pane spawned in the multiplexer server #764
Fixed: splitting panes in multiplexer could fail after a network reconnect #781
Fixed: multiplexer now propagates toast notifications and color palette to client #489 #748
Fixed: neovim interprets drags as double clicks #823
New: CTRL+SHIFT+L is assigned to ShowDebugOverlay #641
Improved: antialiasing for undercurl. Thanks to @ModProg! #838
Fixed: wezterm start --cwd c:/ didn't run default_prog. Thanks to @exactly-one-kas! #851
Improved: skip_close_confirmation_for_processes_named now includes common windows shell processes cmd.exe, pwsh.exe and powershell.exe. #843
Fixed: don't keep the window alive after running something & disown ; exit #839
Improved: we now draw sextant glyphs from the Unicode Symbols for Legacy Computing block (1FB00) when custom_block_glyphs is enabled.
Changed: COLORTERM=truecolor is now set in the environment. #875
New: wezterm cli spawn --new-window flag for creating a new window via the CLI #887
Fixed: closing last pane in a tab via CloseCurrentPane could cause the window to close #890
Improved: wezterm ls-fonts --list-system shows all available fonts, wezterm ls-fonts --text "hello" explains which fonts are used for each glyph in the supplied text
Fixed: mouse cursor is now Arrow rather than I-beam when the application in the terminal has enabled mouse reporting #859
Improved: DEC Special Graphics mode conformance and complete coverage of the graphics character set. Thanks to Autumn Lamonte! #891
Fixed: click to focus now focuses the pane under the mouse cursor #881
Removed: Parasio Dark color scheme; it was a duplicate of the correctly named Paraiso Dark scheme. Thanks to @adrian5! #906
Fixed: key repeat on Wayland now respects the system specified key repeat rate, and doesn't "stick". #669
Fixed: force_reverse_video_cursor wasn't correctly swapping the cursor colors in all cases. #706
Fixed: allow multuple IdentityFile lines in an ssh_config block to be considered
Improved: implement braille characters as custom glyphs, to have perfect rendering when custom_block_glyphs is enabled. Thanks to @bew!
Fixed: Mod3 is no longer treater as SUPER on X11 and Wayland #933
Fixed: paste now respects scroll_to_bottom_on_input. #931
New: bypass_mouse_reporting_modifiers to specify which modifier(s) override application mouse reporting mode.
Fixed: focus tracking events are now also generated when switching between panes #941
New: window_frame option to configure Wayland window decorations #761
New: window:get_appearance() to determine if the window has a dark mode appearance, and adjust color scheme to match #806
Improved: improve the new-tab button formatting. Thanks to @sdrik! #950
Fixed: if a line of text was exactly the width of the terminal it would get marked as wrappable even when followed by a newline, causing text to reflow incorrectly on resize. #971
Fixed: wezterm ssh could loop forever in the background if the connection drops and the window is closed. #857
Improved: VT102 conformance. Many thanks to Autumn Lamonte! #904
New: text_blink_rate and text_blink_rate_rapid options to control blinking text. Thanks to Autumn Lamonte! #904
New: Added support for Synchronized Rendering #882
New: wezterm now draws its own pixel-perfect versions of more block drawing glyphs. See custom_block_glyphs for more details. #584
Fixed: wayland: CursorNotFound error with the whiteglass theme. #532
Improved: Can now recover from exhausting available texture space by clearing the screen. #879
Updated bundled Noto Color Emoji font to version 2.028 featuring a design update. Thanks to @4cm4k1! #1003
Fixed: wayland: putting a window in the Sway scratchpad no longer blocks the wezterm process #884
Fixed: mouse reporting now correctly reports release events when multiple buttons are pressed and released at the same time. #973
Fixed: incorrect initial window/pty size when running with some tiling window managers. #695
New: CTRL-SHIFT-L shows the debug overlay, which shows the error log and a lua repl. #641
Fixed: macOS: bright window padding on Intel-based macs #653, #716 and #1000
Improved: wezterm now uses the Dual Source Blending feature of OpenGL to manage subpixel anti-aliasing alpha blending, resulting in improved appearance particularly when using a transparent window over the top of something with a light background. #932
Fixed: copying really long lines could falsely introduce line breaks on line wrap boundaries #874
New: wezterm.add_to_config_reload_watch_list function to aid with automatically reloading the config when you've split your config across multiple files. Thanks to @AusCyberman! #989
Improved: wezterm now respects default emoji presentation and explicit emoji variation selectors (VS15 and VS16) so that glyphs that have both textual (usually monochrome, single cell width) and emoji (color, double width) presentations can be more faithfully rendered. #997
New: window_background_gradient option to configure color gradients for your window background
New: wezterm.gradient_colors function to compute RGB values for gradients for use in your config.
New: color schemes: Abernathy, Ayu Mirage, darkmatrix, Fairyfloss, GitHub Dark, HaX0R_BLUE, HaX0R_GR33N, HaX0R_R3D, Mariana, matrix, Peppermint and UltraDark

New in WezTerm 20210502-154244 (May 4, 2021)

Fixed: red and blue subpixel channels were swapped, leading to excessively blurry text when using freetype_load_flags="HorizontalLcd". #639
Fixed: the selection wouldn't always clear when the intersecting lines change #644
Fixed: vertical alignment issue with Iosevka on Windows #661
Fixed: support for "Variable" fonts such as Cascadia Code and Inconsolata on all platforms #655
New: wezterm.font and wezterm.font_with_fallback attributes parameter now allows matching more granular font weights and font stretch. e.g.: wezterm.font('Iosevka Term', {stretch="Expanded", weight="Regular"}), as fallback can specify weight/stretch/style for each individual font in the fallback.
New: freetype_render_target option for additional control over glyph rasterization.
Fixed: wezterm ssh HOST no longer overrides the User config specified by ~/.ssh/config
Fixed: X11: detect when gnome DPI scaling changes #667
Fixed: potential panic when pasting large amounts of multi-byte text #668
Fixed: X11: non-ascii text could appear mangled in titlebars #673
Improved font IO performance and memory usage on all platforms
New window:toast_notification method for showing desktop notifications. #619
Fixed: half-pixel gaps in ligatured/double-wide glyphs depending on the font size #614
Fixed: Window could vanish if a tab closed while the rightmost tab was active(!) #690
Fixed: macOS: mouse cursor could get stuck in the hidden state. #618
Improved: font_rules behavior to always append reasonable default font_rules to those that you may have specified in your config. font_rules now also include defaults for half-bright text styles.
Improved: added use_cap_height_to_scale_fallback_fonts option to scale secondary fonts according to relative their cap-height metric to improve size consistency. This partially applies to some symbol/emoji fonts, but is dependent upon the font having reliable metrics.
Improved: font-config queries now run much faster, resulting in snappier startup on unix systems
Fixed: Hide had no effect on macOS when the titlebar was disabled #679
Fixed: key and mouse assignments set via window:set_config_overrides were not respected. #656
Fixed: potential panic when word selecting off top of viewport #713
Fixed: really long busy wait when displaying single logical json line of 1.5MB in length #714
New: swallow_mouse_click_on_pane_focus option #724
New: pane_focus_follows_mouse option #600
Fixed: splitting a pane while a pane is in the zoomed state would swallow the new pane #723
Fixed: multi-cell glyphs weren't displayed in tab titles #711
New: format-window-title hook for customizing the text in the window titlebar
New: format-tab-title hook for customizing the text in tab titles. #647
Removed: active and inactive tab_bar_style config values; use the new format-tab-title event instead
New: force_reverse_video_cursor setting to override the cursor color scheme settings. #706
Fixed: ssh config parsing now expands ~ to your home directory for appropriate options; previously only %d and ${HOME} were substituted. #729
New: Quick Select Mode for a tmux-fingers/tmux-thumbs style mouse-less select and copy flow #732
Fixed: tabs would remain hovered after moving the mouse down into the main terminal area #591
New: tab_bar_at_bottom setting to put the tab bar at the bottom of the window #278
New: wezterm.column_width function for measuring the displayed width of a string
New: wezterm.pad_left, wwezterm.pad_right, wezterm.truncate_left and wezterm.truncate_right function for truncating/padding a string based on its displayed width
Updated bundled Noto Color Emoji font to version 2.020 with unicode 13.1 support. Thanks to @4cm4k1! #742
Fixed: Numpad Enter reported as CTRL-C on macOS #739
Fixed: mouse reporting button state not cleared when focus is lost, eg: from clicking a link #744
Improved: better looking curly underline. Thanks to @ModProg! #733
Fixed: wezterm now sets argv0 to -$SHELL to invoke a login shell, rather than running $SHELL -l. #753
Improved: ssh_config parsing now supports Match for Host, LocalUser.
Improved render performance for wide windows #740
New color schemes: Aurora, BlueDolphin, BlulocoDark, BlulocoLight, Doom Peacock, Galizur, Guezwhoz, PaleNightHC, Raycast_Dark, Raycast_Light, Sublette, iceberg-dark and iceberg-light.

New in WezTerm 20210405-110924 (Apr 5, 2021)

New in WezTerm 20210404-112810 (Apr 5, 2021)

Fixed: 100% CPU due to spurious resize events generated by herbstluftwm. #557
Fixed: improved conformance with xterm for keys like CTRL-6 and CTRL-/. #556
Fixed: detection and handling of fonts such as terminus-bold.otb that contain only bitmap strikes. #560
Fixed: the pixel size reported by the pty to the kernel wasn't adjusted for font metrics/dpi until the config was reloaded or window resized. #563
Fixed: greatly reduce memory consumption when system fallback fonts are loaded #559
Fixed: Windows: window_background_opacity was only taking effect when window_decorations="NONE" #553
Fixed: an issue where wezterm could hang if the process spawned by a pane doesn't quit when asked #558
Fixed: panic when dismissing the tab navigator #542
Fixed: laggy repaints for large windows particularly on Windows, but applicable to all systems. Tuned and triple-buffered vertex buffer updates. #546
Changed: allow_square_glyphs_to_overflow_width now defaults to WhenFollowedBySpace and applies to more symbol glyphs. #565
New: added skip_close_confirmation_for_processes_named option which specifies a list of processes for which it is considered safe to allow closing a pane/tab/window without a prompt. #562
Fixed: triggering the search overlay again while the search overlay is active no longer closes the underlying pane #572
Fixed: X10 mouse coordinate reporting encoding could produce invalid outputs for large windows. Capped coordinate values to the maximum value that is representable in UTF-8 encoding
Fixed: font fallback now happens asynchronously from painting #508
New: added window:get_selection_text_for_pane method #575
Fixed: implicit hyperlink rules, word and line selection now operate on logical lines which means that they deal with wrapped lines outside of the viewport. #408
New: wezterm ssh now supports reading ~/.ssh/config and overriding options via the command line. IdentityFile and ProxyCommand are the two main new supported options. Read more about it in ssh.
Fixed: ssh support will now try all available identities from the SSH agent rather than just the first.
New: splitting panes in wezterm ssh now works like spawning new tabs: the new program is started on the remote host with no additional authentication required.
Fixed: Multiplexer sessions would fail to bootstrap via ssh because the bootstrap process exited too soon. #507
Fixed: Windows: we now compile libssh2 against openssl on all platforms to improve overall key and crypto algorithm support
Fixed: spawning a new tab via the launcher menu failed because it used the pretty printed multiplexer domain label rather than the multiplexer domain name.
New: added ActivateLastTab key assignment for jumping back to a previously active tab. Thanks to @alexgartrell #610
Fixed: added missing XTSMGRAPHICS query/response for sixel support #609
Fixed: avoid showing an error dialog for synthesized font_rules when the configuration specifies a font that doesn't have bold/italic variants. #617
New: mouse cursor hides when keyboard input is sent to a pane, and shows again when the mouse is moved. #618
Fixed: wezterm-mux-server will now continue running even after all tabs/panes have been closed. #631
Fixed: when using line_height, wezterm now vertically centers the cell rather than padding only the top #582
Fixed: wezterm.config_dir was returning the config file path instead of the directory!
New: wezterm.config_file which returns the config file path

New in WezTerm 20210314-114017 (Mar 15, 2021)

New: tab_bar_style allows customizing the appearance of the rest of tha tab bar.
New: animated gif and png images displayed via wezterm imgcat (the iTerm2 image protocol), or attached to the window background via window_background_image will now animate while the window has focus.
New: added foreground_text_hsb setting to adjust hue, saturation and brightness when text is rendered.
New: added ResetFontAndWindowSize key assignment.
New: added ScrollByLine key assignment.
New: OSC 777 and OSC 9 escapes now generate Toast Notifications. printf "e]777;notify;%s;%se\" "title" "body" and printf "e]9;%se\" "hello there". These don't currently pass through multiplexer connections. #489.
New: exit_behavior config option to keep panes open after the program has completed. #499
New: added --config name=value options to wezterm, wezterm-gui and wezterm-mux-server. The --front-end, --font-locator, --font-rasterizer and --font-shaper CLI options have been removed in favor of this new mechanism.
New: window:set_config_overrides method that can be used to override GUI related configuration options on a per-window basis. Click through to see examples of dynamically toggling ligatures and window opacity. #469 #329
New: introduced custom_block_glyphs option to ensure that block glyphs don't have gaps. #433
New: you can now drag the wezterm window via the tab bar
New: holding SUPER+Drag (or CTRL+SHIFT+Drag) will drag the wezterm window. Use StartWindowDrag to configure your own binding.
New: configure window_decorations to remove the title bar and/or window border
New: we now bundle PowerlineExtraSymbols as a built-in fallback font, so that you can use powerline glyphs with any font without patching the font.
New: window:set_right_status allows setting additional status information in the tab bar. #500
New: Search Mode: Added CTRL-u key assignment to clear the current search pattern. Thanks to @bew! #465
Fonts: font_antialias and font_hinting are now deprecated in favor of the new freetype_load_target and freetype_load_flags options. The deprecated options have no effect and will be removed in a future release. The new options provide more direct control over how freetype rasterizes text.
Fonts: when computing default font_rules for bold and italic fonts, strip italic and bold components from the family name. eg: if you set font = wezterm.font("Source Code Pro Medium") then the Medium text will be stripped from the font name used to locate bold and italic variants so that we don't report an error loading a non-sensical Source Code Pro Medium Bold. #456
Fonts: fix a regression where bright windows behind wezterm could "shine through" on the alpha channel, and adjust the tinting operation to avoid anti-aliased dark fringes #470 #491
Fonts: macOS: fix an issue where wezterm could hang when loading a font located via Core Text #475
Fonts: Changed the default font_size to 12 points. #517
Fonts: Updated bundled JetBrainsMono font to version 2.225
Added --config-file CLI option to specify an alternate config file location. Read more about config file resolution. Thanks to @bew! #459
OSC 52 (Clipboard manipulation) now respects the difference between PRIMARY and CLIPBOARD on X11 systems.
Fixed an issue where large pastes could result in a hang
Closing the configuration error window no longer requires confirmation
Fixed: an issue where the window would be redrawn on mouse move. This was most noticeable as a laggy mouse pointer when moving the mouse across a window running on the nouveau display driver on X11 and Wayland systems
Fixed: an issue where closing a pane would immediately SIGKILL the associated process, rather than sending SIGHUP. Thanks to @bew!
Fixed: line-based mouse selection (default: triple click) now extends forwards to include wrapped lines. #466
Fixed: the RIS escape wasn't clearing the scrollback. #511
Wayland: fixed opengl context creation issues. Thanks to @unrelentingtech! #481
Wayland: the raw key modifiers are now correctly propagated so that they activate when used with key assignments using the key = "raw:123" binding syntax.
Wayland: fixed window decoration and full screen handling #224
Wayland: fixed an issue where key repeat processing could "run away" and hang the application
Windows: the portable .zip file download now includes ANGLE EGL, just like the setup.exe installer has done since version 20201031-154415-9614e117
Windows: Fixed ToggleFullScreen so that it once again toggles between full screen and normal placement. #177
Windows: fix the unexpected default behavior of Ctrl-Alt being converted to AltGr for layouts supporting this key, the previous behavior is still possible by enabling the option treat_left_ctrlalt_as_altgr (to solve #392). Thanks to @bew! #512
Windows: fixed "Open WezTerm Here" context menu in explorer when used on the root of a drive (eg: C:). Thanks to @flyxyz123! #526 #451
X11: fix an issue where SHIFT-Enter was not recognized #516
X11: improved DPI detection for high-DPI displays. #515
X11: we now load the XCursor themes when possible, which means that the mouse cursor is now generally a bit larger and clearer as well as conforming more with the prevailing style of the desktop environment. #524
Improved and optimized image processing so that watching videos via timg - Terminal Image and Video Viewer works better #537 #535 #534

New in WezTerm 20210203_095643 (Feb 3, 2021)

Fix cursor position after using iTerm2 image protocol #317
Fix pixel dimensions after changing the pane size; this was mostly invisible but impacted image scaling when using sixel or iTerm2 image protocols. #312
Add support for OSC 133 which allows annotating output as Output, Input (that you typed) and Prompt (shell "chrome"). Learn more about Semantic prompt and OSC 133
Add ScrollToPrompt key assignment that scrolls the viewport to the prior/next shell prompt emitted using OSC 133 Semantic Prompt escapes. This assignment is not bound by default.
Fixed an issue where SpawnWindow didn't use the current working directory from the current pane to spawn the new window
Added wezterm start --class CLASSNAME option to specify the window class name under X11 and Windows, or the app_id under Wayland. See wezterm start --help for more information.
Added shell integration for setting OSC 7 (working directory) and OSC 133 (semantic zones) for Zsh and Bash. See Shell Integration docs.
Added SemanticZone as a possible parameter for SelectTextAtMouseCursor, making it possible to conveniently select complete input or output regions.
Improved font rendering #320 #331 and changed font_antialias = "Greyscale" by default.
Updated internal harfbuzz shaper to 2.7.2
Fixed ALT-Escape not sending ESC-ESC #338
Added allow_square_glyphs_to_overflow_width = "WhenFollowedBySpace" option to allow square symbol glyphs to deliberately overflow their
specified cell width when the next cell is a space. Can be set to Always to allow overflowing regardless of the next cell being a space,
or Never to strictly respect the cell width. The default is Never. #342
macOS: Improved key input when Option is pressed. Fixed dead key processing when use_ime=true. #357
macOS: Adjusted default dpi to 72 to bring point sizes into alignment with other macOS apps. #332
Improved font fallback; we now try harder to find a system-provided font for glyphs that are not found in your explicitly configured fonts.
Revised pty output processing and removed the related ratelimit_output_bytes_per_second option
Workaround Cocoa leaking window position saved state file descriptors to child processes on macOS Big Sur, and Gnome/Mutter doing something similar under X11
The 256 color cube now uses slightly brighter colors #348
New: added line_height configuration option to scale the computed cell height. The default is 1.0, resulting in using the font-specified metrics. Setting it to 1.2 will result in a 20% larger cell height.
macOS: Fixed an issue where hovering over the split between panes could result in wezterm becoming unresponsive #391
Closing windows and QuitApplication will now prompt for confirmation before proceeding with the close/quit. Added window_close_confirmation to control this; valid values are AlwaysPrompt and NeverPrompt. #280
Tidied up logging. Previously ERROR level logging was used to make sure that informational things showed up in the stderr stream. Now we use INFO level logging for this to avoid alarming the user. You can set WEZTERM_LOG=trace in the environment to get more verbose logging for troubleshooting purposes.
Windows: fix an issue where VNC-server-emulated AltGr was not treated as AltGr #392
X11: fix an issue where keys that produce unicode characters retained SHIFT as a modifier instead of normalizing it away. #394
Fixed an issue where a symbol-only font would be seen as 0-width and panic wezterm #404
Tweaked mouse selection: we now round the x-coordinate to the nearest cell which makes it a bit more forgiving if the mouse cursor is slightly to the left of the intended cell start. #350
Added selection_word_boundary option to control double-click word selection boundaries. The default is tn{}[]()"'`. #405
Added support for Curly, Dotted and Dashed underlines. See this documentation on the escape sequences how enable undercurl support in vim and nvim. #415
Fixed an issue where wezterm would spawn processes with umask 077 on unix systems, rather than the more commonly expected umask 022. #416
macOS: We now ship a Universal binary containing both Intel and "Apple Silicon" architectures
Setting a really large or really small font scale (using CTRL +/-) no longer causes a panic #428
Fixed an issue where the mouse wheel wasn't mapped to cursor up/down when the alternate screen was active #429
Fixed ToggleFullScreen not working on macOS and X11. It still doesn't function on Windows. native_macos_fullscreen_mode = false uses a fast full-screen window on macOS. Set it to true to use the slower macOS native "Spaces" style fullscreen mode. #177
Windows: fix an issue where the initial window size didn't factor the correct DPI when the system-wide display scaling was not 100%. #427
New: adjust_window_size_when_changing_font_size option to control whether changing the font size adjusts the dimensions of the window (true) or adjusts the number of terminal rows/columns (false). The default is true. #431
macOS: we no longer use MetalANGLE to render the gui; it was short lived as macOS Big Sur now uses Metal in its CGL implementation. Support for using MetalANGLE is still present if the dylib is found on startup, but we no longer ship the dylib.
Windows: when pasting text, ensure that the text has CRLF line endings unless bracketed paste is enabled. This imperfect heuristic helps to keep multi-line pastes on multiple lines when using Windows console applications and to avoid interleaved blank lines when using unix applications. #411
New: ClearScrollback now accepts a parameter to control whether the viewport is cleared along with the scrollback. Thanks to @dfrankland!
New: default_cwd to specify an alternative current working directory. Thanks to @dfrankland!
New: CopyTo and PasteFrom actions. Copy, Paste and PastePrimarySelection
are now deprecated in favor of these new options.
X11: Mouse-based selection now copies-to and pastes-from the PrimarySelection by default. The CompleteSelection and CompleteSelectionOrOpenLinkAtMouseCursor actions now require a parameter to specify the clipboard.
X11: SHIFT-CTRL-C and SHIFT-CTRL-V now copy-to and paste from the Clipboard by default. SHIFT-Insert pastes from the PrimarySelection by default.
New: Added a new default CTRL-Insert key assignment bound to CopyTo(PrimarySelection)
macOS: Windows now have drop-shadows when they are opaque. These were disabled due transparency support was added. Thanks to Rice! #445
Unix: adjust font-config patterns to also match "dual spacing" fonts such as Iosevka Term. Thanks to Leiser! #446
New: Added alternate_buffer_wheel_scroll_speed option to control how many cursor key presses are generated by the mouse wheel when the alternate screen is active. The new default for this is a faster-than-previous-releases 3 lines per wheel tick. #432
macOS: Dead Keys are now processed even when use_ime=false. More details in the docs. #410.

New in WezTerm 20201101_103216 (Nov 1, 2020)

New in WezTerm 20201031_154415 (Nov 1, 2020)

New: split/pane support! CTRL+SHIFT+ALT+" to SplitVertical, and CTRL+SHIFT+ALT+% to SplitHorizontal.
New: LEADER modifier key support
New: window_background_opacity and window_background_image options to control using background images, transparent windows. More info
New color schemes: Dracula+, Gruvbox Light, MaterialDarker, Overnight Slumber, Popping and Locking, Rapture, jubi, nord.
New: expanded lua API allows handling URI clicks and keyboard events with lua callbacks. See wezterm.on docs.
The GUI layer now normalizes SHIFT state for keyboard processing. If a keypress is ASCII uppercase and SHIFT is held then the SHIFT modifier is removed from the set of active modifiers. This has implications for your key assignment configuration; previously you would write {key="T", mods="CTRL|SHIFT"}, after updating to this release you need to write {key="T", mods="CTRL"} in order for your key bindings to take effect.
Added show_tab_index_in_tab_bar option which defaults to true. Causes the tab's ordinal index to be prefixed to tab titles. The displayed number is 1-based. You can set tab_and_split_indices_are_zero_based=true if you prefer the number to be zero based.
On Linux and macOS systems, wezterm can now attempt to guess the current working directory that should be set in newly spawned local panes/tabs, in case you don't have OSC 7 integration setup in your shell.
We now bundle JetBrains Mono and use it as the default font, and add it as a default fallback font. Similarly, we also bundle Noto Color Emoji as a default fallback for emoji.
Added automatically_reload_config=false option to disable automatic config reloading. When set to false, you will need to manually trigger a config reload (default: SUPER+R or CTRL+SHIFT+R)
CloseCurrentTab now requires a confirm parameter.
Halved the memory usage requirements per Cell in the common case (saving 32 bytes per cell), which gives more headroom for users with large scrollback.
Reduced initial GPU VRAM requirement to 2MiB. Improved texture allocation to avoid needing lots of VRAM.
macOS: Fix issue where new windows would open as Cocoa tabs when wezterm was maximized.
macOS: Fix issue where wezterm wouldn't adjust to DPI changes when dragging across monitors or the screen resolution changed
macOS: Reduced trackpad based scrolling sensitivity; it was hyper sensitive in previous releases, and now it is more reasonable.
Fix an issue where EGL failed to initialize on Linux
If EGL/WGL/OpenGL fail to initialize, we now try to fallback to Mesa OpenGL in software render mode. This should result in its llvmpipe renderer being used as a fallback, which has improved visuals compared to wezterm's own basic CPU based renderer. (This applies to X11/Wayland and Windows systems).
Setting front_end="Software" will try to use the Mesa OpenGL software renderer if available (X11/Wayland/Windows). The old basic CPU renderer has been removed.
The multiplexer server has been moved into its own wezterm-mux-server executable. You will need to revise your serve_command configuration.
Windows: when started in an RDP session, force the use of the Mesa software renderer to work around problems with RDP GPU emulation.
Fixed an issue with TLS Multiplexing where bootstrapping certificates would usually fail.
Windows: Fixed an issue that prevented ALT-Space from showing the system menu in the window.
Windows: Fixed dead key handling. By default dead keys behave the same as in other programs and produce diacritics. However, setting use_dead_keys = false in the config will cause dead keys to behave like a regular key; eg: ^ would just emit ^ as its own character.
Windows: Fixed an issue with the Hide key assignment; it would hide the window with no way to show it again! Hide now minimizes the window instead.
macOS: we now use Metal to render the gui, via MetalANGLE
Windows: we now prefer to use Direct3D11 to render the gui, via ANGLE EGL. The primary benefit of this is that upgrading your graphics drivers while you have a stateful wezterm session will no longer terminate the wezterm process. Resize behavior is not as smooth with ANGLE as the prior WGL. If you wish, you can set prefer_egl = false to use WGL.
Improved image protocol support to have better render fidelity and to reduce VRAM usage when the same image it displayed multiple times in the same pane.

New in WezTerm 20200909-002054 (Sep 9, 2020)

New in WezTerm 20200718_095447 (Jul 19, 2020)

New in WezTerm 20200620_160318 (Jun 21, 2020)

Fixed default mapping f ambiguus ctrl key cmbinatins (i, m, [, {, @) s that they emit the ld schl tab, newline, escape etc. values. These gt brken as part f prttyping CSI-u supprt a while back.
Added ptin t enable CSI-u key encdings. This is a new mapping scheme defined here http://www.lenerd.rg.uk/hacks/fixterms/ that disambiguates and therwise enables mre key binding cmbinatins. Yu can enable this setting using enable_csi_u_key_encding = true in yur cnfig file.
Very early supprt fr sixel graphics
macs: use_ime nw defaults t false; this is a better ut f the bx experience fr mst users.
macs: we nw attempt t set a reasnable default LANG envirnment based n the lcale settings at the time that wezterm is launched.
macs: intrduce send_cmpsed_key_when_left_alt_is_pressed and send_cmpsed_key_when_right_alt_is_pressed blean cnfig settings. Like the existing send_cmpsed_key_when_alt_is_pressed ptin, these cntrl whether the Alt r ptin mdifier prduce cmpsed utput r generate the raw key psitin with the ALT mdifier applied. The difference frm the existing cnfig ptin is that n systems where Left and Right Alt can be distinguished yu nw have the ability t cntrl this behavir independently. The default behavir n these systems issend_cmpsed_key_when_left_alt_is_pressed=false and send_cmpsed_key_when_right_alt_is_pressed=true s that the right Alt key behaves mre like an AltGr key and generates the cmpsed input, while the Left Alt is regular uncmpsed Alt.
Fnts: fixed an issue where specifying italic r bld in the secnd parameter f wezterm.fnt didn't wrk as intended r dcumented
Imprved terminal emulatin cnfrmance; added left/right margin supprt and nw passes esctest t a similar degree as iTerm2
Fixed an issue where unmdified F5+ wuld use the CSI-u encded-mdifiers frmat, and cnfused eg: htp.
ActivateTab nw accepts negative numbers as a way t reference the last tab in the Windw. The default assignment fr CTRL+SHIFT+9 and CMD+9 is nw ActivateTab=-1, which selects the last tab.
Fixed an issue when applying hyperlink rules t lines that had mixed width characters

New in WezTerm 20200608-110940 (Jun 8, 2020)

New in WezTerm 20200607-144723 (Jun 8, 2020)

New in WezTerm 20200517-122836 (May 17, 2020)

New in WezTerm 20200503-171512 (May 4, 2020)

New in WezTerm 20200406-151651 (Apr 7, 2020)

New in WezTerm 20200202-200216 (Feb 12, 2020)

Improved font shaping performance 2-3x by adding a shaper cache
Windows: now has support for TLS based multiplexer connections
Multiplexer: TLS multiplexer can now be bootstrapped via SSH, and automatically manages certificates
Unix: We now default to spawning shells with the -l argument to request a login shell. This is important on macOS where the default GUI environment doesn't source a working PATH from the shell, resulting in an anemic PATH unless the user has taken care to cover this in their shell startup. -l works to enable a login shell in zsh, bash, fish and tcsh. If it doesn't work with your shell, you can use the default_prog configuration option to override this.
We now accept rgb:XX/XX/XX color syntax for OSC 4 and related escape sequences; previously only #XXXXXX and named colors were accepted.
We now accept OSC 104 to reset custom colors to their defaults.
Added Tab Navigator overlay for folks that hoard tabs; it presents an interactive UI for selecting and activating a tab from a vertically oriented list. This is bound to Alt-9 by default.
Added support for DEC Origin Mode (DECOM) which improves cursor positioning with some applications
Added support for DEC AutoWrap Mode (DECAWM) which was previously always on. This improves rendering for applications that explicitly disable it.
We now show a connection status window while establishing MUX and SSH connections. The status window is also where any interactive authentication is carried out for eg: SSH sessions.
Improved SSH authentication handling; we now give you a few opportunities to authenticate and are now able to successfully authenticate with sites that have configured 2-Factor authentication in their server side SSH configuration.
Fixed an issue where SHIFT-Space would swallow the space key.
Nightly builds are now available for Linux in AppImage format.
Shift+Left Mouse button can now be used to extend the selection to the clicked location. This is particularly helpful when you want to select something that is larger than the viewport.
Windows: a single mouse wheel tick now scrolls by the number of positions configured in the Windows system settings (default 3)
Windows: fixed IME position when the tab bar is enabled
Windows: removed support for WinPty, which was too difficult to obtain, configure and use.
Configuration errors now show in a separate window on startup, or when the configuration is reloaded
Improved reliability and performance of MUX sessions, although they still have room for further improvement