###
qmk
###

:date: 2026-07-05 17:43
:modified: 2026-07-05 17:43
:tags: keyboard
:category: documentation
:slug: qmk
:authors: Ms.Leave-A-Mix
:summary: QMK keyboard configuration steps


----------
Repository
----------

First of all, clone the repository containing the custom keymaps.

git clone ssh://gitea@gitea.freepoteries.fr:2222/masq/qmk_firmware.git

cd qmk_firmware

----------------
QMK installation
----------------

curl -fsSL https://install.qmk.fm | sh

qmk setup -H .

Choose the third option

---------
Keyboards
---------

...........
Keebio IRIS
...........

Keymap name : iridiology

Test compilation
................

qmk compile -kb keebio/iris/rev7 -km iridiology

Flash
.....

qmk flash -kb keebio/iris/rev7 -km iridiology

When waiting for a flashable board, either activate the bootloader mode via the keyboard, or via the switch behind the board.

You may have to flash the two parts of the keyboard one by one when changing critical parameters, or when upgrading version.

Keymap
......

The keymap is fully covered by two layers, trying to reduce finger movement while typing. The top row can be lowered by one row by altering the layer
using the modifier key "lower" (3x1). For example the "1" key located in 1x2 is moved to 2x2 while the "lower" key is kept pressed, or just after clicking
the "lower" key.