Original: https://github.com/stefanhaustein/TerminalImageViewer

Go to file

Stefan Haustein d749d51042 Revert "Constant standard output stream" This reverts commit `543cebef37`.		2019-03-23 22:33:28 +01:00
src/main	Revert "Constant standard output stream"	2019-03-23 22:33:28 +01:00
.gitignore	Snapcraft :)	2019-01-13 22:47:16 +01:00
LICENSE	Create LICENSE	2016-06-23 14:53:20 +02:00
README.md	Persistence options	2019-03-23 22:30:54 +01:00
snapcraft.yaml	Snapcraft :)	2019-01-13 22:47:16 +01:00

README.md

TerminalImageViewer (tiv)

Small C++ program to display images in a (modern) terminal using RGB ANSI codes and unicode block graphic characters.

There are various similar tools (such as timg) using the unicode half block character to display two 24bit pixels per character cell. This program enhances the resolution by mapping 4x8 pixel cells to different unicode characters, using the following algorithm:

For each 4x8 pixel cell of the (potentially downscaled) image:

Find the color channel (R, G or B) that has the biggest range of values for the current cell
Split this range in the middle and create a corresponding bitmap for the cell
Compare the bitmap to the assumed bitmaps for various unicode block graphics characters
Re-calculate the foreground and background colors for the chosen character.

See the difference by disabling this optimization using the -0 option. Or just take a look at the comparison image at the end of this text.

News

2019-01-14: Install via snap: sudo snap install --edge tiv

Installation

Snap

sudo snap install --edge tiv

Build from source

sudo apt install imagemagick || yum install ImageMagick
git clone https://github.com/stefanhaustein/TerminalImageViewer.git
cd TerminalImageViewer/src/main/cpp
make
sudo make install

Usage

tiv [options] <filename(s)>

The shell will expand wildcards. By default, thumbnails and file names will be displayed if more than one image is provided. To display a list of options, just run the command without any parameters.

Packages / Contributions

megamaced has created a RPM for SUSE: https://build.opensuse.org/package/show/home:megamaced/terminalimageviewer
bperel has created a Docker image: https://hub.docker.com/r/bperel/terminalimageviewer
teresaejunior has created a snapcraft.yaml file, which can build a Snap package with sudo docker run -it --rm -v "$PWD:$PWD" -w "$PWD" snapcore/snapcraft sh -c 'apt-get update && snapcraft', and then installed with sudo snap install --dangerous ./*.snap.

Common problems

If you see strange horizontal lines, the characters don't fully fill the character cell. Remove additional line spacing in your terminal app
Wrong colors? Try -256 to use a 256 color palette instead of 24 bit colors
Strange characters? Try -0 or install an use full unicode font (e.g. inconsolata or firacode)

Examples

If multiple images match the filename spec, thumbnails are shown.

Comparison to Using Half-Block Characters Only

The top image was generated with the character optimization disabled via the -0 option.

Save file

Saving the disk image for use in other processes or softwares via the -o option