Man pages sections > man1 > catimg

catimg - fast image printing in to your terminal

CATIMG(1) General Commands Manual CATIMG(1)


catimg - fast image printing in to your terminal


catimg [ options] image


catimg is a little program written in C with no dependencies that prints images in the terminal. It supports JPEG, PNG and GIF formats.


Prints a help message
Specify the width of the displayed image, by default catimg will use the terminal width.
Specify the amount of loops that catimg should repeat a GIF. A value of 1 means that the GIF will be displayed twice. A negative value implies infinity.
Possible values 1 or 2. Force the resolution of the image. By default catimg will check if rendering in higher resolution is possible and do so or use the lower one.
Convert colors to a restricted palette. This is useful when terminal only support a limited set of colors. This transformation should be more accurate than the one performed by the terminal.


Please report any bugs to


catimg was written by Eduardo San Martin Morote (
This manual page was written by Jonathan Carter <> and Eduardo San Martin Morote
January 2017 catimg