Keebio Documentation
  • Website
  • docs
    • 3D-Printed Case Parts Installation
    • adding-rgb-underglow
    • BAMFK-1 Build Guide
    • bdn9-build-guide
    • bdn9-rev1.3-build-guide
    • bdn9-rev2-build-guide
    • BFO-9000
    • Breeze Rev. 1.3 Build Guide
    • case-files
    • Cepstrum Hotswap
    • Chiri CE
    • choc-stabs
    • chocopad-build-guide
    • Convolution Build Guide
    • Default Keymaps
    • dfu-on-pro-micro
    • dilly-build-guide
    • Elite-Pi Usage Guide
    • VIA Firmware Upgrade Procedure
    • Flashing Firmware
    • FoldKB
    • fourier-build-guide
    • glossary
    • Switch Installation for Pre-Built Hotswap Keyboards
    • Iris Aluminum Case Build Guide
    • Iris CE
    • iris-choc-build-guide
    • Iris Keyboard
    • iris-led-fix
    • Iris LM
    • iris-middle-layer
    • iris-rev2-build-guide
    • Iris Rev. 3-5
    • Iris Rev. 6-8 Hotswap
    • Enabling Iris Rev. 6 VIA RGB Controls & Encoder Mapping
    • Iris SE
    • laplace-build-log
    • Levinson Rev. 3
    • Lighting Options
    • Build Guide Info
    • nyquist-build-guide
    • nyquist-rev3-build-guide
    • Quefrency Rev. 4-6 Hotswap Build Guide
    • quefrency-rev1-build-guide
    • Quefrency/Sinc/KBO-5000 (Solder Version)
    • Remapping/Reprogramming your Keyboard
    • Reprogramming Encoders
    • Resetting/Clearing EEPROM
    • schematics
    • Sinc Rev. 3-4 Hotswap Build Guide
    • Recommended Soldering Tools
    • Stampy Usage Guide
    • standard-for-build-guides
    • stick-build-guide
    • Tenting Bolts Setup for Acrylic Middle Layer
    • Testing Your PCB
    • troubleshooting
    • VIA and QMK Firmware
    • VIA Usage Guide
    • viterbi-rev2-build-guide
    • Waterfowl Build Guide
    • WTF60
    • faq
      • Contact Info
      • Recommended Keycaps
      • main
      • miscellaneous
      • ordering
      • Products
      • Shipping
      • Switches and Sockets
      • Technical/Build Info
Powered by GitBook
On this page
  • What is QMK?
  • Remapping Options
  • VIA Configurator
  • QMK Configurator
  • QMK Firmware Build Environment
  • Flashing Your Keyboard
  1. docs

Remapping/Reprogramming your Keyboard

PreviousQuefrency/Sinc/KBO-5000 (Solder Version)NextReprogramming Encoders

Last updated 2 years ago

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 is compatible with and are all pre-flashed with a . 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 and .

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:

    • 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

    • 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

QMK Configurator

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.

Flashing Your Keyboard

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: .

For VIA usage instructions, see .

For , see the

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 . 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.

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 for details about doing this.

VIA Firmware Upgrades
VIA Usage Guide
QMK Configurator
QMK Configurator Guide
QMK build environment
Flashing Firmware
Keebio
QMK Firmware
default QMK Firmware and keymap
QMK Firmware
QMK Configurator
QMK Toolbox
VIA Configurator
QMK Configurator