30 lines
870 B
ReStructuredText
30 lines
870 B
ReStructuredText
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
|