Frequently Asked Questions
Answers to the questions we are asked most often, from browsers and cables to macros, sounds, and what to do if something goes wrong.
Which keyboards does KeyAble work with?
Keychron keyboards in ANSI and ISO layouts; Japanese JIS layouts are not supported yet. Supported Keyboards has the full list of models, and says which we have tested on real hardware; the others are built from Keychron's firmware data and should work.
Does KeyAble work with HE or Ultra 8K keyboards?
Most of them, yes. The Ultra 8K models run ZMK firmware rather than QMK, but Keychron's ZMK includes the same VIA connection KeyAble uses, so they connect like any other model. Supported Keyboards lists them. None has been tested on a real keyboard yet, so please tell us how yours goes. A few are not supported yet, such as the V2 Ultra 8K, which has two Fn layers for each system.
The HE (Hall Effect) models in Supported Keyboards work like any other: remapping, macros, lighting and backups. They are built from Keychron's released firmware, like most models. Their magnetic switches also have settings of their own, such as the actuation point and rapid trigger, which use Keychron commands KeyAble does not support yet, so set those with Keychron's Launcher. Some HE models are not supported yet, such as the Q0 HE and the HE 8K models. Keyboards KeyAble does not support can be set up with Keychron's own Launcher.
Which web browser do I need?
Use a Chromium-based browser such as Chrome, Microsoft Edge, or Brave. These browsers can talk to your keyboard directly over USB. Firefox and Safari cannot do this yet, so KeyAble will not be able to connect in them.
Can I try KeyAble without a keyboard?
Yes. In Step 1, choose Try KeyAble Without a Keyboard (Demo), then pick any model from the list. KeyAble then works with a pretend keyboard of that model, starting at its factory settings, so every step behaves as it would with the real one: remapping, macros, lighting, Review Changes, backup and reset. Nothing is written to a keyboard, and the pretend keyboard is forgotten when you disconnect or close KeyAble.
Do I have to keep the USB cable plugged in?
Yes, but only while you are making changes. Remapping needs the wired USB connection. Once your changes are saved you can unplug the cable and go back to Bluetooth or wireless. Your changes stay on the keyboard.
Will my changes still work on another computer?
Yes. Everything you set up is saved into the keyboard's own memory, not onto this computer. Plug the keyboard into any machine and your keys, macros, and lighting behave the same, as long as the OS slide switch on the back is set to the same side you made the change for. See the next question if you switch between Mac and Windows.
I use this keyboard on both a Mac and a Windows PC. What should I pick?
The keyboard stores a separate Mac layout and Windows layout, chosen by the slide switch on the back. Step 3 says which layout your changes go to, and KeyAble picks the one that matches the switch. If it cannot read the switch, it asks you to choose before your first change. To change it, use the "Choose Mac or Windows Layout" button. Your choice lasts until the keyboard disconnects: each new connection starts on the layout that matches the switch. If you move the one keyboard between a Mac and a Windows computer and want a change on both, make it once for each layout: shortcuts and System Keys use different keys on a Mac and on Windows. If a change seems to disappear, check that the slide switch matches the layout you edited.
Do I need to install anything? Is it safe?
No installation and no internet. KeyAble runs entirely in your browser and talks only to the keyboard in front of you. It has no accounts, and collects or sends no data about you, your keyboard, or how you use it.
It is a single self-contained file with no third-party code fetched from the web. It reaches your keyboard through the browser's WebHID feature, and only after you pick your keyboard from the browser's permission prompt; you can withdraw that permission at any time. Text you type into a macro, and anything your keyboard reports back, is only ever shown as plain text, never run as code, so a faulty keyboard cannot make the app do anything unintended.
I pressed Connect but my keyboard is not in the list. What now?
Check two things. One, the cable is a full USB data cable, not a charge-only cable. Two, the switch on the keyboard is set to cable or wired mode, not Bluetooth or 2.4 GHz. Then press Connect again. It can take a moment for the keyboard to appear, so keep checking the Connect button in the browser dialog.
The list can also show the 2.4 GHz wireless receiver, often named Keychron Link. That is not your keyboard, and KeyAble cannot use it. Set the switch to cable and choose the keyboard by its own name instead.
What is VIA, and do I need to turn it on?
VIA is the system KeyAble uses to read and change your keyboard's keys over USB. Keychron's QMK keyboards have it built in and always on, so there is nothing to turn on. If your keyboard connects but does not respond, check the switch is set to cable. Very old firmware may not include VIA; updating it with Keychron's own Launcher fixes that.
Can I undo a change?
Yes, in several ways. In Step 2, Reset This Key To Default Action puts a single key back, including its Fn action. In Step 1, Review Changes on This Keyboard lists every key you have changed on the current layout and lets you reset any of them, and Reset Keyboard to Default Settings resets everything. Before making big changes you can also save your setup to a file from Step 1, then restore it later if you change your mind.
What does a saved setup hold?
Every key on every layer, the knob, your macros and the lighting. On keyboards whose firmware has them, it also holds Keychron's own settings, such as debounce and the wireless sleep times, and Keychron's own lighting, such as per-key colours. A file restores onto the same keyboard model only, and only what differs is written.
If the keyboard's firmware has been updated since the file was saved, keys set to Keychron's own functions and the lighting effect are left as they are, because their numbers can change between firmware versions. Before you confirm, KeyAble says what will be left alone, and it says so again when the restore finishes.
Setups saved by KeyAble 1.3 or earlier cannot be restored by this version.
Does Reset Keyboard to Default Settings delete my macros too?
Yes. It returns every key on every layer to its factory setting and clears all macro slots. If you want to keep your macros, save your setup to a file first.
Why was I warned that a key is risky to remap?
A few keys are important for keeping control of your keyboard and your screen reader, for example Caps Lock, Escape or Tab. If you remap one of these you could lose an important shortcut until you reset. The warning just lets you stop and think; you can still continue if you are sure.
Why does KeyAble not use Caps Lock or Insert for its own shortcuts?
NVDA, JAWS, and Narrator use Caps Lock or Insert as their own modifier key, so they take the key press before the page sees it and the shortcut would never work. It is the same reason remapping Caps Lock is flagged as risky.
What does "Use with the Fn key" do?
In Step 2, once you have selected a key, there is a checkbox called "Use with the Fn key". Leave it unticked and your new action replaces what the key does on its own. Tick it and the action instead happens only when you hold Fn and press that key, for example Fn plus Home. This is handy when you have run out of spare keys: the key keeps its normal job, and the Fn combination gets the extra action. It works with the knob too, so you can set an action for Fn plus turning the knob. The checkbox applies to one change at a time: it starts unticked each time you pick a key, so tick it again whenever you want the next change to land on the Fn layer. To undo an Fn action, select the key in Step 2 and use Reset This Key To Default Action; if both its normal and its Fn action have changed, you are asked which to reset.
Can I make a key type a word, a phrase, or a sequence?
Yes. In Step 3 choose the Macro action. A macro can type text, press keys and keyboard shortcuts, use media controls and system actions, and pause between steps, all from a single key.
My macro types the wrong symbols, like @ or # or the pound sign
This happens when the layout setting does not match your computer. In the Macro panel there is a UK or US layout dropdown. Switch it to match your operating system and the symbols will type correctly. It starts on UK for ISO keyboards and US for ANSI ones.
Capture Mode says it cannot tell which way the knob turned
A knob is found by what it sends when turned. If both directions send the same thing, for example after setting both to the same action, choose Knob - Turn Clockwise or Knob - Turn Anti-clockwise from the key list instead.
How do I turn the backlight off to save battery?
Go to the RGB Lighting section, Alt plus 4, and use the Turn Backlighting Off button. On wireless keyboards this noticeably extends battery life. The same section also has brightness, colour, and effect controls if you want them.
Is there a light theme?
Yes. KeyAble follows your computer's light or dark setting. To choose for yourself, use the Dark mode button next to the KeyAble title at the top of the page; your choice is remembered.
What do the sounds mean?
A rising two-note chirp means a change worked, and a falling one means it failed. A short, rough buzz means a key or entry was not accepted, or that something is needed before you can go on, such as choosing a Mac or Windows layout. A single soft, low tone means a dialog has opened. A single higher beep means Capture Mode has started. If the keyboard is unplugged, you hear the falling chirp and KeyAble returns to Step 1.
Any tips for Narrator users?
We recommend leaving Narrator's scan mode off (Caps Lock plus Space toggles it). Scan mode takes over the arrow keys, Enter, and first-letter navigation, which can stop the lists responding as expected and can pull focus back to the previous control after a tab or button moves you to a new panel.
If Narrator reads out font and colour names, its "Hear advanced detail like text and colour formatting" setting is on. Press Caps Lock plus V to cycle verbosity levels, or choose a lower level under Verbosity in Narrator Settings.
Is this the official Keychron app?
No. KeyAble is an independent app and is not affiliated with, endorsed by, or supported by Keychron. Keychron's own tool is at launcher.keychron.com, but it is very difficult to use with a screen reader, which is why we built this.
Will it work with my keyboard? Please read this
Almost certainly, but we cannot promise it. KeyAble is a labour of love from Steven and Shaun, two Keychron fans who wanted a keyboard they could actually remap with a screen reader, built with a lot of help from AI coding tools, not a commercial product with a support department behind it. We have tested it as thoroughly as we can and confirmed several boards on real hardware, but we cannot test every model, every layout, and every computer, so please treat it as use-at-your-own-risk software.
The reassuring part: remapping keys does no lasting harm to your keyboard. If a key behaves unexpectedly, you can reset it, or all your changed keys, back to their factory settings from within the app, and there is nothing here that can physically damage the hardware. If you do run into trouble, we would genuinely like to hear about it so we can put it right.
How do I report a problem or a keyboard that is not supported?
If your keyboard connects but is not recognised, Step 1 shows a keyboard ID and a Report This Keyboard ID button. Include that ID in your report along with your keyboard model if you know it.