Images

Supported Formats

ori-term supports three ways for applications to display images inline. All images are GPU-accelerated and display smoothly alongside your terminal text.

Kitty Graphics

The most capable format. Supports image placement, layering, and deletion. Use tools like kitten icat or any Kitty graphics-compatible application.

Sixel

A widely supported image format used by many terminal tools. Use img2sixel or any Sixel-compatible tool to display images.

iTerm2 Inline

Compatible with imgcat and tools that target iTerm2 for inline image display.

Displaying Images

The quickest way to display an image:

# With Kitty graphics (recommended)
kitten icat image.png

# With Sixel
img2sixel image.png

# With iTerm2 protocol
imgcat image.png

Animated GIFs are supported -- frames display at their intended timing.

Memory Limits

ori-term automatically manages image memory. The default limit is 256 MB. When the limit is reached, the least-recently-viewed images are removed to make room for new ones. This prevents long-running sessions with many images from consuming unbounded memory.