icat - Display images in the terminal
========================================

The ``icat`` kitten can be used to display arbitrary images in the |kitty|
terminal. Using it is as simple as::

    kitty +kitten icat image.jpeg

It supports all image types supported by `ImageMagick
<https://www.imagemagick.org>`_. It even works over SSH. For details, see
the :doc:`kitty graphics protocol </graphics-protocol>`.

.. note::

    `ImageMagick <https://www.imagemagick.org>`_ must be installed for ``icat`` to
    work.


.. program:: kitty +kitten icat


The ``icat`` kitten has various command line arguments to allow it to be used
from inside other programs to display images. In particular, :option:`--place`,
:option:`--detect-support` and :option:`--print-window-size`.

Command Line Interface
--------------------------

.. include:: /generated/cli-kitten-icat.rst
