1
1
mirror of https://github.com/wez/wezterm.git synced 2025-01-05 12:15:23 +03:00
wezterm/docs/imgcat.md
2023-03-15 20:54:02 -07:00

25 lines
754 B
Markdown

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:
```console
$ wezterm imgcat /path/to/image.png
```
![inline image display](screenshots/wezterm-imgcat.png)
**Note that the image protocol isn't fully handled by multiplexer sessions
at this time**.
*Since: 20220319-142410-0fcdea07*
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.