Installation

_$: curl -fsSL https://apt.fury.io/wez/gpg.key \
    | sudo gpg --yes --dearmor -o /etc/apt/trusted.gpg.d/wezterm-fury.gpg
_$: echo 'deb [signed-by=/etc/apt/trusted.gpg.d/wezterm-fury.gpg] https://apt.fury.io/wez/ * *' \
    | sudo tee /etc/apt/sources.list.d/wezterm.list
_$: sudo apt update
_$: sudo apt install wezterm

Configuration

Create a .wezterm.lua file on your home directory:

$HOME/.wezterm.lua:
-------------------
-- Pull in the wezterm API
local wezterm = require 'wezterm'

-- This will hold the configuration.
local config = wezterm.config_builder()

-- This is where you actually apply your config choices

-- For example, changing the color scheme:
config.color_scheme = 'Tango (base16)'

-- Disable audible bell
config.audible_bell = 'Disabled'

-- and finally, return the configuration to wezterm
return config

Find a list of color schemes here.

Configuration: Change default keybindings

$HOME/.wezterm.lua:
-------------------
[...]
-- Keybindings
config.keys = {
    -- Ctrl + Shift + e -> Split vertically (left and right)
    {
        key = 'e',
        mods = 'CTRL|SHIFT',
        action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' },
    },
    -- Ctrl + Shift + o -> Split horizontally (top and bottom)
    {
        key = 'o',
        mods = 'CTRL|SHIFT',
        action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' },
    },
}

SSH connections

Connect to some host using the wezterm ssh command:

_$: wezterm ssh user@example.com

If, once connected, you split the window, the newly created window will also be connected to the server.

Your .ssh/config file can be used. So, for instance, you could run

_$: wezterm ssh example.com

if you had a user configured for that host.