v12.10.0

About Legacy System Extension alert

This release still uses the kernel extension (aka legacy system extension), so the following alert will be shown.

We are working to migrate to a newer mechanism, DriverKit, from kernel extension and we plan to support it at Karabiner-Elements 13.0.0.
It will take a little more time. Please wait.

Changes

• ✨ New Features
  • event_changed_if and event_changed_unless has been added to conditions.
• ⚡️ Improvements
  • Improved sending f1-f12 keys in complex modification (e.g., "change command+e to f2") by ignoring media key mappings for these keys.
  • Improved caps lock LED handling.
  • Improved uninstaller adding the kernel extension staging area clean up.
  • Improved complex modifications json checker.
  • "Check for updates" has been improved.
    • Updated Sparkle signing to EdDSA (ed25519) from DSA.
    • URL of appcast.xml has been updated.

v12.9.0

• 📅 Release date
  • Jan 18, 2020
• ✨ New Features
  • Open config folder button has been added into Preferences.
    The feature provides an easy way exporting configuration.
• ⚡️ Improvements
  • Added a workaround for non-dismissible Device is ignored temporarily alert
    which is caused by some devices that sends abnormal input events.
• 🐛 Bug Fixes
  • Fixed Add {key_code} to Karabiner-Elements button on EventViewer for unnamed keys (raw number key codes).
  • Fixed an issue that modifier flag events are not dispatched when changing pointing button while other character keys are pressed.
    (e.g., when changing pointing_button::button3 -> command+pointing_button::button1, command modifier is not sent when button1 is pressed while t key is also pressed.)

v12.8.0

• 📅 Release date
  • Nov 17, 2019
• ✨ New Features
  • Add --show-current-profile-name option into karabiner_cli.
  • Add --list-profile-names option into karabiner_cli.
• 🐛 Bug Fixes
  • Fixed an issue that Karabiner-Elements stops working after switching user on macOS Catalina.
  • Fixed an issue that Caps Lock LED is always manipulated even Manipulate LED setting is off.
  • Fixed an issue that MultitouchExtension does not handle ignored area properly when a finger is touched ignored area repeatedly.

v12.7.0

• 📅 Release date
  • Sep 12, 2019
• ✨ New Features
  • MultitouchExtension app has been added.
    • Documentation:
      • Usage
      • How to integrate MultitouchExtension to your complex modifications
  • Dark Mode has been supported.
  • Added --set-variables option into karabiner_cli.
• 🐛 Bug Fixes
  • Fixed an issue that Karabiner-Elements might stop working after sleep on macOS Catalina.

v12.6.0

• 📅 Release date
  • Aug 16, 2019
• ✨ New Features
  • Support macOS Catalina.
    
    (You need an extra configuration on macOS Catalina.)
• 🐛 Bug Fixes
  • Fixed an issue that Karabiner-Elements fails to grab a device in rare cases.
• ⚡️ Improvements
  • Introduced karabiner_kextd.
    (kext loading function was separated from karabiner_grabber.)
  • Improved EventViewer to show modifier flags of key events.
  • Suppressed unnecessary log messages.

v12.5.0

• 📅 Release date
  • Jun 10, 2019
• ✨ New Features
  • Add Delay before open device configuration into Karabiner-Elements Preferences > Devices > Advanced tab.
  • Added Show key code in hexadecimal format option into EventViewer.
• 🐛 Bug Fixes
  • Fixed a key stuck issue which occurs when the key is released,
    and at the exact same moment Karabiner-Elements opens the device.
  • Fixed an issue which Karabiner-Elements mistakes a remote user for a current console user
    if another user is logged in from Screen Sharing while console is used.
• ⚡️ Improvements
  • Improved XXX is ignored temporarily until YYY is pressed again behavior.
  • Move Disable the built-in keyboard while one of the following selected devices is connected configuration
    into Karabiner-Elements Preferences > Devices > Advanced tab.

v12.4.0

• 📅 Release date
  • May 14, 2019
• ✨ New Features
  • Add Mouse Key XY speed configuration into Karabiner-Elements Preferences > Virtual Keyboard tab.
  • Device is ignored temporarily alert has been introduced.
    
    This alert will be shown if you hold keys or buttons down before Karabiner-Elements opens the device.
    
    Please press the described key or button again to dismiss the alert.
    
    
• 🐛 Bug Fixes
  • Fixed a key stuck issue which occurs when the key is held down before Karabiner-Elements opens the device.
• ⚡️ Improvements
  • Event code format on EventViewer changed to decimal number from hex.

v12.3.0

• 📅 Release date
  • Apr 24, 2019
• 💥 Breaking changes
  • complex modifications json will be checked strictly since this release.
    
    Please check error messages if your complex modifications do not work after upgrade.
• ✨ New Features
  • Added Change mouse motion to scroll feature.
    
    • Note: You have to enable your mice on Devices tab when you want to use this feature.
  • Added --lint-complex-modifications option into karabiner_cli.
    It allows you checks a complex-modifications json file.
• ⚡️ Improvements
  • Set Karabiner-Elements.app and Karabiner-EventViewer.app immutable
    in order to ensure unremovable them except built-in uninstaller.
    Please use the uninstaller when you want to remove Karabiner-Elements.
  • Added a wait before grabbing device in order to avoid an macOS issue that device will be unusable after Karabiner-Elements is quit.
  • Changes for users who write their own json.
    • to and to_* support single object, e.g., "to": { "key_code": "spacebar" }.
    • New modifier aliases are added: left_alt, left_gui, right_alt, right_gui.
    • key_code, consumer_key_code and pointing_button supports a number value, e.g., "from": {"key_code": 175}.

v12.2.0

• 📅 Release date
  • Feb 1, 2019
• ✨ New Features
  • Karabiner-Elements makes a backup file of karabiner.json before updating it if the backup file does not exists.
    (~/.config/karabiner/automatic_backups/karabiner_YYYYMMDD.json)
• 🐛 Bug Fixes
  • Fixed an issue that Caps Lock LED does not work on macOS Mojave.
• ⚡️ Improvements
  • shell_command string max length has been expanded. (256 byte -> 32 KB)
  • A device grabbing process has been improved. (Observing device state by a separated karabiner_observer process.)
  • The event processing has been improved and the latency has been reduced by using pqrs::dispatcher.

v12.1.0

• 📅 Release date
  • May 30, 2018
• 💥 Breaking changes
  • Changed the order of to_if_alone and to_after_key_up event handling.
    
    to_if_alone will be handled before to_after_key_up.
• ✨ New Features
  • Added new items into simultaneous_options:
    • simultaneous_options.detect_key_down_uninterruptedly
    • simultaneous_options.key_up_when
  • Added new parameters into to event definition:
    • hold_down_milliseconds
    • halt
• 🐛 Bug Fixes
  • Fixed an issue that random key repeat happen at extremely high system CPU usage.
• ⚡️ Improvements
  • Increased rollover limit of virtual keyboard. (6 -> 32)
    
    This change mainly improves usability when you are using multiple keyboards at the same time.
  • Improved modifier flags handling in to_after_key_up and to_if_alone.