Skip to main content

Remapping/Reprogramming your Keyboard

If you'd like to change what each key on your keyboard does, this process is called remapping, as you're changing what's called a keymap on your board. There are a few ways this can be done, each with its pros and cons and also varying degree of of difficulty.

What is QMK?

First of all, every board at Keebio is compatible with QMK Firmware and are all pre-flashed with a default QMK Firmware and keymap. QMK Firmware is an open-source keyboard firmware, and most keyboards within the mechanical keyboard community use QMK. QMK also encompasses a suite of other tools, such as QMK Configurator and QMK Toolbox.

QMK Firmware has a lots of features, like supporting multiple layers, macros, Mod-Tap, mouse keys, split keyboards, backlighting, RGB, etc., which makes is a popular choice for hobbyists. There are alternative keyboard firmwares out there, but these are not officially supported by Keebio.

Remapping Options

There are 3 main options for changing your board's keymap, ordered from least difficult to most difficult to use:

  • VIA Configurator
  • QMK Configurator
  • QMK Firmware build environment

Here are some pros and cons of each method:

  • VIA Configurator
    • Pros: Easist to use, instant keymap updates, no flashing firmware required, live lighting controls, layout option controls, macro editor, can remap encoders for some boards
    • Cons: Does not support every board, limit of 4 layers
  • QMK Configurator
    • Pros: Stays up to date with QMK firmware, all boards in QMK repository are supported
    • Cons: Need to reflash board to update keymap, can't remap encoders
  • QMK Build Environment
    • Pros: Can reconfigure encoders, access to more features like tap dance
    • Cons: Can be complex to setup, involves editing code and using Git

VIA Configurator

For some older Keebio boards, the VIA firmware pre-flashed to the board does not have encoder remapping enabled, as that feature didn't originally exist. However, new VIA firmware is available now, so check here to see if an update is available for your board: VIA Firmware Upgrades.

For VIA usage instructions, see VIA Usage Guide.

QMK Configurator

For QMK Configurator, see the QMK Configurator Guide

QMK Firmware Build Environment

Setting up a QMK build environment and compiling your own firmware provides the most flexibility in terms of features and control, but it is also the most complicated of the options out there.

Note that not all features of QMK are supported by the VIA Configurator, so if you want to use more advanced features of QMK like Tap Dance, then you'll need to setup a QMK build environment. By default on most VIA-supported keyboards, there is a limit of 4 layers. This can sometimes be increased, but once again, this requires setting up a QMK build environment.

Flashing Your Keyboard

If using either QMK Configurator or a QMK Firmware build environment, you'll need to flash the generated .hex/.bin file to your keyboard. See Flashing Firmware for details about doing this.