Sonstiges/TerminalImageViewer
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Original: https://github.com/stefanhaustein/TerminalImageViewer
34 Commits 2 Branches 1 Tag 814 KiB
Java 51%
C++ 47.7%
Makefile 1.3%
cca5600a0f
Go to file
Stefan Haustein cca5600a0f Changed instructions to the C++ version
2017-07-11 21:29:46 +02:00
src/main Merge branch 'master' of https://github.com/stefanhaustein/TerminalImageViewer 2017-07-11 21:26:10 +02:00
LICENSE Create LICENSE 2016-06-23 14:53:20 +02:00
README.md Changed instructions to the C++ version 2017-07-11 21:29:46 +02:00

README.md

TerminalImageViewer (tiv)

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

The main difference to various existing similar tools is that instead of having two fixed pixels per character cell utilizing the unicode half block character, this program enhances the resolution using the following algorithm:

For each 4x8 pixel cell mapped to a unicode block graphics character:

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

Installation

git clone https://github.com/stefanhaustein/TerminalImageViewer.git
cd TerminalImageViewer/src/main/cpp
make
sudo make install

Usage

tiv <filenames>

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

Examples

Examples

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

Thumbnails