v13.3.0

• 📦 Download
• 📅 Release date
  • Jan 29, 2021
• 🐛 Bug Fixes
  • Fixed an issue that installer requires Rosetta 2 on Apple Silicon Macs.
• 💥 Breaking changes
  • Changed the default function of f4 key to spotlight, f5 key to dictation, f6 key to f6.
    • Note: This change will be applied when you create a new profile.
  • Changed to Karabiner-Elements does not modify f1-f12 keys on touch bar.
  • The caps lock delay of Karabiner Virtual HID Keyboard has been removed.
    The state of caps lock will be changed immediately after you press the caps lock key.
• ✨ New Features
  • Supported sticky modifier keys
  • Added apple_vendor_keyboard_key_code and apple_vendor_top_case_key_code to event definitions.
    • apple_vendor_keyboard_key_code
    • apple_vendor_top_case_key_code
• ⚡️ Improvements
  • Updated in-app screenshots to Big Sur.
  • Added the close button to notification window.

v13.1.0

• 📦 Download
• 📅 Release date
  • Oct 30, 2020
• 🔔 Important Notes
  • Restarting macOS is required after upgrading from v13.0.0.
    
    The following alert will be shown after upgrade. Please follow the instructions.
    
    
• 🐛 Bug Fixes
  • Fixed an issue that Karabiner-DriverKit-VirtualHIDDevice might crash when caps lock key is pressed in some environments.

v13.0.0

• 📦 Download
• 📅 Release date
  • Oct 4, 2020
• 💥 Breaking changes
  • macOS 10.12 - 10.14 support has been dropped.
• ✨ New Features
  • Supported macOS Big Sur (11.0)
  • Supported both Intel-based Macs and Apple Silicon Macs.
  • Changed the virtual keyboard and mouse implementation to DriverKit from deprecated kernel extension.
• ⚡️ Improvements
  • Improved preferences window messages.
  • Partial support for comments in karabiner.json configuration file.
    • Supported reading json file with comments.
    • Limitation: The json comments will be removed if you change the json from Preferences GUI or command line interface.

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.