Repository navigation
Images and Graphics
Ö. Efe D. edited this page Sep 15, 2026
·
1 revision
tron shows images inline with three protocols, so image viewers, file managers and video players work out of the box.
| Protocol | Support |
|---|---|
| Kitty graphics | PNG, RGB and RGBA data; direct, file, temporary file and shared memory transfers; animation and frame composition; relative placements; Unicode placeholders |
| Sixel | Full color Sixel images |
| iTerm2 inline images | PNG, JPEG and animated GIF through OSC 1337 File=
|
| Program | Command |
|---|---|
| kitty's icat | kitten icat image.png |
| chafa |
chafa image.png (picks kitty graphics automatically) |
| yazi | Image previews in the file manager, also inside tmux |
| mpv | mpv --vo=kitty video.mp4 |
| timg | timg image.png |
| img2sixel | img2sixel image.png |
| imgcat | imgcat image.gif |
tron sets KITTY_WINDOW_ID, so tools that look for kitty before using its
protocol use it in tron too.
- Kitty images stay where they were placed, under or over text, as the kitty protocol specifies.
- Sixel and iTerm2 images belong to the cells they cover. Writing text over any of those cells, erasing them, or scrolling a region past them removes the image, as in xterm. tmux relies on this when it redraws a window over an image.
[images]
# Memory for decoded kitty graphics protocol images, in MiB.
memory_limit = 320
# Let applications send images as file paths.
file_transfer = trueWhen the images use more memory than memory_limit, tron frees the oldest
images first, starting with those that are not shown on screen. Turn file_transfer off if programs you do not
trust run in tron: file transfers let a program make tron read files by path.
- Text sizing protocol. Programs can draw text two to seven cells tall with kitty's text sizing protocol (OSC 66).
-
Double width and double height lines (DECDWL, DECDHL), as used by
vttestand some banners. -
Styled underlines. Curly, dotted, dashed and double underlines in any color (
CSI 4:3 m,CSI 58 m), as used by editors for diagnostics. - Synchronized output (mode 2026), so full screen programs redraw without flicker.
- True color everywhere.
Using tron
Looks
Features
Reference