4e1c5887c5
* add docs * core changes * update keyboards to new OLED * updated users to new OLED * update layouts to new OLED * fixup docs * drashna's suggestion * fix up docs * new keyboards with oled * core split changes * remaining keyboard files * Fix The Helix keyboards oled options * reflect develop Co-authored-by: Drashna Jaelre <drashna@live.com> Co-authored-by: mtei <2170248+mtei@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| config.h | ||
| encoders.c | ||
| keymap.c | ||
| keymap.json | ||
| layers.h | ||
| readme.md | ||
| rules.mk | ||
readme.md
@pierrec83's keymap for the Kyria
A comfortable for me using 34 keys.
This keymap has evolved over a period of time from iterating as I observed pain points in my interacting with my home and work computers (MacOS and Linux. I edited many of the shortcuts in MacOS to match those in Linux for consistency).
Features
- Mouse keys with constants tuned so the keyboard usable for me as my sole pointing device
- Homerow layers activation
- Minimal unhoming of the thumbs (the one side thumb key I do use does not overlap with typing english or code)
- Minimal side-index motion thanks to workman base layer and similar principles in other layers
- Two symbol layers, both activated with one homerow key and either another key on the same hand's homerow or a key from the other hand
- Mousing around, including left and right clicking can be done either one-handed or fully on the homerow with both hands
- Easy chaining of common command line or vim patterns, such as
~/,(),ESC : w ENTERetc. - Outer pinky columns unused for ergonomic reasons
- Common OS shortcuts like switching workspaces on gnome or MacOS easily accessible (for the shortcuts I use. This may not apply to others)
Instructions to update the keymap
For now, I am still more comfortable updating the keymap through the qmk configurator as I don't trust myself to manually keep comments describing the keymap in sync with the code itself. This means that my keymap.c is generated and not really readable. For a readble view of my keymap, one must import keymap.json into qmk configurator and use the web UI or print it.
To update the keymap,
- Load keymap.json into qmk configurator
- Perform any edits
- Export the keymap. This should save a json file in
~/Downloads/pierrec83.jsonor equivalent for your OS - From the root of qmk_firmware, move the keymap to its destination:
mv ~/Downloads/pierrec83.json keyboards/kyria/keymaps/pierrec83/keymap.json
- Regenerate the
keymap.c:
qmk json2c keyboards/kyria/keymaps/pierrec83/keymap.json -o keyboards/kyria/keymaps/pierrec83/keymap.c
- Flash the firmware (for instance, if left hand is plugged):
qmk flash -kb kyria -km pierrec83 -bl dfu-split-left
Author
I am @pierrec83 on Twitter, @pierrechevalier83 on github. I chose the shorter nickname for my keymap.