mirror of
https://github.com/kovidgoyal/kitty
synced 2026-06-08 22:28:24 +02:00
7b70356515
When using icat with tmux we get the following: ``` $ kitty icat ~/Pictures/fc.jpg Terminal does not support reporting screen sizes via the TIOCGWINSZ ioctl ``` I found a suggestion[1] this is due to limitations between kitty and tmux, so I'm raising this PR to either confirm this is the case and make it clear in the documentation, or to have it rejected so an issue can be raised to address the feature. 1: https://unix.stackexchange.com/a/484776/41996
41 lines
1.1 KiB
ReStructuredText
41 lines
1.1 KiB
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>`.
|
|
|
|
You might want to create an alias in your shell's configuration files::
|
|
|
|
alias icat="kitty +kitten icat"
|
|
|
|
Then you can simply use ``icat image.png`` to view images.
|
|
|
|
.. note::
|
|
|
|
`ImageMagick <https://www.imagemagick.org>`_ must be installed for ``icat`` to
|
|
work.
|
|
|
|
.. note::
|
|
|
|
``icat`` uses terminal features that are incompatible with screen multiplexers
|
|
such as `tmux` and `screen`.
|
|
|
|
|
|
.. 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
|