(This is not an officially supported Google product.)

This repo contains my community modules for Quantum Mechanical Keyboard (QMK) firmware, used on custom keyboards like the ZSA Voyager pictured above. I use most of these modules myself in my QMK keymap.

This repo uses the Apache License 2.0 except where otherwise indicated. See the LICENSE file for details.

This repo makes use of Community Modules support added in QMK Firmware 0.28.0, released on 2025-02-27. Update your QMK set up to get the latest. If you have it, there will be a modules folder inside your qmk_firmware folder.

Step 1. Download modules. Run these shell commands to download the modules, replacing /path/to/qmk_firmware with the path of your "qmk_firmware" folder:

cd /path/to/qmk_firmware
mkdir -p modules
git submodule add https://github.com/getreuer/qmk-modules.git modules/getreuer
git submodule update --init --recursive

Or if using External Userspace, replace the first line with cd /path/to/your/external/userspace.

Or if you don't want to use git, download a .zip of this repo into the modules folder. Unzip it, then rename the resulting qmk-modules-main folder to getreuer.

In any case, the installed directory structure is like this:

<QMK_FIRMWARE or QMK_USERSPACE>
└── modules
    └── getreuer
        ├── achordion
        ├── custom_shift_keys
        ├── keycode_string
        └── ...

Step 2. Add modules to keymap.json. Add a module to your keymap by writing a file keymap.json in your keymap folder with the content

{
  "modules": ["getreuer/tap_flow"]
}

Or if a keymap.json already exists, merge the "modules" line into it. Add multiple modules like:

{
  "modules": ["getreuer/tap_flow", "getreuer/sentence_case"]
}

Follow the modules' documentation for any further specific set up.

Step 3. Update the firmware. Compile and flash the firmware as usual. If there are build errors, try running qmk clean and compiling again for a clean build.

Remove the modules from keymap.json and delete the modules/getreuer folder.