What is the intended way of enabling kitty keyboard protocol?

38 views
Skip to first unread message

Jinwook Jeong

unread,
Aug 14, 2025, 8:46:08 PMAug 14
to iterm2-discuss
Hi,

According to https://gitlab.com/gnachman/iterm2/-/issues/10017 iTerm2 supports kitty keyboard protocol, but I couldn't find any instructions on how to enable it, except for a single option whose tooltip has the word "kitty": "Apps can change how keys are reported".

The tooltip reads:

Some programs (such as vim and emacs) want to put the numeric keypad in "application" mode. Turn this off if you always want it to act as a numeric keypad. NOTE: This setting affects the older xterm control sequence (CSI > Pp m), not the Kitty control sequence related to CSI > flags u.

It suggests that enabling this option wouldn't achieve what I need—but in practice, it does.

Can anyone clarify what's going on here?

George Nachman

unread,
Aug 20, 2025, 2:10:25 PMAug 20
to iterm2-...@googlegroups.com
The simplest control sequence to enable the kitty keyboard protocol is CSI > 1 u. Unless you’re writing a program that will parse these codes, you probably don’t want to send this yourself. If you are, though, the documentation is here: https://sw.kovidgoyal.net/kitty/keyboard-protocol/

--
You received this message because you are subscribed to the Google Groups "iterm2-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to iterm2-discus...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/iterm2-discuss/c47a7955-202d-4680-a83a-c8eb1aeb8f21n%40googlegroups.com.

Jinwook Jeong

unread,
Aug 23, 2025, 12:05:09 PM (13 days ago) Aug 23
to iterm2-...@googlegroups.com
Is the "Apps can change how keys are reported" intended for kitty keyboard protocol enablement?

You received this message because you are subscribed to a topic in the Google Groups "iterm2-discuss" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/iterm2-discuss/8K_Ilf_0QEk/unsubscribe.
To unsubscribe from this group and all its topics, send an email to iterm2-discus...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/iterm2-discuss/CAB5RqonFy2%3DK5gnk02eYzfJadf0d%3D5aTrAgudg1-C2XHsQ0_tA%40mail.gmail.com.

George Nachman

unread,
Sep 3, 2025, 9:10:41 PM (2 days ago) Sep 3
to iterm2-...@googlegroups.com
Yes, enabling that is necessary to allow the control sequence to work. It isn’t just for Kitty, though—it affects all the key reporting modes.

Reply all
Reply to author
Forward
0 new messages