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

  • #240

Windows 10+11 LLHOOK

• Mouse inputs cannot be used for processing or remapping

  • #108

  • #170

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

  • #192

  • #428

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

  • #152

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

  • #55

  • #250

  • #430

  • espanso/espanso#1488

• AltGr can misbehave

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

• NumLock state can mess with arrow keys in unexpected ways

  • #78

  • #667

  • Workaround: use the correct numlock state

• Without process-unmapped-keys yes, using arrow keys without also having the shift keys in defsrc will break shift highlighting

  • #858

  • Workaround: add shift keys to defsrc or use process-unmapped-keys yes in defcfg

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

  • #127

  • #164

  • #425

  • #532

Linux

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

  • #422

  • #450

• Unicode support has limitations, using xkb is a more consistent solution

  • #703

• Key actions can behave incorrectly due to the rapidity of key events

  • #733

  • #740

  • adjusting rapid-event-delay can potentially be a workaround

MacOS

• Mouse output actions are not implemented

• Mouse input processing is not implemented

• Unicode output action is not implemented