Skip to content

Images and Graphics

Ö. Efe D. edited this page Sep 15, 2026 · 1 revision

Images and Graphics

tron shows images inline with three protocols, so image viewers, file managers and video players work out of the box.

Supported protocols

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=

Programs that work

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.

Images and text

  • 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.

Settings

[images]
# Memory for decoded kitty graphics protocol images, in MiB.
memory_limit = 320
# Let applications send images as file paths.
file_transfer = true

When 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.

Other graphics features

  • 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 vttest and 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.

Clone this wiki locally