consoleImageViewer man page

consoleImageViewer — highly scale-able, high quality, image viewer for ANSI terminals


consoleImageViewer [-h][--help][-best][-fg][-bg][-nochar][-names][-ratio][-rect][-negChar][-negColor][-wX][-hX] image-name(s)

Number of hyphens nor case meter for switches.


Not exactly photo-viewer, but when in terminal, and need quick preview of (small) image(s) then it is best of its kind

It is strongly recommended to 'export COLUMNS LINES' to adapt correctly to your terminal


print help and exits
overwrite everything and set best settngs
same but sets nochar to true
use linux ansi escape color for character
use linux ansi escape color for background
disable shadowing by characters
prints out image name before drawing it
forece to keep image ratio
will force rendering assuming that console char is not square, but rectangle of 2w~=h
invert chars
invert colors
force width to width X ignoring exported COLUMNS
force height to height X ignoring exported LINES


No switch is considered as -best
consoleImageViewer <image_name(s)>
same as
consoleImageViewer -best <image_name(s)>
Pretty good black and white (or any terminal default view)
consoleImageViewer -ratio -rect -negChar <image_name(s)>
Overriding default or COLUMNS/ROWS by seize of 128 (-noChar is ignored because -best is used)
consoleImageViewer -best -noChar -w128 -h128 <image_name(s)>

Exit Status

consoleImageViewer returns zero unless itcrashes


Jiri Vanek (judovana (at)

See Also



December 04, 2015 version 1.2 USER COMMANDS