2019-11-25 11:34:35 +03:00
|
|
|
## 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
|
|
|
|
|
```
|
|
|
|
|
|
2020-01-01 05:33:24 +03:00
|
|
|
<img width="100%" height="100%" src="screenshots/wezterm-imgcat.png" alt="inline image display">
|
|
|
|
|
|
|
|
|
|
|
2019-11-25 11:34:35 +03:00
|
|
|
**Note that the image protocol isn't fully handled by multiplexer sessions
|
|
|
|
|
at this time**.
|
|
|
|
|
|
|
|
|
|
|
2022-03-20 02:37:27 +03:00
|
|
|
*Since: 20220319-142410-0fcdea07*
|
2022-02-18 16:04:22 +03:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
