platform-known-issues.adoc

Platform-dependent known issues

Preface

This document contains a list of known issues which are unique to a given platform. The officially supported platforms today are Windows 10/11 and Linux. On Windows, there are two backing mechanisms that can be used for keyboard input/output and they have different issues. These will be differentiated by the words "LLHOOK" and "Interception", which map to the binaries kanata.exe and kanata_wintercept.exe respectively.

Windows 11 LLHOOK

• The emoji picker does not work properly

  • jtroo#240

Windows 10+11 LLHOOK

• Mouse inputs cannot be used for processing or remapping

  • jtroo#108

  • jtroo#170

• Some input key combinations (e.g. Win+L) cannot be intercepted before running their default action

  • jtroo#192

  • jtroo#428

• OS-level key remapping behaves differently vs. Linux or Interception

  • jtroo#152

• Certain applications that also use the LLHOOK mechanism may not behave correctly

  • jtroo#55

  • jtroo#250

  • jtroo#430

  • espanso/espanso#1488

• AltGr can misbehave

  • https://github.com/jtroo/kanata/blob/main/docs/config.adoc#windows-only-windows-altgr

Windows 10+11 Interception

• Sleeping your system or unplugging/replugging devices enough times causes inputs to stop working

  • oblitum/Interception#25

• Some less-frequently used keys are not supported or handled correctly

  • jtroo#127

  • jtroo#164

  • jtroo#425

  • jtroo#532

Linux

• Key repeats can occur when they normally wouldn’t in some cases

  • jtroo#422

  • jtroo#450

MacOS

• Mouse output actions are not implemented

• Mouse input processing is not implemented

• Unicode output action is not implemented