You can edit a QMK keymap online with the QMK Configurator, then build and flash locally to customize the keymap according to your preference.

First, open this link to the configurator: and make any changes you like. For instance, if you use the "Pause" key to active your computer's lock screen or screen saver, you will find that it is missing on the default layout. Let's add it to Layer 5 in the position of the Enter key, so that holding B (layer 5) and pressing Enter will send the Pause key to the computer.

Select "Layer 5", then click the key in the lower right corner.

On the image of a full-size keyboard, click the Pause key.

Now the function of this key within this layer has been changed to "Pause".

Near the top of the page, click the button to download the keymap as a json file.

Import the keymap file into qmk_firmware:

cd ~/qmk_firmware/keyboards/40percentclub/gherkin
qmk import-keymap ~/Downloads/40percentclub_gherkin_layout_ortho_3x10_mine.json

This should produce output similar to:

Ψ Importing 40percentclub_gherkin_layout_ortho_3x10_mine.json.

Ψ Imported a new keymap named 40percentclub_gherkin_layout_ortho_3x10_mine.
Ψ To start working on things, `cd` into keyboards/40percentclub/gherkin/keymaps/40percentclub_gherkin_layout_ortho_3x10_mine,
Ψ or open the directory in your preferred text editor.
Ψ And build with qmk compile -kb 40percentclub/gherkin -km 40percentclub_gherkin_layout_ortho_3x10_mine.

Now let's build and flash it:

cd ~/qmk_firmware
qmk flash -e CONVERT_TO=kb2040 -kb 40percentclub/gherkin -km 40percentclub_gherkin_layout_ortho_3x10_mine

This guide was first published on Jul 26, 2022. It was last updated on Mar 08, 2024.

This page (Editing a keymap with QMK Configurator) was last updated on Mar 08, 2024.

Text editor powered by tinymce.