catimg(1)

catimg1

Fast image printing in to your terminal

Usage

catimg [-hct] [{-w width | -H height}] [-l loops] [-r resolution] image

Overview

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

Options

-c

Coerce colors to a restricted palette. Allows terminals with limited color support to render a more accurate version of the image than if it was directly done by the terminal itself.

-h

Prints a help message

-H HEIGHT

Specify the height of the displayed image, passing '0' will use terminal height.

-l LOOPS

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.

-r RESOLUTION

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.

-t

Disables true color (24-bit) support, falling back to 256 color escape codes instead.

-w WIDTH

Specify the width of the displayed image. When not provided, catimg will use the terminal width.

Releases

5 releases since Debian 10 (Buster); the text changed 1 time.

  1. 10
  2. 11–Arch

-H since Debian 11 (Bullseye); -t since Debian 11 (Bullseye).

Bugs

Please report any bugs to https://github.com/posva/catimg/issues.

Authors

catimg was written by Eduardo San Martin Morote (https://github.com/posva)

This manual page was written by Jonathan Carter <[email protected]>, Eduardo San Martin Morote and Thomas Kupper

From catimg 2.8.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.