In Operation
Here’s a couple of images displayed with Terminal Image Viewer in the terminal.
The images are using 24 bit colors, but there’s a command-line flag which lets you reduce the color palette down to 256. The program employs a good algorithm to optimize images.


The third image shows the program displaying a directory of images. This mode is automatically chosen if you view more than 1 image. You can configure the number of thumbnails that are shown in a column. By default, it defaults to 3 images.

The program also has the option to use Unicode Teletext/legacy characters, the option to define the maximum height and width, and turn off image optimization. This project uses Unicode half-block characters.
Summary
Terminal Image Viewer might be useful if you need to view images in the terminal. Not all terminals are compatible though. For example, images are poorly reproduced with Hyper, but work well in GNOME Terminal.
If, instead, you’re looking to be able to view images from the command-line (but not displaying them in the terminal itself), we strongly recommend feh, a fantastic image viewer and cataloger aimed primarily at console users. It came top in our recent survey of the best image viewers.
Website: github.com/stefanhaustein/TerminalImageViewer
Support:
Developer: Stefan Haustein
License: Apache License 2.0
Terminal Image Viewer is written in C++. Learn C++ with our recommended free books and free tutorials.
Pages in this article:
Page 1 – Introduction / Installation
Page 2 – In Operation / Summary
Related Software
| Terminal-Based Image Viewers | |
|---|---|
| timg | Image and video viewer with good range of features. Written in C++ |
| Chafa | Character Art Facsimile |
| viu | Rust-based image viewer |
| vv | Image viewer for sixel terminals |
| TIV | Tiny C++ program that displays images in a terminal |
| Ranger | Terminal-based file manager supporting high quality previews of image files |
| mcat | Extended cat command |
| icat | Cat like utility can specify multiple image files and/or directories |
| PixelTerm-C | High-performance terminal image browser written in C |
| pho | Lightweight image viewer |
| catimg | Renders images in the terminal |
| PTUI | Real-time image preview capabilities |
| imv | X11/Wayland image viewer |
| iv | Image viewer using terminal graphics |
| ucollage | Extensible command line image viewer |
| TermVisage | Front-end to the term-image library |
| Foto | Simple image viewer |
| rsimg | Uses crossterm and zune as dependencies |
| pxv | Instant feature rich terminal image viewer |
| imgcat | Displays images and gifs in your terminal emulator. |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |

