tiv

Meta

About

Tiv is a simple terminal image viewer that displays images directly in the terminal. It's really just an ascii art generator based on Perl and Imagemagick. It accepts options to control the width and height of the image as well as the aspect ratio. The resolution of the image depends directly on your font settings.

Note that Tiv will not work correctly (read: "even remotely as expected") if your terminal does not support 256 colors.

Tiv was written for fun to make use of some functions that I had created while playing around with terminal colors. Terminal chromophiles might also be interested in this, which was another coding byproduct.

Suggestions

Cascade images using the full terminal width.

tiv -r 0.5 [img_files]

The same as the previous command, but pause after each image.

tiv -r 0.5 -p [img_files]

Scale image to fill terminal.

tiv -h $LINES -p <img_file>

Screenshots

Note that the following images are thumbnails that makes the "pixel" size appear smaller than it actually is. The fullsize images will give you a better idea of what to expect with normal font sizes.

Originals:

• https://secure.wikimedia.org/wikipedia/en/wiki/File:WhiteCat.jpg

Changelog

2010-09-15

• added "-a" option to alter terminal color rgb values: makes some images smoother
• added "--reset" option to undo changes from "-a" command