beta

• 💥 Breaking changes
  • macOS 11 and macOS 12 are no longer supported.
  • The background service management method has been changed to a new method compatible with macOS 13 and later.
    Therefore, permission needs to be granted for the background service to run. Please follow the steps below.
    • Open Karabiner-Elements Settings.
    • Follow the instructions to allow Karabiner-Elements Privileged Daemons to run in the System Settings.
      
      
      
  • The method to enable the Multitouch Extension has changed.
    To enable the Multitouch Extension, go to the Misc tab in the settings and turn on Enable Multitouch Extension.
    
    
    
• 🔔 Important Notes
  • A unique random ID called karabiner_machine_identifier is now generated during installation.
    This ID is used for machine-specific settings and may be included in the karabiner.json file.
    If you are sharing karabiner.json with others, you might be interested in how this ID is generated and whether it is safe to share.
    Since it is a safe ID to share with others, and there is no need to mask it when you share karabiner.json with others.
    For more details, please refer to the Privacy page.
    
    
    
• ✨ New Features
  • Added the ability to duplicate and reorder profiles.
  • Added the ability to restart Karabiner-Elements from the menu.
• ⚡️ Improvements
  • Improved "{device} is ignored temporarily until {key_code} is pressed again" message for to make it more understandable. (Thanks to @adamnovak)
  • Added "Enable Karabiner Notification Window" configuration, which allows you to hide the notification window by turning off this setting. (Thanks to @jwodnicki)
  • Support al_consumer_control_configuration key, used as the Music key. (Thanks to @kambala-decapitator)
  • Improved behaviour when using the gamepad stick as a pointing device.
  • Improved to_if_alone behavior to use the modifier flags of the time the key is pressed, when sending events.
  • Added {"type": "unset"} option to set_variable.
  • Integrated karabiner_observer functions into karabiner_grabber, and then karabiner_observer has been removed.
    The number of background processes has been reduced, resolving performance issues caused by inter-process communication that were occurring in some environments.
  • A custom JSON formatter has been introduced to save JSON in a more compact format.
  • The process for saving the configuration file has been optimized so that settings that have not been changed from their default values are not included in karabiner.json.
  • Internal changes:
    • Improved the interface of libkrbn to minimize the use of unsafe pointers in Swift.

v14.13.0

• 📦 Download
• 📅 Release date
  • Dec 9, 2023
• 🔔 Important Notes
  • A reboot is required when upgrading from version 14.12.0 or earlier, to update the virtual keyboard driver.
• ✨ New Features
  • Palm detection is supported in MultitouchExtension. (Thanks to @quarkw)
  • Use Bluetooth address (Bluetooth MAC address) is used to identify the device when the Bluetooth device does not have Vendor ID and Product ID. (Thanks to @stackia)
  • Add the following settings into Devices tab.
    • Flip mouse X
    • Flip mouse Y
    • Flip mouse vertical wheel
    • Flip mouse horizontal wheel
    • Swap mouse X and Y
    • Swap mouse wheels
  • Gamepad support (DirectInput devices are supported. Xinput is not supported at all)
  • Added "Add your own rule" button into Complex Modifications settings.
  • The json content of Complex Modifications can now be changed via the Edit button.
  • Added "Move item to top" and "Move item to bottom" into the context menu of the Complex Modifications list.
  • Add the following options to karabiner_cli
    • --format-json
    • --eval-js
    • --silent
  • Changes for users who write their own json.
    • The device_address condition has been added into device_if and device_unless. (Thanks to @stackia)
    • Added key_up_value to set_variable.
    • Added mouse_basic manipulator.
• ⚡️ Improvements
  • Added the ability to filter by keywords when adding Complex Modifications rules.
  • Adjusted the position of the Add rule button in Complex Modifications. (Thanks to @GanZhiXiong)
  • MultitouchExtension has been rewritten in Swift.

v14.12.0

• 📦 Download
• 📅 Release date
  • Apr 16, 2023
