Skip to content

fix: improve --list output for BLE devices and bump driverkit to 0.3.0#1987

Merged
jtroo merged 2 commits intojtroo:mainfrom
malpern:fix/ble-list-output-improvements-v2
Mar 22, 2026
Merged

fix: improve --list output for BLE devices and bump driverkit to 0.3.0#1987
jtroo merged 2 commits intojtroo:mainfrom
malpern:fix/ble-list-output-improvements-v2

Conversation

@malpern
Copy link
Copy Markdown
Contributor

@malpern malpern commented Mar 21, 2026

Describe the changes

Bump karabiner-driverkit to 0.3.0 and improve --list output for BLE device users.

The driverkit update adds a fallback to the IORegistry "Product" property when kIOHIDProductKey is empty, fixing BLE HID keyboards (e.g. ZMK-based boards) showing blank product_key in kanata --list.

The --list output changes:

  • Only show the "use hash values" hint when there are actually devices with empty names
  • Warn when Karabiner virtual devices are detected that hash-based matching may not be stable (Karabiner re-exposes all devices with a shared hash)

Fixes #1944

Checklist

  • Add documentation to docs/config.adoc
    • N/A
  • Add example and basic docs to cfg_samples/kanata.kbd
    • N/A
  • Update error messages
    • N/A — output messages updated in the --list code path
  • Added tests, or did manual testing
    • Manual testing — needs BLE device validation (cc @mgabor3141)

malpern and others added 2 commits March 21, 2026 11:57
- Only show "use hash values" hint when there are actually devices with
  empty names
- Add warning when Karabiner virtual devices are detected that hashes
  may not be stable

Depends on karabiner-driverkit release with the "Product" property
fallback (psych3r/driverkit#16).

Ref: jtroo#1944

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The new driverkit version adds a fallback to the IORegistry "Product"
property when kIOHIDProductKey is empty, which fixes BLE HID keyboards
showing empty names in `kanata --list`. Also adds the new device_hash
field to DKEvent structs.

Ref: jtroo#1944
Ref: psych3r/driverkit#16

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jtroo jtroo merged commit ec33421 into jtroo:main Mar 22, 2026
5 checks passed
@malpern malpern deleted the fix/ble-list-output-improvements-v2 branch March 22, 2026 04:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bug: kanata --list shows empty product_key for BLE HID device, but runtime matching finds the name

2 participants