from.simultaneous_options
simultaneous_options
adjust the simultaneous
behavior.
Key | Value | Description |
---|---|---|
detect_key_down_uninterruptedly |
true or false |
Specify whether key_down detection is interrupted with unrelated events |
key_down_order |
insensitive , strict or strict_inverse |
Restriction of key_down order |
key_up_order |
insensitive , strict or strict_inverse |
Restriction of key_up order |
key_up_when |
any or all |
When key_up events are posted |
to_after_key_up |
An array of to event definitions |
Events will be posted when all from events are released |
detect_key_down_uninterruptedly
If detect_key_down_uninterruptedly
is true, Karabiner-Elements changes simultaneous events even if unrelated key down event exists between target events.
For example, when escape+3 -> mission_control
, escape,1,3
will be mission_control,1
if detect_key_down_uninterruptedly
is true.
The default value is false
.
key_down_order
simultaneous
checks the order of key_down events if key_down_order
is specified and is not insensitive
.
For example, this definition manipulates tab,q
to mission_control
and does not manipulate q,tab
events.
{
"type": "basic",
"from": {
"simultaneous": [
{
"key_code": "tab"
},
{
"key_code": "q"
}
],
"simultaneous_options": {
"key_down_order": "strict"
},
"modifiers": {
"optional": ["any"]
}
},
"to": [
{
"key_code": "mission_control"
}
]
}
key_up_order
simultaneous
checks the order of key_up events if key_up_order
is specified and is not insensitive
.
Tip
key_up_order
is ignored if simultaneous_threshold_milliseconds
is reached.
You should set a large value to simultaneous_threshold_milliseconds
when you use key_up_order
.
For example, this definition manipulates tab,q
to mission_control
if the tab
key is released before the q
key within 500 milliseconds.
Input | Output |
---|---|
tab & q key_down |
— |
tab key_up |
mission_control key_down, mission_control key_up |
q key_up |
— |
Note
Events will be posted just before the last from event’s key_up.{
"type": "basic",
"parameters": {
"basic.simultaneous_threshold_milliseconds": 500
},
"from": {
"simultaneous": [
{
"key_code": "tab"
},
{
"key_code": "q"
}
],
"simultaneous_options": {
"key_up_order": "strict"
},
"modifiers": {
"optional": ["any"]
}
},
"to": [
{
"key_code": "mission_control"
}
]
}
key_up_when
Specify when key_up events are posted.
Value | Description |
---|---|
any |
Post key_up events when any key is released |
all |
Post key_up events when all keys are released |
to_after_key_up
to_after_key_up
will be posted when all from
events are released.
This feature is typically used to clear mode flag variables when all from
events are released.
Example:
- Mouse Keys Mode v4