Overview

This tool lets you change settings on your ZMK keyboard in case you dont want to mess with config files. I can't vouch for it's performance on any other keyboards, but I know it works for my own.

This works by connecting directly to a GitHub fork that you make, so pretty simple

REQUIREMENTS TO START
A FORK OF THE ZMK CONFIG REPO

You have to create a fork of the ZMK repo. This tool needs to write to your repo, so it has to be yours. To do this, go to github.com/t4corun/zmk-config, click Fork in the top right, and follow the steps. That creates a copy under your GitHub account that you own.

A GITHUB PERSONAL ACCESS TOKEN

You need to generate a personal access token to connect to your fork. this site talks to GitHub directly so it should be as secure as possible, there is no backend for this site or anything. Steps:

  1. Go to github.com/settings/tokens
  2. Click Generate new token → Generate new token (classic)
  3. Give it a name like zmk-config-tool
  4. Check the repo box (that's all you need)
  5. Click Generate token at the bottom
  6. Copy the token. it starts with ghp_ ... keep in mind you only see it once

Paste it into the token field below and check "Remember token" if you don't want to do this every time. It just gets saved in your browser.

Settings
Note Per-key tap/hold settings (tapping term, hold-tap flavor, quick-tap) live in the behaviors {} block of your keymap file. Edit them directly in the keymap editor above. The settings below cover hardware-level timing that is configurable via the conf file.
Keyboard Layout
Connect to keyboard to load layout.
Build Firmware
0 CHANGES PENDING
  • ■ IDLE
  • ■ COMMITTING CHANGES
  • ■ TRIGGERING BUILD
  • ■ BUILDING
  • ■ SUCCESS
  • ■ FAILED