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.

v12.0.0

• 📅 Release date
  • Apr 12, 2018
• 💥 Breaking changes
  • macOS 10.11 support has been dropped.
    
    Karabiner-Elements works on macOS 10.12 (Sierra) or later.
  • Keyboard type in the virtual keyboard preferences has been removed. (Adverse effect of virtual keyboard improvement.)
    
    Please change the keyboard type from System Preferences > Keyboard > Change Keyboard Type....
    
  • Caps Lock Delay in the virtual keyboard preferences has been removed. (Adverse effect of virtual keyboard improvement.)
  • Changed simultaneous behaviour to post key_up events when any key is released.
  • Changed to_after_key_up and to_if_alone behaviour as mandatory modifiers are removed from these events.
• ✨ New Features
  • Added simultaneous_options.key_down_order, simultaneous_options.key_up_order and simultaneous_options.to_after_key_up.
• 🐛 Bug Fixes
  • Fixed an issue that to_if_alone, to_if_held_down and to_delayed_action does not work properly with simultaneous.
• ⚡️ Improvements
  • The virtual keyboard compatibility has been improved.
  • EventViewer has been improved showing the correct key name for PC keyboard keys and international keys.
  • Improved keyboard repeat handling with simultaneous.

v11.6.0

• 📅 Release date
  • Feb 20, 2018
• ✨ New Features
  • Simultaneous key presses has been supported in complex modifications.
    • json example
    • Document
• ⚡️ Improvements
  • Improved Mouse key scroll wheel direction referring System Preferences > Mouse > Scroll direction.
  • Improved modifier flags handling around pointing button manipulations.
  • Mouse keys have been added into Simple Modifications.
    
  • The eject key has been added into the from key of Simple Modifications.
  • The Vendor ID and Product ID of virtual devices has been changed. (0x0,0x0 -> 0x16c0,0x27db and 0x16c0,0x27da)

v11.5.0

• 📅 Release date
  • Dec 30, 2017
• ✨ New Features
  • to_if_held_down has been added.
    • Examples:
      • Open Alfred 3 if escape is held down
      • Quit application by holding command-q
• 🐛 Bug Fixes
  • Avoided a VMware Remote Console issue that mouse pointer does not work properly on VMRC when Karabiner-Elements grabs the pointing device.
  • Fixed an issue that to_if_alone does not work properly when to is empty.
• ⚡️ Improvements
  • Improved modifier flags handling in to events.
  • Improved a way to save karabiner.json.

v11.4.0

• 📅 Release date
  • Dec 7, 2017
• ✨ New Features
  • mouse_key has been added.
    • Examples:
      • Mouse keys (simple):
        json
        (src)
      • Mouse keys (full)
        json
        (src)
  • location_id has been added to device_if and device_unless.
• 🐛 Bug Fixes
  • Fixed an issue that the checkbox in Preferences > Devices is disabled for keyboards which do not have their own vendor id.

v11.3.0

• 📅 Release date
  • Nov 12, 2017
• 🐛 Bug Fixes
  • Fixed an issue that Karabiner-11.2.0 does not work properly on some environments due to a possibility of macOS kernel extension cache problem.

v11.2.0

• 📅 Release date
  • Nov 9, 2017
• ✨ New Features
  • Mouse button modifications has been added.
    
    Note:
    • You have to enable your Mouse manually in Preferences > Devices tab.
    • Karabiner-Elements cannot modify Apple's pointing devices.
  • to_delayed_action has been added.
    • Examples:
      • Quit application by pressing command-q twice
        json
        (src)
      • Emacs key bindings (C-x key strokes)
        json
        (src)
  • input_source_if and input_source_unless has been added to conditions.
    • Document
    • Example:
      • example_input_source.json
  • select_input_source has been added.
    • Document
    • Example:
      • example_select_input_source.json
  • keyboard_type_if and keyboard_type_unless has been added to conditions.
    • Example
      • Change control-[ to escape
        json
        (src)
  • The caps lock LED manipulation has been disabled with non Apple keyboards until it is enabled manually.
    
• ⚡️ Improvements
  • The virtual keyboard handling has been improved.

v11.1.0

• 📅 Release date
  • Oct 4, 2017
• 🐛 Bug Fixes
  • Fixed an issue that modifier flags becomes improperly state by mouse events.