From 7b703565151b9f6d1c53975cfc823c1ddaf7f1f8 Mon Sep 17 00:00:00 2001 From: Jinn Koriech Date: Mon, 27 Apr 2020 14:11:16 +0100 Subject: [PATCH 1/2] Add note clarifying that icat won't work with tmux 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 --- docs/kittens/icat.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/kittens/icat.rst b/docs/kittens/icat.rst index ec066980a..0ac5b17e0 100644 --- a/docs/kittens/icat.rst +++ b/docs/kittens/icat.rst @@ -21,6 +21,11 @@ Then you can simply use ``icat image.png`` to view images. `ImageMagick `_ 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 From 421528e13038c0777dabe492add26e1b871389c4 Mon Sep 17 00:00:00 2001 From: Jinn Koriech Date: Mon, 27 Apr 2020 16:40:24 +0100 Subject: [PATCH 2/2] Update note about icat + tmux to be more generic --- docs/kittens/icat.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/kittens/icat.rst b/docs/kittens/icat.rst index 0ac5b17e0..b9f5b5d43 100644 --- a/docs/kittens/icat.rst +++ b/docs/kittens/icat.rst @@ -23,8 +23,7 @@ Then you can simply use ``icat image.png`` to view images. .. note:: - ``icat`` uses terminal features that are incompatible with screen multiplexers - such as `tmux` and `screen`. + kitty's image display protocol may not work when used within a terminal multiplxer such as ``screen`` or ``tmux``, depending on whether the multiplxer has added support for it or not .. program:: kitty +kitten icat