• ✨ New Features
  • Added the ability to switch application icons. This can be changed from the UI tab in Settings.
    • Manual
  • Added new application icons. (Thanks to @Zabriskije)
  • Added the following variables in MultitouchExtension. (Thanks to @codeanpeace)
    • multitouch_extension_finger_count_upper_quarter_area
    • multitouch_extension_finger_count_lower_quarter_area
    • multitouch_extension_finger_count_left_quarter_area
    • multitouch_extension_finger_count_right_quarter_area
• ⚡️ Improvements
  • Prevent moving the mouse from waking up from sleep by ungrab devices during system sleep. (Thanks to @aspacca)
  • Fixed inconsistent and confusing brightness label in Simple Modifications. (Thanks to @revolter)
  • Improved MultitouchExtension to synchronize finger count (half and quarter) variables with finger movement.
  • Moved "Disable the built-in keyboard while this device is connected" settings into Devices tab from Devices > Advanced tab in Settings.
• 🐛 Bug Fixes
  • Fixed an issue that dynamic keyboard type change (ANSI, ISO and JIS) by changing the country code of the virtual keyboard did not work properly.

v14.11.0

• 📦 Download
• 📅 Release date
  • Jan 7, 2023
• 💥 Breaking changes
  • Changed bundle identifier of Karabiner-Elements Settings to org.pqrs.Karabiner-Elements.Settings from org.pqrs.Karabiner-Elements.Preferences.
• ✨ New Features
  • Added Ask for confirmation when quitting option into Settings > Misc tab. (Thanks to @basti1302)
• ⚡️ Improvements
  • Improved health checks for inter-process communication to better recover from errors.
• 🐛 Bug Fixes
  • Fixed an issue that uninstaller does not remove Karabiner-Elements.app and Karabiner-EventViewer.app in macOS Ventura.
  • Fixed an issue that could cause multiple update windows will be shown.

v14.10.0

• 📦 Download
• 📅 Release date
  • Sep 25, 2022
• ⚡️ Improvements
  • Update set_mouse_cursor_position to use the current screen if screen option is not specified. (Thanks to @gnawf)
  • Sparkle Framework has been updated.
• 🐛 Bug Fixes
  • Fixed an issue that the device_if and device_unless does not work if vendor_id or product_id is zero. (or more precisely, if vendor_id or product_id cannot be retrieved and is set to 0)

v14.9.0

• 📦 Download
• 📅 Release date
  • Sep 11, 2022
• ✨ New Features
  • Supported Remote control buttons. (menu arrows buttons, color buttons)
  • The is_built_in_keyboard has been added into device_if and device_unless.
  • The device_exists_if and device_exists_unless has been added into conditions.
• 🐛 Bug Fixes
  • Fixed an issue that the ignored device's modifier keys are not ignored properly.

v14.8.0

• 📦 Download
• 📅 Release date
  • Aug 11, 2022
• ✨ New Features
  • Add Enable unsafe configuration feature into Preferences > Pro tab.
• 🐛 Bug Fixes
  • Fixed an issue that the built-in keyboard is not be treated as the built-in keyboard if the keyboard is connected via SPI (Serial Peripheral Interface), such as M2 MacBook Air.

v14.6.0

• 📦 Download
• 📅 Release date
  • Jul 31, 2022
• ✨ New Features
  • Treat as built-in keyboard setting has been added into Devices configuration. It works with "Disable the built-in keyboard" feature.
• 🐛 Bug Fixes
  • Fixed an issue that "Disable the built-in keyboard" feature does not work if the built-in keyboard is not included in the event modification target devices.

v14.5.0

• 📦 Download
• 📅 Release date
  • Jul 17, 2022
• 💥 Breaking changes
  • The following modifier flags and manipulators are now canceled even for events from devices not grabbed by Karabiner-Elements, e.g. mouse clicks.
    • sticky modifiers
    • to_if_alone
    • to_if_held_down
    • to_delayed_action
• ⚡️ Improvements
  • Improved behavior the sticky modifiers when used together with the built-in trackpad. (Thanks to @quarkw)
  • Preferences Window is rewritten in SwiftUI.
  • set_variable now supports bool and string value.
  • Sparkle Framework has been updated.

v14.4.0

• 📦 Download
• 📅 Release date
  • Mar 1, 2022
• 🐛 Bug Fixes
  • Fixed an issue that NotificationWindow causes high CPU usage in some environments.