From 427288c16b3abafa0194e6647cc3b714233c28be Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Sat, 22 Aug 2020 11:36:01 +0530 Subject: [PATCH] Add a tmux FAQ So I can just point to it for all the spurious tmux caused bug reports --- docs/faq.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index f9b163ac9..b929493fe 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -232,3 +232,29 @@ available. The manual way to figure it out is: This shows the hex value, ``13`` in this case. 3. Use ``\x(hexval)`` in your ``send_text`` command in kitty. So in this example, ``\x13`` + + +I am using tmux and have a problem +-------------------------------------- + +First, terminal multiplexers are `a bad idea +`_, do +not use them, if at all possible. kitty contains features that do all of what +tmux does, but better, with the exception of remote persistence (:iss:`391`). + +Image display will not work, see `tmux issue +`_. + +If you are using tmux with multiple terminals or you start it under one +terminal and then switch to another and these terminals have different +TERM variables, tmux will break. You will need to restart it as tmux does not +support multiple terminals. + +Copying to clipboard via OSC 52 will not work, because tmux does not support +the extended version of that protocol, you will need to add ``no-append`` to +:opt:`clipboard_control` in kitty.conf. + +If you use any of the advanced features that kitty has innovated, such as +styled underlines, desktop notifications, extended keyboard support, etc. +they may or may not work, depending on the whims of tmux's maintainer, your +version of tmux, etc.