iTerm Image Protocol

wezterm implements support for the iTerm2 inline images protocol and provides a handy imgcat subcommand to make it easy to try out. Because the protocol is just a protocol, wezterm's imgcat also renders images in iTerm2.

To render an image inline in your terminal:

$ wezterm imgcat /path/to/image.png

inline image display

Note that the image protocol isn't fully handled by multiplexer sessions at this time.

Since: Version 20220319-142410-0fcdea07

The functionality described in this section requires version 20220319-142410-0fcdea07 of wezterm, or a more recent version.

WezTerm supports an extension to the protocol; passing doNotMoveCursor=1 as an argument to the File escape sequence causes wezterm to not move the cursor position after processing the image.