stefanhaustein/TerminalImageViewer

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

1683 stars · 118 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Terminal Image Viewer (tiv) is a small C++ command-line program that displays images directly in modern terminals using RGB ANSI codes and unicode block graphics characters. It improves resolution over half-block approaches by mapping 4x8 pixel cells to the best-matching unicode block characters with recalculated foreground and background colors.

Use cases

• view images in the terminal without leaving the shell
• generate image thumbnails in a terminal file manager
• quickly preview a folder of images with tiv *.jpg
• display images over ssh where no GUI is available
• compare terminal image rendering quality with the -0 fallback mode

When to choose

• you work primarily in a terminal or over ssh and need quick image previews
• you want higher-fidelity terminal rendering than half-block tools like timg
• you need a lightweight C++ tool with ImageMagick as the only dependency

When to avoid

• you need true-color pixel-accurate image viewing in a GUI
• your terminal does not support unicode block graphics or RGB ANSI colors
• you need advanced image editing or format conversion features

Facets

cli-tool · maturity active

image-processing cli graphics graphics developer-tools windows cli cross-platform terminal-graphics ansi-colors unicode-block-graphics image-viewer thumbnails cpp command-line linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="stefanhaustein/TerminalImageViewer")