pane:inject_output(text)

Since: Version 20221119-145034-49b9839f

The functionality described in this section requires version 20221119-145034-49b9839f of wezterm, or a more recent version.

Sends text, which may include escape sequences, to the output side of the current pane. The text will be evaluated by the terminal emulator and can thus be used to inject/force the terminal to process escape sequences that adjust the current mode, as well as sending human readable output to the terminal.

Note that if you move the cursor position as a result of using this method, you should expect the display to change and for text UI programs to get confused.

In this contrived and useless example, pressing ALT-k will output hello there in italics to the current pane:

local wezterm = require 'wezterm'

return {
  keys = {
    {
      key = 'k',
      mods = 'ALT',
      action = wezterm.action_callback(function(window, pane)
        pane:inject_output '\r\n\x1b[3mhello there\r\n'
      end),
    },
  },
}

Not all panes support this method; at the time of writing, this works for local panes but not for multiplexer panes.