Comment on page
So you've decided that you'd like to reprogram/remap your encoders to do something different? Sounds good, but be forewarned, the process can be a bit complicated.
First of all, at the moment, you won't be able to reassign the encoders using QMK Configurator. The only methods right now is through a standard QMK build environment or by using an updated version of firmware that includes encoder remapping support for VIA: VIA Firmware Upgrades.
Physically adding an encoder to a PCB that doesn't have support for it is beyond the scope of this guide. On the firmware side, if your board doesn't already support for encoders, then you will need to add that in yourself. See the Encoders section of the QMK Docs.
All Keebio boards have encoders pre-configured in QMK, so you don't need to enable support for it.
Here's some ideas on what you can use this functionality for:
- Volume control - Turn volume up or down, press to mute
- Media control - Play previous or next track
- Scrolling - Page up or down, home/end, left/right
- Window/Tab switching
- Change RGB/Backlight modes
- Regular keystroke
First, you need to make sure that you have you own keymap directory setup if you don't already have one. For example, if you have an Iris keyboard, go to
defaultto your own name/username. If you want to retain VIA functionality, then copy the
There are two methods of defining the mapping of your encoders: