Bug 435975 - Implement fixterms
Summary: Implement fixterms
Status: REPORTED
Alias: None
Product: konsole
Classification: Applications
Component: keyboard (other bugs)
Version First Reported In: master
Platform: Other Linux
: NOR wishlist
Target Milestone: ---
Assignee: Konsole Developer
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-04-20 20:48 UTC by ariasuni
Modified: 2025-10-04 12:32 UTC (History)
5 users (show)

See Also:
Latest Commit:
Version Fixed/Implemented In:
Sentry Crash Report:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description ariasuni 2021-04-20 20:48:58 UTC
SUMMARY
Some terminals started implementing fixterms. Kitty implemented a slightly different who apparently fixes some problems with fixterms in 2012.

According to fixterms’ website:

> Keyboard input on Terminals has many deficiencies to it. I want them all
> fixed. I have a plan on how to do it but it Needs Your Help

Neovim implemented the protocol in 2015 by using libtickit:
https://github.com/neovim/neovim/issues/176#issuecomment-77786940

fixterms: http://www.leonerd.org.uk/hacks/fixterms/
kitty’s new keyboard protocol: https://sw.kovidgoyal.net/kitty/keyboard-protocol.html

SOFTWARE/OS VERSIONS
Operating System: Arch Linux
KDE Plasma Version: 5.21.4
KDE Frameworks Version: 5.81.0
Qt Version: 5.15.2
Comment 1 ariasuni 2021-04-20 20:49:59 UTC
Sorry I hit enter too early, I meant:
Kitty implemented in *2021* a slightly different *version* who apparently fixes some problems with fixterms.
Comment 2 ariasuni 2021-04-20 21:15:37 UTC
Also see this comment about the «state of the art» of terminals:

https://github.com/mawww/kakoune/issues/2554#issuecomment-436300959
Comment 3 Ivan Sorokin 2023-04-06 10:13:51 UTC
There are also at least three other protocols for "raw keyboard" input in terminals.

iTerm2 protocol
https://gitlab.com/gnachman/iterm2/-/issues/7440#note_129307021

Windows Terminal's "win32-input-mode"
https://github.com/microsoft/terminal/pull/6309

far2l terminal extensions
https://github.com/elfmz/far2l/blob/master/WinPort/FarTTY.h

The only one of them that already have some support in apps is far2l's one (apps supporting it are "turbo" text editor, "putty4far2l" putty fork, cyd01's "KiTTY"). It is tied to Windows keyboard codes, but translation from x11 codes is easy:
https://github.com/unxed/xkb2win/
Comment 4 Ivan Sorokin 2024-10-06 12:22:05 UTC
I feel it's important to explain why the kitty keyboard protocol is truly essential.

I'm one of the developers of far2l—a port of the Far Manager file manager to Linux.  Since this program was originally developed for the Windows console, it heavily utilizes its advantages, particularly the ability to use any key combinations.

When migrating from Windows to Linux, users look for a familiar UX; they need their favorite applications, not a new operating system.  If we tell them "learn 100 new keyboard shortcuts," they're more likely to stay on Windows than listen to us.

Is it really acceptable that *nix console capabilities in the 21st century are still inferior to those of the ancient Windows 2000 console? This situation needs improvement.

In the far2l project, we came up with a hack that solves the problem under X11: we simply connect to X11 and listen to all keyboard input. This allows us to "refine" the key press information coming into the terminal, "deciphering" what the user actually pressed. A terrible, horribly dirty hack (but it works!)—but better than depriving the user of familiar functionality.

However, with the widespread transition to Wayland, this hack stops working.  What do you think users will do, give up their familiar keyboard shortcuts—or stay on X11?

This is precisely why we need the ability to use any keyboard shortcut in console applications. Not the day after tomorrow, not tomorrow. We needed it yesterday.

Of all the available solutions (far2l terminal extensions, iTerm2 raw keyboard protocol, win32-input-mode, and kitty keyboard protocol), the kitty protocol is the most suitable for UNIX-like operating systems. It's designed with backward compatibility in mind, and adapting terminals to support it is straightforward. Look at this code example. This is a reference implementation of basic kitty protocol support that I made as an example for Windows Terminal developers.  It's only 196 lines of code: https://gist.github.com/unxed/d979fe069039fe075c18eb0218b1f8f5

I hope you will consider these arguments, and together we can bring the console capabilities of UNIX-like operating systems up to par with what the Windows 2000 console offered 24 years ago. I'll be happy to answer any questions if anyone takes this on.  Thank you in advance!
Comment 5 Luca Weiss 2025-10-01 14:22:16 UTC
This should also help with fish shell being able to use some keybinds, e.g. ctrl-backspace doesn't seem to really be possible right now, or at least is ambiguous with ctrl-h.

Ref https://github.com/fish-shell/fish-shell/issues/11538#issuecomment-3356580330
Comment 6 Ivan Sorokin 2025-10-04 12:32:17 UTC
Here is some thoughts on fixterms/kitty approach vs another alternative, win32 input mode. I tend to believe that the win32 input mode is, in fact, much better designed.

Arguments in its favor:

1. It's based on a time-tested keyboard event structure of Windows - there have never been complaints from application developers that something is missing in it. The structure is stable and hasn't changed for decades.

2. It avoids the overcomplication of kitty's mode-state stack.

3. It doesn't include unnecessary and hard-to-obtain field unshifted key. (I understand how to implement this on top of GTK - it would require an additional xkbcommon context that tracks the current kb layout - but that's an absurd amount of terminal-side complexity for something that can be handled in a single line on the application side, simply by normalizing case before hotkey checks.)

4. It clearly separates Unicode character (which depends on layout and modifiers) and key code (which does not), unlike kitty, which allocates four (!) separate fields for the same two concepts: key code, shifted key code, base layout key code, and Unicode text.

5. Accordingly, there is no pointless duplication of the same Unicode character between the shifted field and the Unicode text fiels (as happens in kitty). Moreover, in kitty, for roughly half of all keys, the key code field itself duplicates the same character code as those two fields.

6. Parsing is simpler - no nested delimiters. Because of its simplicity, it's trivial to integrate into applications.

7. It's supported out of the box on every Windows machine.

8. The specification is clear and unambiguous.

9. It doesn't carry the 50-year-old technical debt that kitty indirectly inherits.

10. It's already used outside the Windows ecosystem - for example, in magiblot's Turbo Vision fork and his turbo editor, and also in far2l - Linux port of classical file manager from the Windows world.

On macOS, virtual key codes can be mapped the same way as in Wine, providing a familiar behavior at least for some users.

Essentially, with kitty we get a beautifully formatted specification that is, in at least one case, impossible to fully adhere to - one that contains fundamental design flaws and is excessively overengineered. To be honest, its appeal was greatly overestimated due to the lack of competition.

From an engineering standpoint, a protocol based on win32 input looks like a far more attractive alternative.

And it is already implemented for Konsole:
https://invent.kde.org/utilities/konsole/-/merge_requests/1133