Release / 3 Nov 2025

Karabiner-Elements v15.6.0

Write remapping conditions that calculate values and compare elapsed time.

All of Karabiner-Elements

Before you upgrade to v15.6.0

2 to fix

Stop reading `/Library/Application Support/org.pqrs/tmp/karabiner_grabber_manipulator_environment.json`; it is no longer updated. Use EventViewer to inspect current variables.

Action requiredAffects: Tools and workflows that read the manipulator-environment JSON file.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

Apple vendor events are always processed, even if `ignore_vendor_events` is manually enabled in `karabiner.json`.

Behavior changedChoose whether to ignore vendor events for a device.Affects: Apple-device configurations setting `ignore_vendor_events`.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

Use Xcode 26 or later to build from source; the documented minimum increased from Xcode 16.3.

Action requiredAffects: People building from source.Inferred

Read the evidence

pqrs-org/Karabiner-Elements/blob/v15.6.0/README.md

What changed in v15.6.0

Complex rules add expression conditions, expression-based variable updates and a millisecond clock; EventViewer can temporarily disable modifications.

Download the v15.6.0 macOS package from this release.

New things you can do

Adds `expression_if`, `expression_unless`, `set_variable.expression`, `set_variable.key_up_expression`, `system.now.milliseconds` and `from.integer_value`.

AddedUse calculated expressions and time values in remapping rules.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

EventViewer adds a toggle to disable all Karabiner-Elements modifications.

AddedTemporarily turn off all modifications from EventViewer.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

Environment variables can be set via `/Library/Application Support/org.pqrs/config/karabiner_environment`.

AddedSet environment variables for Karabiner-Elements through a configuration file.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

Adds Programmable Buttons usage support, including the VEC USB Footpedal, plus pointing buttons `button33` through `button255`.

AddedRemap programmable consumer-device buttons, including supported foot pedals.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

Fixed and improved

New events continue to be added while the Unknown Events tab is open.

Now worksInspect keyboard and pointing events in EventViewer.

Read the evidence

pqrs-org/Karabiner-Elements/releases/tag/v15.6.0

The README now lists both Intel and Apple Silicon support for macOS 26.

Limit liftedRemap keys on macOS 26 Tahoe.Inferred

Read the evidence

pqrs-org/Karabiner-Elements/blob/v15.6.0/README.md

Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.

Before you upgrade to v15.6.0

Stop reading `/Library/Application Support/org.pqrs/tmp/karabiner_grabber_manipulator_environment.json`; it is no longer updated. Use EventViewer to inspect current variables.

Apple vendor events are always processed, even if `ignore_vendor_events` is manually enabled in `karabiner.json`.

Use Xcode 26 or later to build from source; the documented minimum increased from Xcode 16.3.

What changed in v15.6.0

New things you can do

Adds `expression_if`, `expression_unless`, `set_variable.expression`, `set_variable.key_up_expression`, `system.now.milliseconds` and `from.integer_value`.

EventViewer adds a toggle to disable all Karabiner-Elements modifications.

Environment variables can be set via `/Library/Application Support/org.pqrs/config/karabiner_environment`.

Adds Programmable Buttons usage support, including the VEC USB Footpedal, plus pointing buttons `button33` through `button255`.

Adds `consumer_key_code::microphone`, `consumer_key_code::selection` and `generic_desktop::system_app_menu`.

Fixed and improved

New events continue to be added while the Unknown Events tab is open.

The README now lists both Intel and Apple Silicon support for macOS 26.