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

Image Preview Compatibility

Terminal support

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

Notes

  • For other terminals that support the Kitty Graphics Protocol, set ELIO_IMAGE_PREVIEWS=1 to enable image previews.

TERMINAL MULTIPLEXERS

Using elio inside tmux or Zellij

tmux

Image previews work in all supported terminals. elio configures passthrough automatically for the current pane.

Zellij

In Zellij 0.45+, image previews work with Kitty, Ghostty, Rio, Warp, Konsole, WezTerm, foot, and Windows Terminal.

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.