Previews

Preview coverage, image support, terminal multiplexers, and SSH behavior.

COVERAGE

What elio can preview

TypePreview support
Text and codePlain text, source code with syntax highlighting, Markdown, logs, and source-like HTML.
Structured dataJSON, JSONC, JSON5, YAML, TOML, .env files, CSV/TSV, and SQLite metadata.
DocumentsPDF, EPUB, MOBI, AZW3, Office/OpenDocument files, and Apple Pages metadata where supported.
MediaImage metadata and inline previews, audio metadata and covers, and video metadata and thumbnails.
Folders and archivesDirectories, ZIP/TAR/RAR/7z archives, CBZ/CBR comics, torrents, ISO images, and similar containers.
Binary filesMetadata-focused previews for non-text files when richer previewers do not apply.

Optional preview tools

Install preview tools for rendered PDFs, video thumbnails, album art, SVGs, comic archives, and extra archive formats.

View optional tools

IMAGE PREVIEWS

Inline visual previews

Terminal support

TerminalProtocolStatus
KittyKitty Graphics ProtocolAuto-detected
GhosttyKitty Graphics ProtocolAuto-detected
WarpKitty direct-placement protocolAuto-detected
WezTermiTerm2 Inline ProtocolAuto-detected
iTerm2iTerm2 Inline ProtocolAuto-detected
KonsoleKitty direct-placement protocolAuto-detected
footSixelAuto-detected
Windows TerminalSixelAuto-detected

Notes

  • On an unrecognized terminal with Kitty Graphics Protocol support, set ELIO_IMAGE_PREVIEWS=1 to force-enable image previews.
  • Sixel terminals can render large or first-time previews more slowly than Kitty Graphics or iTerm2 Inline backends.
  • In Konsole, inline previews are temporarily cleared while modal popups are open to avoid rendering artifacts.

TERMINAL MULTIPLEXERS

Using elio inside tmux or Zellij

tmux

elio enables tmux passthrough automatically for the current pane when image previews are active.

Zellij

In Zellij 0.45+, image previews work with Kitty, Ghostty, WezTerm, and Sixel-compatible terminals.

SSH

Using elio over SSH

Remote preview behavior

Text and code previews work well over SSH. Rich visual previews depend on image protocol support in the local terminal and optional preview tools on the remote host. Terminal apps chosen through Open With run inside the current SSH session, while GUI/default openers use the remote host opener stack.