Use more complex rules

Karabiner-Elements provides more complex event modifications.
These rules change keys by conditions.

There are two ways to add rules

  • Import predefined rules maintained by the community
  • Create your own rules

In both cases, you can modify the rules later to make them more personalised.


Import predefined rules

Step 1

Open Complex Modifications tab and press Add predefined rule button, then press Import more rules from the internet button.
Official rules site will be open using your default web browser.

karabiner-elements-complex-modifications-1@2x.png
karabiner-elements-complex-modifications-2@2x.png

Step 2

Press Import button in the page.
A confirmation dialog is shown. Press Allow button.

karabiner-elements-complex-modifications-3@2x.png
karabiner-elements-complex-modifications-4@2x.png

Step 3

Karabiner-Elements is shown again. Press Import button, then new rules are imported.

karabiner-elements-complex-modifications-5@2x.png

Step 4

Press Enable button.

karabiner-elements-complex-modifications-6@2x.png

Step 5

New rule is enabled.
Confirm the result using Karabiner-EventViewer.


Create your own rules

Step 1

Open Complex Modifications tab and press Add your own rule button.

own-rule-1@2x.png

Step 2

An editor will open with sample rules. Change the content and press the Save button to register.

When making changes, Karabiner-EventViewer and Karabiner Configuration Reference Manual can be used to confirm the key names and how to write rules.

own-rule-2@2x.png

Edit rules

Open Complex Modifications tab and press Edit button. The editor will open. Change the contents and save it.

When making changes, Karabiner-EventViewer and Karabiner Configuration Reference Manual can be used to confirm the key names and how to write rules.

edit-rule-1@2x.png
edit-rule-2@2x.png