- 📦 Download
- 📅 Release date
- Aug 30, 2026
- 🔔 Important Notes
- When upgrading from v15.9.0 or earlier, automatic startup of the Karabiner-Elements services will be disabled.
After upgrading, open Karabiner-Elements.app to re-enable automatic startup.
- When upgrading from v15.9.0 or earlier, automatic startup of the Karabiner-Elements services will be disabled.
- 💥 Breaking changes
- Integrated the Multitouch Extension menu into the Karabiner-Elements menu.
Open the Multitouch Extension settings from the Karabiner-Elements menu.
- Integrated the Multitouch Extension menu into the Karabiner-Elements menu.
- ✨ New Features
- Added the
Swap ISO layout-specific keysconfiguration to Device tab. - Added filtering functionality to the Complex Modifications list.
- Added support for buttons 6–8 on the ELECOM HUGE PLUS and DEFT trackballs. (Thanks to @z11i)
- Added appearance settings for the notification window. (Thanks to @xianjianlf2)
- Added
Capture Raw Input EventsandCapture Raw Input Recordsto EventViewer. - Added
--set-variables-from-stdinoption to karabiner_cli. - Added the
duration_millisecondsoption toset_notification_message. (Thanks to @xianjianlf2) - Added the
Modify events for pointing devices by defaultsetting to Expert tab. (Thanks to @xianjianlf2)
- Added the
- 🐛 Bug Fixes
- Fixed CGEventTap leaks (Thanks to @MrMage and @VitalyShein)
- ⚡️ Improvements
- Complex Modifications import now supports JavaScript files and single-rule JSON files.
- Improved the handling of macOS sleep shortcuts to prevent key-up events from immediately waking the Mac.
- Fixed an issue where the core service agent could rarely abort during termination.
- Fixed an issue where modifications could stop working for several seconds after waking from sleep on macOS.
- Karabiner-EventViewer and the Settings window are now closed after an upgrade.
- Added support for unbundled GUI apps in
frontmost_application_ifandfrontmost_application_unless. - Added support for
notesin complex modification rules. variable_ifnow supports the following variable:- accessibility.focused_ui_element.window_title_string
- Added the event timestamp in EventViewer.
- The
karabiner_console_user_server, Menu, and NotificationWindow components have been consolidated into a single app named Karabiner-Console-User-Server. - Refactored the C++ and Swift code for the Settings, EventViewer, and MultitouchExtension apps.