wezterm/docs/imgcat.md

## iTerm Image Protocol Support

wezterm implements support for the [iTerm2 inline images
protocol](https://iterm2.com/documentation-images.html) 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
```

<img width="100%" height="100%" src="screenshots/wezterm-imgcat.png" alt="inline image display">


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