<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h3id="dynamic-tapping-term"tabindex="-1">Dynamic Tapping Term <aclass="header-anchor"href="#dynamic-tapping-term"aria-label="Permalink to "Dynamic Tapping Term {#dynamic-tapping-term}""></a></h3><p><code>DYNAMIC_TAPPING_TERM_ENABLE</code> is a feature you can enable in <code>rules.mk</code> that lets you use three special keys in your keymap to configure the tapping term on the fly.</p><table><thead><tr><th>Key</th><th>Aliases</th><th>Description</th></tr></thead><tbody><tr><td><code>QK_DYNAMIC_TAPPING_TERM_PRINT</code></td><td><code>DT_PRNT</code></td><td>Types the current tapping term, in milliseconds</td></tr><tr><td><code>QK_DYNAMIC_TAPPING_TERM_UP</code></td><td><code>DT_UP</code></td><td>Increases the current tapping term by <code>DYNAMIC_TAPPING_TERM_INCREMENT</code>ms (5ms by default)</td></tr><tr><td><code>QK_DYNAMIC_TAPPING_TERM_DOWN</code></td><td><code>DT_DOWN</code></td><td>Decreases the current tapping term by <code>DYNAMIC_TAPPING_TERM_INCREMENT</code>ms (5ms by default)</td></tr></tbody></table><p>Set the tapping term as usual with <code>#define TAPPING_TERM <value></code> in <code>config.h</code> and add <code>DYNAMIC_TAPPING_TERM_ENABLE = yes</code> in <code>rules.mk</code>. Then, place the above three keys somewhere in your keymap and flash the new firmware onto your board.</p><p>Now, you can try using your dual-role keys, such as layer-taps and mod-taps, and use <code>DT_DOWN</code> and <code>DT_UP</code> to adjust the tapping term immediately. If you find that you frequently trigger the modifier of your mod-tap(s) by accident, for example, that's a sign that your tapping term may be too low so tap <code>DT_UP</code> a few times to increase the tapping term until that no longer happens. On the flip side, if you get superfluous characters when you actually intended to momentarily activate a layer, tap <code>DT_DOWN</code> to lower the tapping term. Do note that these keys affect the <em>global</em> tapping term, you cannot change the tapping term of a specific key on the fly.</p><p>Once you're satisfied with the current tapping term value, open <code>config.h</code> and replace whatever value you first wrote for the tapping term by the output of the <code>DT_PRNT</code> key.</p><p>It's important to update <code>TAPPING_TERM</code> with the new value because the adjustments made using <code>DT_UP</code> and <code>DT_DOWN</code> are not persistent.</p><p>The value by which the tapping term increases or decreases when you tap <code>DT_UP</code> and <code>DT_DOWN</code> can be configured in <code>config.h</code> with <code>#define DYNAMIC_TAPPING_TERM_INCREMENT <new value></code>. Note that the tapping term is <em>not</em> modified when holding down the tap term keys so if you need to, for example, decrease the current tapping term by 50ms, you cannot just press down and hold <code>DT_DOWN</code>; you will have to tap it 10 times in a row with the default increment of 5ms.</p><p>If you need more flexibility, nothing prevents you from defining your own custom keys to dynamically change the tapping term.</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">enum</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> custom_dynamic_tapping_term_keys </span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">};</span></span></code></pre></div><p>In order for this feature to be effective if you use per-key tapping terms, you need to make a few changes to the syntax of the <code>get_tapping_term</code> function. All you need to do is replace every occurrence of <code>TAPPING_TERM</code> in the <code>get_tapping_term</code> function by lowercase <code>g_tapping_term</code>. If you don't do that, you will still see the value typed by <code>DT_PRNT</code> go up and down as you configure the tapping term on the fly but you won't feel those changes as they don't get applied. If you can go as low as 10ms and still easily trigger the tap function of a dual-role key, that's a sign that you forgot to make the necessary changes to your <code>get_tapping_term</code> function.</p><p>For instance, here's how the example <code>get_tapping_term</code> shown earlier should look after the transformation:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> get_tapping_term</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> keycode</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">keyrecord_t</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;">record</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>The reason is that <code>TAPPING_TERM</code> is a macro that expands to a constant integer and thus cannot be changed at runtime whereas <code>g_tapping_term</code> is a variable whose value can be changed at runtime. If you want, you can temporarily enable <code>DYNAMIC_TAPPING_TERM_ENABLE</code> to find a suitable tapping term value and then disable that feature and revert back to using the classic syntax for per-key tapping term settings. In case you need to access the tapping term from elsewhere in your code, you can use the <code>GET_TAPPING_TERM(keycode, record)</code> macro. This macro will expand to whatever is the appropriate access pattern given the current configuration.</p><h2id="tap-or-hold-decision-modes"tabindex="-1">Tap-Or-Hold Decision Modes <aclass="header-anchor"href="#tap-or-hold-decision-modes"aria-label="Permalink to "Tap-Or-Hold Decision Modes""></a></h2><p>The code which decides between the tap and hold actions of dual-role keys supports three different modes, in increasing order of preference for the hold action:</p><ol><li><p>The default mode selects the hold action only if the dual-role key is held down longer than the tapping term. In this mode pressing other keys while the dual-role key is held down does not influence the tap-or-hold decision. In other words, this mode ignores interrupts.</p></li><li><p>The “permissive hold” mode, in addition to the default behavior, immediately selects the hold action when another key is tapped (pressed and then released) while the dual-role key is held down, even if this happens earlier than the tapping term. If another key is just pressed, but then the dual-role key is released before that other key (and earlier than the tapping term), this mode will still select the tap action.</p></li><li><p>The “hold on other key press” mode, in addition to the default behavior, immediately selects the hold action when another key is pressed while the dual-role key is held down, even if this happens earlier than the tapping term.</p></li></ol><p>Note that until the tap-or-hold decision completes (which happens when either the dual-role key is released, or the tapping term has expired, or the extra condition for the selected decision mode is satisfied), key events are delayed and not transmitted to the host immediately. The default mode gives the most delay (if the dual-role key is held down, this mode always waits for the whole tapping term), and the other modes may give less delay when other keys are pressed, because the hold action may be selected earlier.</p><h3id="comparison"tabindex="-1">Comparison <aclass="header-anchor"href="#comparison"aria-label="Permalink to "Comparison {#comparison}""></a></h3><p>To better illustrate the tap-or-hold decision modes, let us compare the expected output of each decision mode in a handful of tapping scenarios involving a mod-tap key (<code>LSFT_T(KC_A)</code>) and a regular key (<code>KC_B</code>) with the <code>TAPPING_TERM</code> set to 200ms.</p><p>Note: "<code>kc</code> held" in the "Physical key event" column means that the key wasn't physically released yet at this point in time.</p><h4id="distinct-taps"tabindex="-1">Distinct taps (AABB) <aclass="header-anchor"href="#distinct-taps"aria-label="Permalink to "Distinct taps (AABB) {#distinct-taps}""></a></h4><table><thead><tr><th>Time</th><th>Physical key event</th><th>Default</th><th><code>PERMISSIVE_HOLD</code></th><th><code>HOLD_ON_OTHER_KEY_PRESS</code></th></tr></thead><tbody><tr><td>0</td><td><code>LSFT_T(KC_A)</code> down</td><td></td><td></td><td></td></tr><tr><td>199</td><td><code>LSFT_T(KC_A)</code> up</td><td>a</td><td>a</td><td>a</td></tr><tr><td>210</td><td><code>KC_B</code> down</td><td>ab</td><td>ab</td><td>ab</td></tr><tr><td>220</td><td><code>KC_B</code> up</td><td>ab</td><td>ab</td><td>ab</td></tr></tbody></table><table><thead><tr><th>Time</th><th>Physical key eve
<spanclass="line"><span> +---------------|--------------------+</span></span></code></pre></div><p>The above sequence would send a <code>KC_RGHT</code>, since <code>LT(2, KC_A)</code> is held longer than the <code>TAPPING_TERM</code>.</p><hr><p>Example sequence 2 (the <code>L</code> key is also mapped to <code>KC_RGHT</code> on layer 2):</p><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM</span></span>
<spanclass="line"><span> +-----------------------------|------+</span></span></code></pre></div><p>The above sequence will not send <code>KC_RGHT</code> but <code>KC_A</code><code>KC_L</code> instead, since <code>LT(2, KC_A)</code> is not held longer than the <code>TAPPING_TERM</code>.</p><hr><p>Example sequence 3 (Mod Tap):</p><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM</span></span>
<spanclass="line"><span> +---------------------------|--------+</span></span></code></pre></div><p>In the above sequence, <code>SFT_T(KC_A)</code> has been released before the end of its <code>TAPPING_TERM</code> and as such will be interpreted as <code>KC_A</code>, followed by any key event that happened after the initial press of <code>SFT_T(KC_A)</code>. In this instance, the output would be <code>KC_A</code><code>KC_X</code>.</p><h3id="permissive-hold"tabindex="-1">Permissive Hold <aclass="header-anchor"href="#permissive-hold"aria-label="Permalink to "Permissive Hold""></a></h3><p>The “permissive hold” mode can be enabled for all dual-role keys by adding the corresponding option to <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> PERMISSIVE_HOLD</span></span></code></pre></div><p>This makes tap and hold keys (like Layer Tap) work better for fast typists, or for high <code>TAPPING_TERM</code> settings.</p><p>If you press a dual-role key, tap another key (press and release) and then release the dual-role key, all within the tapping term, by default the dual-role key will perform its tap action. If the <code>PERMISSIVE_HOLD</code> option is enabled, the dual-role key will perform its hold action instead.</p><p>An example of a sequence that is affected by the “permissive hold” mode:</p><ul><li><code>LT(2, KC_A)</code> Down</li><li><code>KC_L</code> Down (the <code>L</code> key is also mapped to <code>KC_RGHT</code> on layer 2)</li><li><code>KC_L</code> Up</li><li><code>LT(2, KC_A)</code> Up</li></ul><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM </span></span>
<spanclass="line"><span> +---------------------------|--------+</span></span></code></pre></div><p>Normally, if you do all this within the <code>TAPPING_TERM</code> (default: 200ms), this will be registered as <code>al</code> by the firmware and host system. With the <code>PERMISSIVE_HOLD</code> option enabled, the Layer Tap key is considered as a layer switch if another key is tapped, and the above sequence would be registered as <code>KC_RGHT</code> (the mapping of <code>L</code> on layer 2). We could describe this sequence as a “nested tap” (the modified key's key down and key up events are “nested” between the dual-role key's key down and key up events).</p><p>However, this slightly different sequence will not be affected by the “permissive hold” mode:</p><ul><li><code>LT(2, KC_A)</code> Down</li><li><code>KC_L</code> Down (the <code>L</code> key is also mapped to <code>KC_RGHT</code> on layer 2)</li><li><code>LT(2, KC_A)</code> Up</li><li><code>KC_L</code> Up</li></ul><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM </span></span>
<spanclass="line"><span> +---------------------------|--------+</span></span></code></pre></div><p>In the sequence above the dual-role key is released before the other key is released, and if that happens within the tapping term, the “permissive hold” mode will still choose the tap action for the dual-role key, and the sequence will be registered as <code>al</code> by the host. We could describe this as a “rolling press” (the two keys' key down and key up events behave as if you were rolling a ball across the two keys, first pressing each key down in sequence and then releasing them in the same order).</p><divclass="tip custom-block"><pclass="custom-block-title">TIP</p><p>The <code>PERMISSIVE_HOLD</code> option is not noticeable if you also enable <code>HOLD_ON_OTHER_KEY_PRESS</code> because the latter option considers both the “nested tap” and “rolling press” sequences like shown above as a hold action, not the tap action. <code>HOLD_ON_OTHER_KEY_PRESS</code> makes the Tap-Or-Hold decision earlier in the chain of key events, thus taking a precedence over <code>PERMISSIVE_HOLD</code>.</p></div><p>For more granular control of this feature, you can add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> PERMISSIVE_HOLD_PER_KEY</span></span></code></pre></div><p>You can then add the following function to your keymap:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> get_permissive_hold</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> keycode</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">keyrecord_t</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;">record</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // Immediately select the hold action when another key is tapped.</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h3id="hold-on-other-key-press"tabindex="-1">Hold On Other Key Press <aclass="header-anchor"href="#hold-on-other-key-press"aria-label="Permalink to "Hold On Other Key Press""></a></h3><p>The “hold on other key press” mode can be enabled for all dual-role keys by adding the corresponding option to <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> HOLD_ON_OTHER_KEY_PRESS</span></span></code></pre></div><p>This mode makes tap and hold keys (like Layer Tap) work better for fast typists, or for high <code>TAPPING_TERM</code> settings. Compared to the “permissive hold” mode, this mode selects the hold action in more cases.</p><p>If you press a dual-role key, press another key, and then release the dual-role key, all within the tapping term, by default the dual-role key will perform its tap action. If the <code>HOLD_ON_OTHER_KEY_PRESS</code> option is enabled, the dual-role key will perform its hold action instead.</p><p>An example of a sequence that is affected by the “hold on other key press” mode, but not by the “permissive hold” mode:</p><ul><li><code>LT(2, KC_A)</code> Down</li><li><code>KC_L</code> Down (the <code>L</code> key is also mapped to <code>KC_RGHT</code> on layer 2)</li><li><code>LT(2, KC_A)</code> Up</li><li><code>KC_L</code> Up</li></ul><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM</span></span>
<spanclass="line"><span> +---------------------------|--------+</span></span></code></pre></div><p>Normally, if you do all this within the <code>TAPPING_TERM</code> (default: 200ms), this will be registered as <code>al</code> by the firmware and host system. With the <code>HOLD_ON_OTHER_KEY_PRESS</code> option enabled, the Layer Tap key is considered as a layer switch if another key is pressed, and the above sequence would be registered as <code>KC_RGHT</code> (the mapping of <code>L</code> on layer 2).</p><p>For more granular control of this feature, you can add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> HOLD_ON_OTHER_KEY_PRESS_PER_KEY</span></span></code></pre></div><p>You can then add the following function to your keymap:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> get_hold_on_other_key_press</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> keycode</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">keyrecord_t</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;">record</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // Immediately select the hold action when another key is pressed.</span></span>
<spanclass="line"><spanstyle="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // Do not select the hold action when another key is pressed.</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2id="quick-tap-term"tabindex="-1">Quick Tap Term <aclass="header-anchor"href="#quick-tap-term"aria-label="Permalink to "Quick Tap Term""></a></h2><p>When the user holds a key after tapping it, the tapping function is repeated by default, rather than activating the hold function. This allows keeping the ability to auto-repeat the tapping function of a dual-role key. <code>QUICK_TAP_TERM</code> enables fine tuning of that ability. If set to <code>0</code>, it will remove the auto-repeat ability and activate the hold function instead.</p><p><code>QUICK_TAP_TERM</code> is set to <code>TAPPING_TERM</code> by default, which is the maximum allowed value for <code>QUICK_TAP_TERM</code>. To override its value (in milliseconds) add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> QUICK_TAP_TERM</span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 120</span></span></code></pre></div><p>Example:</p><ul><li><code>SFT_T(KC_A)</code> Down</li><li><code>SFT_T(KC_A)</code> Up</li><li><code>SFT_T(KC_A)</code> Down</li><li>(wait until tapping term expires...)</li></ul><p>With default settings, <code>a</code> will be sent on the first release, then <code>a</code> will be sent on the second press allowing the computer to trigger its auto repeat function until the key is released.</p><p>With <code>QUICK_TAP_TERM</code> configured, the timing between <code>SFT_T(KC_A)</code> up and <code>SFT_T(KC_A)</code> down must be within <code>QUICK_TAP_TERM</code> to trigger auto repeat. Otherwise the second press will be sent as a Shift. If <code>QUICK_TAP_TERM</code> is set to <code>0</code>, the second press will always be sent as a Shift, effectively disabling auto-repeat.</p><divclass="warning custom-block"><pclass="custom-block-title">WARNING</p><p><code>QUICK_TAP_TERM</code> timing will also impact anything that uses tapping toggles (Such as the <code>TT</code> layer keycode, and the One Shot Tap Toggle).</p></div><p>For more granular control of this feature, you can add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> QUICK_TAP_TERM_PER_KEY</span></span></code></pre></div><p>You can then add the following function to your keymap:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> get_quick_tap_term</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> keycode</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">keyrecord_t</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;">record</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><divclass="tip custom-block"><pclass="custom-block-title">TIP</p><p>If <code>QUICK_TAP_TERM</code> is set higher than <code>TAPPING_TERM</code>, it will default to <code>TAPPING_TERM</code>.</p></div><h2id="retro-tapping"tabindex="-1">Retro Tapping <aclass="header-anchor"href="#retro-tapping"aria-label="Permalink to "Retro Tapping""></a></h2><p>To enable <code>retro tapping</code>, add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> RETRO_TAPPING</span></span></code></pre></div><p>Holding and releasing a dual-function key without pressing another key will result in nothing happening. With retro tapping enabled, releasing the key without pressing another will send the original keycode even if it is outside the tapping term.</p><p>For instance, holding and releasing <code>LT(2, KC_SPC)</code> without hitting another key will result in nothing happening. With this enabled, it will send <code>KC_SPC</code> instead.</p><divclass="language- vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang"></span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><span> TAPPING_TERM</span></span>
<spanclass="line"><span> +-----------------|------------------+</span></span></code></pre></div><p>For more granular control of this feature, you can add the following to your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> RETRO_TAPPING_PER_KEY</span></span></code></pre></div><p>You can then add the following function to your keymap:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> get_retro_tapping</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint16_t</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> keycode</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">keyrecord_t</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><spanstyle="--shiki-light:#E36209;--shiki-dark:#FFAB70;">record</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
<spanclass="line"><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>If the programs you use bind an action to taps of modifier keys (e.g. tapping left GUI to bring up the applications menu or tapping left Alt to focus the menu bar), you may find that using retro-tapping falsely triggers those actions. To counteract this, you can define a <code>DUMMY_MOD_NEUTRALIZER_KEYCODE</code> in <code>config.h</code> that will get sent in between the register and unregister events of a held mod-tap key. That way, the programs on your computer will no longer interpret the mod suppression induced by retro-tapping as a lone tap of a modifier key and will thus not falsely trigger the undesired action.</p><p>Naturally, for this technique to be effective, you must choose a <code>DUMMY_MOD_NEUTRALIZER_KEYCODE</code> for which no keyboard shortcuts are bound to. Recommended values are: <code>KC_RIGHT_CTRL</code> or <code>KC_F18</code>. Please note that <code>DUMMY_MOD_NEUTRALIZER_KEYCODE</code> must be a basic, unmodified, HID keycode so values like <code>KC_NO</code>, <code>KC_TRANSPARENT</code> or <code>KC_PIPE</code> aka <code>S(KC_BACKSLASH)</code> are not permitted.</p><p>By default, only left Alt and left GUI are neutralized. If you want to change the list of applicable modifier masks, use the following in your <code>config.h</code>:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MODS_TO_NEUTRALIZE</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"><</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">mod_mask_1</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;"><</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">mod_mask_2</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ... }</span></span></code></pre></div><p>Examples:</p><divclass="language-c vp-adaptive-theme"><buttontitle="Copy Code"class="copy"></button><spanclass="lang">c</span><preclass="shiki shiki-themes github-light github-dark vp-code"><code><spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> DUMMY_MOD_NEUTRALIZER_KEYCODE</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> KC_RIGHT_CTRL</span></span>
<spanclass="line"></span>
<spanclass="line"><spanstyle="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// Neutralize left alt and left GUI (Default value)</span></span>
<spanclass="line"><spanstyle="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// Neutralize left alt, left GUI, right GUI and left Control+Shift</span></span>
<spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MODS_TO_NEUTRALIZE</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">MOD_BIT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_LEFT_ALT), </span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">MOD_BIT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_LEFT_GUI), </span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">MOD_BIT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_RIGHT_GUI), </span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">MOD_BIT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_LEFT_CTRL)</span><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">MOD_BIT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_LEFT_SHIFT) }</span></span></code></pre></div><divclass="warning custom-block"><pclass="custom-block-title">WARNING</p><p>Do not use <code>MOD_xxx</code> constants like <code>MOD_LSFT</code> or <code>MOD_RALT</code>, since they're 5-bit packed bit-arrays while <code>MODS_TO_NEUTRALIZE</code> expects a list of 8-bit packed bit-arrays. Use <code>MOD_BIT(<kc>)</code> or <code>MOD_MASK_xxx</code> instead.</p></div><h3id="retro-shift"tabindex="-1">Retro Shift <aclass="header-anchor"href="#retro-shift"aria-label="Permalink to "Retro Shift""></a></h3><p><ahref="./features/auto_shift">Auto Shift,</a> has its own version of <code>retro tapping</code> called <code>retro shift</code>. It is extremely similar to <code>retro tapping</code>, but holding the key past <code>AUTO_SHIFT_TIMEOUT</code> results in the value it sends being shifted. Other configurations also affect it differently; see <ahref="./features/auto_shift#retro-shift">here</a> for more information.</p><h2id="why-do-we-include-the-key-record-for-the-per-key-functions"tabindex="-1">Why do we include the key record for the per key functions? <aclass="header-anchor"href="#why-do-we-include-the-key-record-for-the-per-key-functions"aria-label="Permalink to "Why do we include the key record for the per key functions?""></a></h2><p>One thing that you may notice is that we include the key record for all of the "per key" functions, and may be wondering why we do that.</p><p>Well, it's simple really: customization. But specifically, it depends on how your keyboard is wired up. For instance, if each row is actually using a row in the keyboard's matrix, then it may be simpler to use <code>if (record->event.key.row == 3)</code> instead of checking a whole bunch of keycodes. Which is especially good for those people using the Tap Hold type keys on the home row. So you could fine-tune those to not interfere with your normal typing.</p><h2id="why-are-there-no-kb-or-user-functions"tabindex="-1">Why are there no <code>*_kb</code> or <code>*_user</code> functions?! <aclass="header-anchor"href="#why-are-there-no-kb-or-user-functions"aria-label="Permalink to "Why are there no `*_kb` or `*_user` functions?!""></a></h2><p>Unlike many of the other functions here, there isn't a need (or even reason) to have a quantum or keyboard-level function. Only user-level functions are useful here, so no need to mark them as such.</p></div></div></main><footerclass="VPDocFooter"data-v-39a288b8data-v-09de1c0f><!--[--><!--]--><!----><navclass="prev-next"data-v-09de1c0f><divclass="pager"data-v-09de1c0f><aclass="VPLink link pager-link prev"href="/features/tap_dance"data-v-09de1c0f><!--[--><spanclass="desc"data-v-09de1c0f>Previous page</span><spanclass="title"data-v-09de1c0f>Tap Dance</span><!--]--></a></div><divclass="pager"data-v-09de1c0f><aclass="VPLink link pager-link next"href="/features/tri_layer"data-v-09de1c0f><!--[--><spanclass="desc"data-v-09de1c0f>Next pa
