<divid="app"><divclass="Layout"data-v-5d98c3a5><!--[--><!--]--><!--[--><spantabindex="-1"data-v-0f60ec36></span><ahref="#VPContent"class="VPSkipLink visually-hidden"data-v-0f60ec36> Skip to content </a><!--]--><!----><headerclass="VPNav"data-v-5d98c3a5data-v-ae24b3ad><divclass="VPNavBar has-sidebar top"data-v-ae24b3addata-v-ccf7ddec><divclass="wrapper"data-v-ccf7ddec><divclass="container"data-v-ccf7ddec><divclass="title"data-v-ccf7ddec><divclass="VPNavBarTitle has-sidebar"data-v-ccf7ddecdata-v-ab179fa1><aclass="title"href="/"data-v-ab179fa1><!--[--><!--]--><!--[--><!--[--><!--[--><imgclass="VPImage dark logo"src="/badge-community-dark.svg"altdata-v-8426fc1a><!--]--><!--[--><imgclass="VPImage light logo"src="/badge-community-light.svg"altdata-v-8426fc1a><!--]--><!--]--><!--]--><!----><!--[--><!--]--></a></div></div><divclass="content"data-v-ccf7ddec><divclass="content-body"data-v-ccf7ddec><!--[--><!--]--><divclass="VPNavBarSearch search"data-v-ccf7ddec><!--[--><!----><divid="local-search"><buttontype="button"class="DocSearch DocSearch-Button"aria-label="Search"><spanclass="DocSearch-Button-Container"><spanclass="vp-icon DocSearch-Search-Icon"></span><spanclass="DocSearch-Button-Placeholder">Search</span></span><spanclass="DocSearch-Button-Keys"><kbdclass="DocSearch-Button-Key"></kbd><kbdclass="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><navaria-labelledby="main-nav-aria-label"class="VPNavBarMenu menu"data-v-ccf7ddecdata-v-7f418b0f><spanid="main-nav-aria-label"class="visually-hidden"data-v-7f418b0f>Main Navigation</span><!--[--><!--[--><aclass="VPLink link VPNavBarMenuLink"href="./"tabindex="0"data-v-7f418b0fdata-v-9c663999><!--[--><spandata-v-9c663999>Home</span><!--]--></a><!--]--><!--]--></nav><!----><divclass="VPNavBarAppearance appearance"data-v-ccf7ddecdata-v-e6aabb21><buttonclass="VPSwitch VPSwitchAppearance"type="button"role="switch"title="Switch to dark theme"aria-checked="false"data-v-e6aabb21data-v-d1f28634data-v-1d5665e3><spanclass="check"data-v-1d5665e3><spanclass="icon"data-v-1d5665e3><!--[--><spanclass="vpi-sun sun"data-v-d1f28634></span><spanclass="vpi-moon moon"data-v-d1f28634></span><!--]--></span></span></button></div><divclass="VPSocialLinks VPNavBarSocialLinks social-links"data-v-ccf7ddecdata-v-0394ad82data-v-7bc22406><!--[--><aclass="VPSocialLink no-icon"href="https://reddit.com/r/olkb"aria-labeltarget="_blank"rel="noopener"data-v-7bc22406data-v-eee4e7cb><svgxmlns="http://www.w3.org/2000/svg"viewBox="0 0 50 50"width="50px"height="50px"><pathd="M293C28.0625327.1640633.38281326.54C25.8359384.61718825.3632815.433594256.40625C24.3554698.14062524.08593810.39453124.0312513.03125C19.23437513.17968814.82031314.42187511.2812516.46875C10.21484415.468758.85546914.968757.514.96875C6.08984414.968754.67578115.5117193.5937516.59375C1.42578118.7617191.42578122.2382813.5937524.40625L3.8437524.65625C3.312526.035156327.488281329C333.5273445.56640637.5859389.562540.4375C13.55859443.28906319.007813452545C30.9921884536.44140643.28906340.437540.4375C44.43359437.5859384733.5273444729C4727.48828146.687526.03515646.1562524.65625L46.4062524.40625C48.57421922.23828148.57421918.76171946.4062516.59375C45.32421915.51171943.91015614.9687542.514.96875C41.14453114.9687539.78515615.4687538.7187516.46875C35.19531314.43359430.80078113.19140626.0312513.03125C26.0937510.54687526.3632818.4687526.8757.09375C27.1640636.31640627.5273445.75781327.8755.4375C28.2226565.11718828.5390635295C29.460938529.6835945.12530.031255.40625C30.3789065.687530.7851566.14843831.31256.6875C32.2539067.65234433.6953138.71484436.093758.9375C36.53906311.23828138.574219134113C43.75134610.75468C465.2543.753413C38.605469336.5742194.71093836.093756.96875C34.31256.79687533.5273446.10937532.755.3125C32.3007814.85156331.8867194.312531.31253.843
<spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ALT_TAB</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> LALT</span><spanstyle="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_TAB)</span></span></code></pre></div><p>This will allow you to use <code>FN_CAPS</code> and <code>ALT_TAB</code> in your keymap, keeping it more readable.</p><h2id="my-keymap-doesn-t-update-when-i-flash-it"tabindex="-1">My Keymap Doesn't Update When I Flash It <aclass="header-anchor"href="#my-keymap-doesn-t-update-when-i-flash-it"aria-label="Permalink to "My Keymap Doesn't Update When I Flash It""></a></h2><p>This is usually due to VIA, and has to do with how it deals with keymaps.</p><p>On first run, the VIA code in the firmware will copy the keymap from flash memory into EEPROM so that it can be rewritten at runtime by the VIA app. From this point QMK will use the keymap stored in EEPROM instead of flash, and so updates to your <code>keymap.c</code> will not be reflected.</p><p>The simple fix for this is to clear the EEPROM. You can do this in several ways:</p><ul><li>Hold the Bootmagic Lite key (usually top left/Escape) while plugging the board in, which will also place the board into bootloader mode; then unplug and replug the board.</li><li>Press the <code>QK_CLEAR_EEPROM</code>/<code>EE_CLR</code> keycode if it is accessible on your keymap.</li><li>Place the board into bootloader mode and hit the "Clear EEPROM" button. This may not be available for all bootloaders, and you may need to reflash the board afterwards.</li></ul><h2id="some-of-my-keys-are-swapped-or-not-working"tabindex="-1">Some Of My Keys Are Swapped Or Not Working <aclass="header-anchor"href="#some-of-my-keys-are-swapped-or-not-working"aria-label="Permalink to "Some Of My Keys Are Swapped Or Not Working""></a></h2><p>QMK has a couple of features which allow you to change the behavior of your keyboard on the fly. This includes, but is not limited to, swapping Ctrl/Caps, disabling GUI, swapping Alt/GUI, swapping Backspace/Backslash, disabling all keys, and other behavioral modifications.</p><p>Refer to the EEPROM clearing methods above, which should return those keys to normal operation. If that doesn't work, look here:</p><ul><li><ahref="./keycodes_magic">Magic Keycodes</a></li><li><ahref="./feature_command">Command</a></li></ul><h2id="the-menu-key-isn-t-working"tabindex="-1">The Menu Key Isn't Working <aclass="header-anchor"href="#the-menu-key-isn-t-working"aria-label="Permalink to "The Menu Key Isn't Working""></a></h2><p>The key found on most modern keyboards that is located between <code>KC_RGUI</code> and <code>KC_RCTL</code> is actually called <code>KC_APP</code>. This is because when the key was invented, there was already a key named "Menu" in the HID specification, so for whatever reason, Microsoft chose to create a new key and call it "Application".</p><h2id="power-keys-aren-t-working"tabindex="-1">Power Keys Aren't Working <aclass="header-anchor"href="#power-keys-aren-t-working"aria-label="Permalink to "Power Keys Aren't Working""></a></h2><p>Somewhat confusingly, there are two "Power" keycodes in QMK: <code>KC_KB_POWER</code> in the Keyboard/Keypad HID usage page, and <code>KC_SYSTEM_POWER</code> (or <code>KC_PWR</code>) in the Consumer page.</p><p>The former is only recognized on macOS, while the latter, <code>KC_SLEP</code> and <code>KC_WAKE</code> are supported by all three major operating systems, so it is recommended to use those instead. Under Windows, these keys take effect immediately, however on macOS they must be held down until a dialog appears.</p><h2id="one-shot-modifier"tabindex="-1">One Shot Modifier <aclass="header-anchor"href="#one-shot-modifier"aria-label="Permalink to "One Shot Modifier""></a></h2><p>Solves my personal 'the' problem. I often got 'the' or 
<spanclass="line"><spanstyle="--shiki-light:#D73A49;--shiki-dark:#F97583;">#define</span><spanstyle="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> LOCKING_RESYNC_ENABLE</span></span></code></pre></div><p>After enabling this feature use keycodes <code>KC_LCAP</code>, <code>KC_LNUM</code> and <code>KC_LSCR</code> in your keymap instead.</p><p>Old vintage mechanical keyboards occasionally have lock switches but modern ones don't have. <em><strong>You don't need this feature in most case and just use keycodes <code>KC_CAPS</code>, <code>KC_NUM</code> and <code>KC_SCRL</code>.</strong></em></p><h2id="input-special-characters-other-than-ascii-like-cedille-c"tabindex="-1">Input Special Characters Other Than ASCII like Cédille 'Ç'<aclass="header-anchor"href="#input-special-characters-other-than-ascii-like-cedille-c"aria-label="Permalink to "Input Special Characters Other Than ASCII like Cédille 'Ç'""></a></h2><p>See the <ahref="./feature_unicode">Unicode</a> feature.</p><h2id="fn-key-on-macos"tabindex="-1"><code>Fn</code> Key on macOS <aclass="header-anchor"href="#fn-key-on-macos"aria-label="Permalink to "`Fn` Key on macOS""></a></h2><p>Unlike most Fn keys, the one on Apple keyboards actually has its own keycode... sort of. It takes the place of the sixth keycode in a basic 6KRO HID report -- so an Apple keyboard is in fact only 5KRO.</p><p>It is technically possible to get QMK to send this key. However, doing so requires modification of the report format to add the state of the Fn key. Even worse, it is not recognized unless the keyboard's VID and PID match that of a real Apple keyboard. The legal issues that official QMK support for this feature may create mean it is unlikely to happen.</p><p>See <ahref="https://github.com/qmk/qmk_firmware/issues/2179"target="_blank"rel="noreferrer">this issue</a> for detailed information.</p><h2id="keys-supported-in-mac-osx"tabindex="-1">Keys Supported in Mac OSX? <aclass="header-anchor"href="#keys-supported-in-mac-osx"aria-label="Permalink to "Keys Supported in Mac OSX?""></a></h2><p>You can know which keycodes are supported in OSX from this source code.</p><p><code>usb_2_adb_keymap</code> array maps Keyboard/Keypad Page usages to ADB scancodes(OSX internal keycodes).</p><p><ahref="https://opensource.apple.com/source/IOHIDFamily/IOHIDFamily-606.1.7/IOHIDFamily/Cosmo_USB2ADB.c"target="_blank"rel="noreferrer">https://opensource.apple.com/source/IOHIDFamily/IOHIDFamily-606.1.7/IOHIDFamily/Cosmo_USB2ADB.c</a></p><p>And <code>IOHIDConsumer::dispatchConsumerEvent</code> handles Consumer page usages.</p><p><ahref="https://opensource.apple.com/source/IOHIDFamily/IOHIDFamily-606.1.7/IOHIDFamily/IOHIDConsumer.cpp"target="_blank"rel="noreferrer">https://opensource.apple.com/source/IOHIDFamily/IOHIDFamily-606.1.7/IOHIDFamily/IOHIDConsumer.cpp</a></p><h2id="jis-keys-in-mac-osx"tabindex="-1">JIS Keys in Mac OSX <aclass="header-anchor"href="#jis-keys-in-mac-osx"aria-label="Permalink to "JIS Keys in Mac OSX""></a></h2><p>Japanese JIS keyboard specific keys like <code>無変換(Muhenkan)</code>, <code>変換(Henkan)</code>, <code>ひらがな(hiragana)</code> are not recognized on OSX. You can use <strong>Seil</strong> to enable those keys, try following options.</p><ul><li>Enable NFER Key on PC keyboard</li><li>Enable XFER Key on PC keyboard</li><li>Enable KATAKANA Key on PC keyboard</li></ul><p><ahref="https://pqrs.org/osx/karabiner/seil.html"target="_blank"rel="noreferrer">https://pqrs.org/osx/karabiner/seil.html</a></p><h2id="rn-42-bluetooth-doesn-t-work-with-karabiner"tabindex="-1">RN-42 Bluetooth Doesn't Work with Karabiner <aclass="header-anchor"href="#rn-42-bluetooth-doesn-t-work-with-karabiner"aria-label="Permalink to "RN-42 Bluetooth Doesn't Work with Karabiner""></a></h2><p>Karabiner - Keymapping tool on Mac OSX - ignores inputs from RN-42 module by default. You have to enable this option to make Karabiner working with your keyboard. <ahref="https://g
