fix(keymap): better names for Base and NavNum layers

docs(img/readme): add example
feat(image generation): add yaml + makefile to generate images
2025-07-27 14:36:17 +02:00 · 2025-07-27 14:31:10 +02:00 · 2025-07-27 14:29:24 +02:00 · 2025-07-26 22:51:51 +02:00 · 2025-07-26 22:39:53 +02:00 · 2025-07-13 13:53:44 +02:00
10 changed files with 1934 additions and 45 deletions
--- a/README.md
+++ b/README.md
@@ -1,59 +1,76 @@
 # QMK Userspace

-This is a template repository which allows for an external set of QMK keymaps to be defined and compiled. This is useful for users who want to maintain their own keymaps without having to fork the main QMK repository.
+This is a repository which allows for an external set of QMK keymaps to be
+defined and compiled. This is useful to maintain keymaps without having to fork
+the main QMK repository.

-## Howto configure your build targets
+## Howto use it

-1. Run the normal `qmk setup` procedure if you haven't already done so -- see [QMK Docs](https://docs.qmk.fm/#/newbs) for details.
-1. Fork this repository
-1. Clone your fork to your local machine
-1. Enable userspace in QMK config using `qmk config user.overlay_dir="$(realpath qmk_userspace)"`
-1. Add a new keymap for your board using `qmk new-keymap`
-    * This will create a new keymap in the `keyboards` directory, in the same location that would normally be used in the main QMK repository. For example, if you wanted to add a keymap for the Planck, it will be created in `keyboards/planck/keymaps/<your keymap name>`
-    * You can also create a new keymap using `qmk new-keymap -kb <your_keyboard> -km <your_keymap>`
-    * Alternatively, add your keymap manually by placing it in the location specified above.
-    * `layouts/<layout name>/<your keymap name>/keymap.*` is also supported if you prefer the layout system
-1. Add your keymap(s) to the build by running `qmk userspace-add -kb <your_keyboard> -km <your_keymap>`
-    * This will automatically update your `qmk.json` file
-    * Corresponding `qmk userspace-remove -kb <your_keyboard> -km <your_keymap>` will delete it
-    * Listing the build targets can be done with `qmk userspace-list`
-1. Commit your changes
+This repository contains my somewhat unified configurations for the following
+keyboards:

-## Howto build with GitHub
+- Ferris bling 0.2
+- Atreus42 promicro
+- Xbows nature

-1. In the GitHub Actions tab, enable workflows
-1. Push your changes above to your forked GitHub repository
-1. Look at the GitHub Actions for a new actions run
-1. Wait for the actions run to complete
-1. Inspect the Releases tab on your repository for the latest firmware build
+Prerequisites:
+1. `qmk` installed in the computer
+2. Userspace configured on the computer
+    - `qmk config user.overlay_dir=$(realpath qmk_userspace)`

-## Howto build locally
+The goal of this repo is to store my custom configurations for
+`PERMISSIVE_HOLD_PER_KEY` for instance and timings for mouse emulation and so on
+to simplify further changes and synchronise the qmk configuration on different
+computers.

-1. Run the normal `qmk setup` procedure if you haven't already done so -- see [QMK Docs](https://docs.qmk.fm/#/newbs) for details.
-1. Fork this repository
-1. Clone your fork to your local machine
-1. `cd` into this repository's clone directory
-1. Set global userspace path: `qmk config user.overlay_dir="$(realpath .)"` -- you MUST be located in the cloned userspace location for this to work correctly
-    * This will be automatically detected if you've `cd`ed into your userspace repository, but the above makes your userspace available regardless of your shell location.
-1. Compile normally: `qmk compile -kb your_keyboard -km your_keymap` or `make your_keyboard:your_keymap`
+The keyboard configuration can be done on the [online
+configurator](https://config.qmk.fm/) using the [json files](./json).

-Alternatively, if you configured your build targets above, you can use `qmk userspace-compile` to build all of your userspace targets at once.
+Then, it can simply be transformed in a C file that can be used as is in the corresponding repository with:

-## Extra info
-
-If you wish to point GitHub actions to a different repository, a different branch, or even a different keymap name, you can modify `.github/workflows/build_binaries.yml` to suit your needs.
-
-To override the `build` job, you can change the following parameters to use a different QMK repository or branch:
-```
-    with:
-      qmk_repo: qmk/qmk_firmware
-      qmk_ref: master
+```sh
+qmk json2c <json file location> > keymap.c
 ```

-If you wish to manually manage `qmk_firmware` using git within the userspace repository, you can add `qmk_firmware` as a submodule in the userspace directory instead. GitHub Actions will automatically use the submodule at the pinned revision if it exists, otherwise it will use the default latest revision of `qmk_firmware` from the main repository.
+Finally, to flash the firmware:
+```sh
+qmk flash -kb <keyboard type> -km custom
+```

-This can also be used to control which fork is used, though only upstream `qmk_firmware` will have support for external userspace until other manufacturers update their forks.

-1. (First time only) `git submodule add https://github.com/qmk/qmk_firmware.git`
-1. (To update) `git submodule update --init --recursive`
-1. Commit your changes to your userspace repository
+## Description of the layers
+
+The main configuration relies on a 34 keys keyboard, let’s say the ferris, as a
+base with GASC homerow mods.
+
+The base layer looks like this:
+
+![Base Layer](./img/Layer-0.svg)
+
+`PERMISSIVE_HOLD` is disabled on home row keys to avoid false positive on rolls,
+and enabled for thumb keys as there are few false positives in this case.
+
+The internal thumb keys move to the nav/numpad layer on hold or space/tap on
+tap. This layer is the following:
+
+![Num-Nav Layer](./img/Layer-1.svg)
+
+Finally, holding both internal thumb keys (or holding left external one) leads to the
+function/mouse nav layer:
+
+![Fun-Mouse Layer](./img/Layer-2.svg)
+
+This layer also allows accessing custom layers, such as here layer 3 that is the
+`qwerty-ergol` compatibility layer or the layer 4 which is a gaming layer (not
+described here).
+
+When I’m using multiple xkeyboard layouts, my shortcut to switch between them is
+double shifts, that’s why there is also a binding for that (and why it’s the
+only one that is symmetrically correct in the homerow mods in the base layer).
+
+The illustrations were made using
+[keymap-drawer](https://github.com/caksoylar/keymap-drawer/tree/main).
+
+## Left to do
+
+- [ ] Automatize the firmware generations
--- a/img/Layer-0.svg
+++ b/img/Layer-0.svg
@@ -0,0 +1,298 @@
+<svg width="732" height="455" viewBox="0 0 732 455" class="keymap" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<style>/* inherit to force styles through use tags */
+svg path {
+    fill: inherit;
+}
+
+/* font and background color specifications */
+svg.keymap {
+    font-family: SFMono-Regular,Consolas,Liberation Mono,Menlo,monospace;
+    font-size: 14px;
+    font-kerning: normal;
+    text-rendering: optimizeLegibility;
+    fill: #24292e;
+}
+
+/* default key styling */
+rect.key {
+    fill: #f6f8fa;
+}
+
+rect.key, rect.combo {
+    stroke: #c9cccf;
+    stroke-width: 1;
+}
+
+/* default key side styling, only used is draw_key_sides is set */
+rect.side {
+    filter: brightness(90%);
+}
+
+/* color accent for combo boxes */
+rect.combo, rect.combo-separate {
+    fill: #cdf;
+}
+
+/* color accent for held keys */
+rect.held, rect.combo.held {
+    fill: #fdd;
+}
+
+/* color accent for ghost (optional) keys */
+rect.ghost, rect.combo.ghost {
+    stroke-dasharray: 4, 4;
+    stroke-width: 2;
+}
+
+text {
+    text-anchor: middle;
+    dominant-baseline: middle;
+}
+
+/* styling for layer labels */
+text.label {
+    font-weight: bold;
+    text-anchor: start;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for optional footer */
+text.footer {
+    text-anchor: end;
+    dominant-baseline: auto;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for combo tap, and key non-tap label text */
+text.combo, text.hold, text.shifted, text.left, text.right {
+    font-size: 11px;
+}
+
+text.hold {
+    text-anchor: middle;
+    dominant-baseline: auto;
+}
+
+text.shifted {
+    text-anchor: middle;
+    dominant-baseline: hanging;
+}
+
+text.left {
+    text-anchor: start;
+}
+
+text.right {
+    text-anchor: end;
+}
+
+text.layer-activator {
+    text-decoration: underline;
+}
+
+/* styling for hold/shifted label text in combo box */
+text.combo.hold, text.combo.shifted, text.combo.left, text.combo.right {
+    font-size: 8px;
+}
+
+/* lighter symbol for transparent keys */
+text.trans {
+    fill: #7b7e81;
+}
+
+/* styling for combo dendrons */
+path.combo {
+    stroke-width: 1;
+    stroke: gray;
+    fill: none;
+}
+
+/* Start Tabler Icons Cleanup */
+/* cannot use height/width with glyphs */
+.icon-tabler > path {
+    fill: inherit;
+    stroke: inherit;
+    stroke-width: 2;
+}
+/* hide tabler's default box */
+.icon-tabler > path[stroke="none"][fill="none"] {
+    visibility: hidden;
+}
+/* End Tabler Icons Cleanup */
+</style>
+<g transform="translate(30, 0)" class="layer-Base">
+<text x="0" y="28" class="label" id="Base">Base:</text>
+<g transform="translate(0, 56)">
+<g transform="translate(28, 81)" class="key keypos-0">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Q</text>
+</g>
+<g transform="translate(84, 46)" class="key keypos-1">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">W</text>
+</g>
+<g transform="translate(140, 28)" class="key keypos-2">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">E</text>
+</g>
+<g transform="translate(196, 44)" class="key keypos-3">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">R</text>
+</g>
+<g transform="translate(252, 52)" class="key keypos-4">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">T</text>
+</g>
+<g transform="translate(420, 52)" class="key keypos-5">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Y</text>
+</g>
+<g transform="translate(476, 44)" class="key keypos-6">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">U</text>
+</g>
+<g transform="translate(532, 28)" class="key keypos-7">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">I</text>
+</g>
+<g transform="translate(588, 46)" class="key keypos-8">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">O</text>
+</g>
+<g transform="translate(644, 81)" class="key keypos-9">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">P</text>
+</g>
+<g transform="translate(28, 137)" class="key keypos-10">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">A</text>
+<text x="0" y="24" class="key hold">Gui</text>
+</g>
+<g transform="translate(84, 102)" class="key keypos-11">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">S</text>
+<text x="0" y="24" class="key hold">Alt</text>
+</g>
+<g transform="translate(140, 84)" class="key keypos-12">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">D</text>
+<text x="0" y="24" class="key hold">LShift</text>
+</g>
+<g transform="translate(196, 100)" class="key keypos-13">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F</text>
+<text x="0" y="24" class="key hold">Ctrl</text>
+</g>
+<g transform="translate(252, 108)" class="key keypos-14">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">G</text>
+</g>
+<g transform="translate(420, 108)" class="key keypos-15">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">H</text>
+</g>
+<g transform="translate(476, 100)" class="key keypos-16">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">J</text>
+<text x="0" y="24" class="key hold">Ctrl</text>
+</g>
+<g transform="translate(532, 84)" class="key keypos-17">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">K</text>
+<text x="0" y="24" class="key hold">RShift</text>
+</g>
+<g transform="translate(588, 102)" class="key keypos-18">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">L</text>
+<text x="0" y="24" class="key hold">Alt</text>
+</g>
+<g transform="translate(644, 137)" class="key keypos-19">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">;</text>
+<text x="0" y="24" class="key hold">Gui</text>
+</g>
+<g transform="translate(28, 193)" class="key keypos-20">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Z</text>
+</g>
+<g transform="translate(84, 158)" class="key keypos-21">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">X</text>
+</g>
+<g transform="translate(140, 140)" class="key keypos-22">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">C</text>
+</g>
+<g transform="translate(196, 156)" class="key keypos-23">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">V</text>
+</g>
+<g transform="translate(252, 164)" class="key keypos-24">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">B</text>
+</g>
+<g transform="translate(420, 164)" class="key keypos-25">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">N</text>
+</g>
+<g transform="translate(476, 156)" class="key keypos-26">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">M</text>
+</g>
+<g transform="translate(532, 140)" class="key keypos-27">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">,</text>
+</g>
+<g transform="translate(588, 158)" class="key keypos-28">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">.</text>
+</g>
+<g transform="translate(644, 193)" class="key keypos-29">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">/</text>
+</g>
+<g transform="translate(221, 221) rotate(15.0)" class="key keypos-30">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Space</text>
+<text x="0" y="24" class="key hold">NavNum</text>
+</g>
+<g transform="translate(279, 245) rotate(30.0)" class="key keypos-31">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Enter</text>
+<text x="0" y="24" class="key hold"><tspan style="font-size: 88%">FunMouse</tspan></text>
+</g>
+<g transform="translate(393, 245) rotate(-30.0)" class="key keypos-32">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Esc</text>
+<text x="0" y="24" class="key hold">AltGr</text>
+</g>
+<g transform="translate(451, 221) rotate(-15.0)" class="key keypos-33">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Tab</text>
+<text x="0" y="24" class="key hold">NavNum</text>
+</g>
+<g class="combo combopos-0">
+<path d="M336,197 h-109 a6.0,6.0 0 0 0 -6.0,6.0 v-1" class="combo"/>
+<path d="M336,197 h109 a6.0,6.0 0 0 1 6.0,6.0 v-1" class="combo"/>
+<rect rx="6" ry="6" x="311" y="184" width="50" height="26" class="combo"/>
+<text x="336" y="197" class="combo tap"><tspan style="font-size: 88%">FunMouse</tspan></text>
+</g>
+<g class="combo combopos-1">
+<path d="M365,330 h-80 a6.0,6.0 0 0 1 -6.0,-6.0 v-60" class="combo"/>
+<path d="M365,330 h80 a6.0,6.0 0 0 0 6.0,-6.0 v-84" class="combo"/>
+<rect rx="6" ry="6" x="340" y="317" width="50" height="26" class="combo"/>
+<text x="365" y="330" class="combo tap">Compose</text>
+</g>
+<g class="combo combopos-2">
+<path d="M307,302 h-80 a6.0,6.0 0 0 1 -6.0,-6.0 v-56" class="combo"/>
+<path d="M307,302 h80 a6.0,6.0 0 0 0 6.0,-6.0 v-32" class="combo"/>
+<rect rx="6" ry="6" x="282" y="289" width="50" height="26" class="combo"/>
+<text x="307" y="302" class="combo tap">Compose</text>
+</g>
+</g>
+</g>
+</svg>
--- a/img/Layer-1.svg
+++ b/img/Layer-1.svg
@@ -0,0 +1,274 @@
+<svg width="732" height="395" viewBox="0 0 732 395" class="keymap" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<style>/* inherit to force styles through use tags */
+svg path {
+    fill: inherit;
+}
+
+/* font and background color specifications */
+svg.keymap {
+    font-family: SFMono-Regular,Consolas,Liberation Mono,Menlo,monospace;
+    font-size: 14px;
+    font-kerning: normal;
+    text-rendering: optimizeLegibility;
+    fill: #24292e;
+}
+
+/* default key styling */
+rect.key {
+    fill: #f6f8fa;
+}
+
+rect.key, rect.combo {
+    stroke: #c9cccf;
+    stroke-width: 1;
+}
+
+/* default key side styling, only used is draw_key_sides is set */
+rect.side {
+    filter: brightness(90%);
+}
+
+/* color accent for combo boxes */
+rect.combo, rect.combo-separate {
+    fill: #cdf;
+}
+
+/* color accent for held keys */
+rect.held, rect.combo.held {
+    fill: #fdd;
+}
+
+/* color accent for ghost (optional) keys */
+rect.ghost, rect.combo.ghost {
+    stroke-dasharray: 4, 4;
+    stroke-width: 2;
+}
+
+text {
+    text-anchor: middle;
+    dominant-baseline: middle;
+}
+
+/* styling for layer labels */
+text.label {
+    font-weight: bold;
+    text-anchor: start;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for optional footer */
+text.footer {
+    text-anchor: end;
+    dominant-baseline: auto;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for combo tap, and key non-tap label text */
+text.combo, text.hold, text.shifted, text.left, text.right {
+    font-size: 11px;
+}
+
+text.hold {
+    text-anchor: middle;
+    dominant-baseline: auto;
+}
+
+text.shifted {
+    text-anchor: middle;
+    dominant-baseline: hanging;
+}
+
+text.left {
+    text-anchor: start;
+}
+
+text.right {
+    text-anchor: end;
+}
+
+text.layer-activator {
+    text-decoration: underline;
+}
+
+/* styling for hold/shifted label text in combo box */
+text.combo.hold, text.combo.shifted, text.combo.left, text.combo.right {
+    font-size: 8px;
+}
+
+/* lighter symbol for transparent keys */
+text.trans {
+    fill: #7b7e81;
+}
+
+/* styling for combo dendrons */
+path.combo {
+    stroke-width: 1;
+    stroke: gray;
+    fill: none;
+}
+
+/* Start Tabler Icons Cleanup */
+/* cannot use height/width with glyphs */
+.icon-tabler > path {
+    fill: inherit;
+    stroke: inherit;
+    stroke-width: 2;
+}
+/* hide tabler's default box */
+.icon-tabler > path[stroke="none"][fill="none"] {
+    visibility: hidden;
+}
+/* End Tabler Icons Cleanup */
+</style>
+<g transform="translate(30, 0)" class="layer-NavNum">
+<text x="0" y="28" class="label" id="NavNum">NavNum:</text>
+<g transform="translate(0, 56)">
+<g transform="translate(28, 81)" class="key keypos-0">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">/</text>
+</g>
+<g transform="translate(84, 46)" class="key keypos-1">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">7</text>
+</g>
+<g transform="translate(140, 28)" class="key keypos-2">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">8</text>
+</g>
+<g transform="translate(196, 44)" class="key keypos-3">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">9</text>
+</g>
+<g transform="translate(252, 52)" class="key keypos-4">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">`</text>
+</g>
+<g transform="translate(420, 52)" class="key keypos-5">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Home</text>
+</g>
+<g transform="translate(476, 44)" class="key keypos-6">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">Page</tspan><tspan x="0" dy="1.2em">Down</tspan>
+</text>
+</g>
+<g transform="translate(532, 28)" class="key keypos-7">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">Page</tspan><tspan x="0" dy="1.2em">Up</tspan>
+</text>
+</g>
+<g transform="translate(588, 46)" class="key keypos-8">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">End</text>
+</g>
+<g transform="translate(644, 81)" class="key keypos-9">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">Print</tspan><tspan x="0" dy="1.2em">Screen</tspan>
+</text>
+</g>
+<g transform="translate(28, 137)" class="key keypos-10">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">:</text>
+</g>
+<g transform="translate(84, 102)" class="key keypos-11">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">4</text>
+</g>
+<g transform="translate(140, 84)" class="key keypos-12">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">5</text>
+</g>
+<g transform="translate(196, 100)" class="key keypos-13">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">6</text>
+</g>
+<g transform="translate(252, 108)" class="key keypos-14">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">0</text>
+</g>
+<g transform="translate(420, 108)" class="key keypos-15">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">←</text>
+</g>
+<g transform="translate(476, 100)" class="key keypos-16">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">↓</text>
+</g>
+<g transform="translate(532, 84)" class="key keypos-17">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">↑</text>
+</g>
+<g transform="translate(588, 102)" class="key keypos-18">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">→</text>
+</g>
+<g transform="translate(644, 137)" class="key keypos-19">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Back</text>
+</g>
+<g transform="translate(28, 193)" class="key keypos-20">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">,</text>
+</g>
+<g transform="translate(84, 158)" class="key keypos-21">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">1</text>
+</g>
+<g transform="translate(140, 140)" class="key keypos-22">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">2</text>
+</g>
+<g transform="translate(196, 156)" class="key keypos-23">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">3</text>
+</g>
+<g transform="translate(252, 164)" class="key keypos-24">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">.</text>
+</g>
+<g transform="translate(420, 164)" class="key keypos-25">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Play</text>
+</g>
+<g transform="translate(476, 156)" class="key keypos-26">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">Vol</tspan><tspan x="0" dy="1.2em">Down</tspan>
+</text>
+</g>
+<g transform="translate(532, 140)" class="key keypos-27">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">Vol</tspan><tspan x="0" dy="1.2em">Up</tspan>
+</text>
+</g>
+<g transform="translate(588, 158)" class="key keypos-28">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Mute</text>
+</g>
+<g transform="translate(644, 193)" class="key keypos-29">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Del</text>
+</g>
+<g transform="translate(221, 221) rotate(15.0)" class="key keypos-30">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(279, 245) rotate(30.0)" class="key keypos-31">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(393, 245) rotate(-30.0)" class="key keypos-32">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(451, 221) rotate(-15.0)" class="key keypos-33">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+</g>
+</g>
+</svg>
--- a/img/Layer-2.svg
+++ b/img/Layer-2.svg
@@ -0,0 +1,291 @@
+<svg width="732" height="395" viewBox="0 0 732 395" class="keymap" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<style>/* inherit to force styles through use tags */
+svg path {
+    fill: inherit;
+}
+
+/* font and background color specifications */
+svg.keymap {
+    font-family: SFMono-Regular,Consolas,Liberation Mono,Menlo,monospace;
+    font-size: 14px;
+    font-kerning: normal;
+    text-rendering: optimizeLegibility;
+    fill: #24292e;
+}
+
+/* default key styling */
+rect.key {
+    fill: #f6f8fa;
+}
+
+rect.key, rect.combo {
+    stroke: #c9cccf;
+    stroke-width: 1;
+}
+
+/* default key side styling, only used is draw_key_sides is set */
+rect.side {
+    filter: brightness(90%);
+}
+
+/* color accent for combo boxes */
+rect.combo, rect.combo-separate {
+    fill: #cdf;
+}
+
+/* color accent for held keys */
+rect.held, rect.combo.held {
+    fill: #fdd;
+}
+
+/* color accent for ghost (optional) keys */
+rect.ghost, rect.combo.ghost {
+    stroke-dasharray: 4, 4;
+    stroke-width: 2;
+}
+
+text {
+    text-anchor: middle;
+    dominant-baseline: middle;
+}
+
+/* styling for layer labels */
+text.label {
+    font-weight: bold;
+    text-anchor: start;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for optional footer */
+text.footer {
+    text-anchor: end;
+    dominant-baseline: auto;
+    stroke: white;
+    stroke-width: 4;
+    paint-order: stroke;
+}
+
+/* styling for combo tap, and key non-tap label text */
+text.combo, text.hold, text.shifted, text.left, text.right {
+    font-size: 11px;
+}
+
+text.hold {
+    text-anchor: middle;
+    dominant-baseline: auto;
+}
+
+text.shifted {
+    text-anchor: middle;
+    dominant-baseline: hanging;
+}
+
+text.left {
+    text-anchor: start;
+}
+
+text.right {
+    text-anchor: end;
+}
+
+text.layer-activator {
+    text-decoration: underline;
+}
+
+/* styling for hold/shifted label text in combo box */
+text.combo.hold, text.combo.shifted, text.combo.left, text.combo.right {
+    font-size: 8px;
+}
+
+/* lighter symbol for transparent keys */
+text.trans {
+    fill: #7b7e81;
+}
+
+/* styling for combo dendrons */
+path.combo {
+    stroke-width: 1;
+    stroke: gray;
+    fill: none;
+}
+
+/* Start Tabler Icons Cleanup */
+/* cannot use height/width with glyphs */
+.icon-tabler > path {
+    fill: inherit;
+    stroke: inherit;
+    stroke-width: 2;
+}
+/* hide tabler's default box */
+.icon-tabler > path[stroke="none"][fill="none"] {
+    visibility: hidden;
+}
+/* End Tabler Icons Cleanup */
+</style>
+<g transform="translate(30, 0)" class="layer-FunMouse">
+<text x="0" y="28" class="label" id="FunMouse">FunMouse:</text>
+<g transform="translate(0, 56)">
+<g transform="translate(28, 81)" class="key keypos-0">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F5</text>
+</g>
+<g transform="translate(84, 46)" class="key keypos-1">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F6</text>
+</g>
+<g transform="translate(140, 28)" class="key keypos-2">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F7</text>
+</g>
+<g transform="translate(196, 44)" class="key keypos-3">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F8</text>
+</g>
+<g transform="translate(252, 52)" class="key keypos-4">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-1.2em">LSFT</tspan><tspan x="0" dy="1.2em">+</tspan><tspan x="0" dy="1.2em">RSFT</tspan>
+</text>
+</g>
+<g transform="translate(420, 52)" class="key keypos-5">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">PWR</text>
+</g>
+<g transform="translate(476, 44)" class="key keypos-6">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">SLEP</text>
+</g>
+<g transform="translate(532, 28)" class="key keypos-7">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">WAKE</text>
+</g>
+<g transform="translate(588, 46)" class="key keypos-8">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Base</text>
+<text x="0" y="24" class="key hold">toggle</text>
+</g>
+<g transform="translate(644, 81)" class="key keypos-9">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">WHLU</tspan>
+</text>
+</g>
+<g transform="translate(28, 137)" class="key keypos-10">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F1</text>
+</g>
+<g transform="translate(84, 102)" class="key keypos-11">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F2</text>
+</g>
+<g transform="translate(140, 84)" class="key keypos-12">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F3</text>
+</g>
+<g transform="translate(196, 100)" class="key keypos-13">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F4</text>
+</g>
+<g transform="translate(252, 108)" class="key keypos-14">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Compat</text>
+<text x="0" y="24" class="key hold">toggle</text>
+</g>
+<g transform="translate(420, 108)" class="key keypos-15">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">LEFT</tspan>
+</text>
+</g>
+<g transform="translate(476, 100)" class="key keypos-16">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">DOWN</tspan>
+</text>
+</g>
+<g transform="translate(532, 84)" class="key keypos-17">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">UP</tspan>
+</text>
+</g>
+<g transform="translate(588, 102)" class="key keypos-18">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">RGHT</tspan>
+</text>
+</g>
+<g transform="translate(644, 137)" class="key keypos-19">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">WHLD</tspan>
+</text>
+</g>
+<g transform="translate(28, 193)" class="key keypos-20">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F9</text>
+</g>
+<g transform="translate(84, 158)" class="key keypos-21">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F10</text>
+</g>
+<g transform="translate(140, 140)" class="key keypos-22">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F11</text>
+</g>
+<g transform="translate(196, 156)" class="key keypos-23">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">F12</text>
+</g>
+<g transform="translate(252, 164)" class="key keypos-24">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">Gaming</text>
+<text x="0" y="24" class="key hold">toggle</text>
+</g>
+<g transform="translate(420, 164)" class="key keypos-25">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">BTN4</tspan>
+</text>
+</g>
+<g transform="translate(476, 156)" class="key keypos-26">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">BTN1</tspan>
+</text>
+</g>
+<g transform="translate(532, 140)" class="key keypos-27">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">BTN3</tspan>
+</text>
+</g>
+<g transform="translate(588, 158)" class="key keypos-28">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">BTN2</tspan>
+</text>
+</g>
+<g transform="translate(644, 193)" class="key keypos-29">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+<text x="0" y="0" class="key tap">
+<tspan x="0" dy="-0.6em">MS</tspan><tspan x="0" dy="1.2em">BTN5</tspan>
+</text>
+</g>
+<g transform="translate(221, 221) rotate(15.0)" class="key keypos-30">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(279, 245) rotate(30.0)" class="key keypos-31">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(393, 245) rotate(-30.0)" class="key keypos-32">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+<g transform="translate(451, 221) rotate(-15.0)" class="key keypos-33">
+<rect rx="6" ry="6" x="-26" y="-26" width="52" height="52" class="key"/>
+</g>
+</g>
+</g>
+</svg>
--- a/img/Makefile
+++ b/img/Makefile
@@ -0,0 +1,16 @@
+all: Layer-0.svg Layer-1.svg Layer-2.svg
+
+.venv:
+	uv venv
+
+.venv/bin/keymap: .venv
+	uv pip install keymap-drawer
+
+Layer-0.svg: keymap.yaml .venv/bin/keymap
+	uv run keymap draw keymap.yaml -s Base > $@
+
+Layer-1.svg: keymap.yaml .venv/bin/keymap
+	uv run keymap draw keymap.yaml -s NavNum > $@
+
+Layer-2.svg: keymap.yaml .venv/bin/keymap
+	uv run keymap draw keymap.yaml -s FunMouse > $@
--- a/img/keymap.yaml
+++ b/img/keymap.yaml
@@ -0,0 +1,66 @@
+layout: {qmk_keyboard: ferris/0_2/bling, layout_name: LAYOUT_split_3x5_2}
+layers:
+  Base:
+  - [Q, W, E, R, T, Y, U, I, O, P]
+  - - {t: A, h: Gui}
+    - {t: S, h: Alt}
+    - {t: D, h: LShift}
+    - {t: F, h: Ctrl}
+    - G
+    - H
+    - {t: J, h: Ctrl}
+    - {t: K, h: RShift}
+    - {t: L, h: Alt}
+    - {t: ;, h: Gui}
+  - [Z, X, C, V, B, N, M, ',', ., /]
+  - - {t: Space, h: NavNum}
+    - {t: Enter, h: FunMouse}
+    - {t: Esc, h: AltGr}
+    - {t: Tab, h: NavNum}
+  NavNum:
+  - ['/', '7', '8', '9', '`', Home, Page Down, Page Up, End, Print Screen]
+  - [':', '4', '5', '6', '0', '←', '↓', '↑', '→', Back]
+  - [',', '1', '2', '3', '.', Play, Vol Down, Vol Up, Mute, Del]
+  - - ''
+    - ''
+    - ''
+    - ''
+  FunMouse:
+  - - F5
+    - F6
+    - F7
+    - F8
+    - LSFT + RSFT
+    - PWR
+    - SLEP
+    - WAKE
+    - {t: Base, h: toggle}
+    - MS WHLU
+  - - F1
+    - F2
+    - F3
+    - F4
+    - {t: Compat, h: toggle}
+    - MS LEFT
+    - MS DOWN
+    - MS UP
+    - MS RGHT
+    - MS WHLD
+  - - F9
+    - F10
+    - F11
+    - F12
+    - {t: Gaming, h: toggle}
+    - MS BTN4
+    - MS BTN1
+    - MS BTN3
+    - MS BTN2
+    - MS BTN5
+  - - ''
+    - ''
+    - ''
+    - ''
+combos:
+  - { p: [30, 33], k: FunMouse, l: [Base], a: "top", w: 50, o: -.1}
+  - { p: [31, 33], k: Compose, l: [Base] , a: "bottom", o: 1., w: 50}
+  - { p: [30, 32], k: Compose, l: [Base] , a: "bottom", o: .5, w: 50}
--- a/img/readme.md
+++ b/img/readme.md
@@ -0,0 +1,18 @@
+# Keymap image generation
+
+## Prerequisites
+
+- `uv` to manage python package
+- `make`
+
+## How to generate images
+
+`make` will locally install
+[`keymap-drawer`](https://github.com/caksoylar/keymap-drawer)
+in `.venv` using `uv` and compile the different layers in separate files.
+
+## Example result
+
+The base layer output:
+
+![Base layer](./Layer-0.svg)
--- a/json/atreus.json
+++ b/json/atreus.json
@@ -0,0 +1,231 @@
+{
+  "version": 1,
+  "notes": "",
+  "documentation": "\"This file is a QMK Configurator export. You can import this at <https://config.qmk.fm>. It can also be used directly with QMK's source code.\n\nTo setup your QMK environment check out the tutorial: <https://docs.qmk.fm/#/newbs>\n\nYou can convert this file to a keymap.c using this command: `qmk json2c {keymap}`\n\nYou can compile this keymap using this command: `qmk compile {keymap}`\"\n",
+  "keyboard": "atreus/promicro",
+  "keymap": "atreus_promicro_layout_pcb_up_mine",
+  "layout": "LAYOUT_pcb_up",
+  "layers": [
+    [
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_P",
+      "LGUI_T(KC_A)",
+      "LALT_T(KC_S)",
+      "LSFT_T(KC_D)",
+      "LCTL_T(KC_F)",
+      "KC_G",
+      "KC_H",
+      "LCTL_T(KC_J)",
+      "LSFT_T(KC_K)",
+      "LALT_T(KC_L)",
+      "LGUI_T(KC_SCLN)",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_V",
+      "KC_B",
+      "KC_N",
+      "KC_M",
+      "KC_COMM",
+      "KC_DOT",
+      "KC_SLSH",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "LT(1,KC_SPC)",
+      "LT(2,KC_ENT)",
+      "KC_NO",
+      "KC_NO",
+      "RALT_T(KC_ESC)",
+      "LT(1,KC_TAB)",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO"
+    ],
+    [
+      "KC_PSLS",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_GRV",
+      "KC_HOME",
+      "KC_PGDN",
+      "KC_PGUP",
+      "KC_END",
+      "KC_PSCR",
+      "LSFT(KC_N)",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_0",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT",
+      "KC_BSPC",
+      "KC_DOT",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_N",
+      "KC_MPLY",
+      "KC_VOLD",
+      "KC_VOLU",
+      "KC_MUTE",
+      "KC_DEL",
+      "TG(2)",
+      "KC_INS",
+      "KC_LGUI",
+      "OSL(2)",
+      "KC_NUBS",
+      "KC_LSFT",
+      "KC_TRNS",
+      "KC_NUBS",
+      "OSL(2)",
+      "KC_DOT",
+      "KC_0",
+      "KC_EQL"
+    ],
+    [
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "LCTL(KC_RCTL)",
+      "KC_PWR",
+      "KC_SLEP",
+      "KC_WAKE",
+      "TO(0)",
+      "MS_WHLU",
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "TO(3)",
+      "MS_LEFT",
+      "MS_DOWN",
+      "MS_UP",
+      "MS_RGHT",
+      "MS_WHLD",
+      "KC_F9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "TO(4)",
+      "MS_BTN4",
+      "MS_BTN1",
+      "MS_BTN3",
+      "MS_BTN2",
+      "MS_BTN5",
+      "QK_BOOT",
+      "KC_VOLD",
+      "KC_LGUI",
+      "KC_TRNS",
+      "KC_NO",
+      "KC_NO",
+      "TO(0)",
+      "KC_NO",
+      "KC_NO",
+      "KC_PSCR",
+      "KC_SCRL",
+      "KC_PAUS"
+    ],
+    [
+      "KC_Q",
+      "KC_C",
+      "KC_O",
+      "KC_P",
+      "KC_W",
+      "KC_J",
+      "KC_M",
+      "KC_D",
+      "TO(0)",
+      "KC_Y",
+      "KC_A",
+      "KC_S",
+      "KC_E",
+      "KC_N",
+      "KC_F",
+      "KC_L",
+      "KC_R",
+      "KC_T",
+      "KC_I",
+      "KC_U",
+      "KC_Z",
+      "KC_X",
+      "KC_MINS",
+      "KC_V",
+      "KC_B",
+      "KC_DOT",
+      "KC_H",
+      "KC_G",
+      "KC_COMM",
+      "KC_K",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "LT(1,KC_SPC)",
+      "LSFT_T(KC_ENT)",
+      "LSFT_T(KC_ENT)",
+      "RALT_T(KC_ESC)",
+      "RALT_T(KC_ESC)",
+      "LT(1,KC_TAB)",
+      "KC_NO",
+      "KC_NO",
+      "TO(0)"
+    ],
+    [
+      "KC_ESC",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_TAB",
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_LSFT",
+      "KC_A",
+      "KC_S",
+      "KC_D",
+      "KC_F",
+      "KC_G",
+      "KC_H",
+      "KC_J",
+      "KC_K",
+      "KC_L",
+      "KC_LCTL",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_SPC",
+      "LALT_T(KC_ENT)",
+      "KC_M",
+      "KC_V",
+      "KC_B",
+      "KC_N",
+      "KC_P",
+      "TO(0)"
+    ]
+  ],
+  "author": ""
+}
--- a/json/ferris.json
+++ b/json/ferris.json
@@ -0,0 +1,227 @@
+{
+  "version": 1,
+  "notes": "",
+  "documentation": "\"This file is a QMK Configurator export. You can import this at <https://config.qmk.fm>. It can also be used directly with QMK's source code.\n\nTo setup your QMK environment check out the tutorial: <https://docs.qmk.fm/#/newbs>\n\nYou can convert this file to a keymap.c using this command: `qmk json2c {keymap}`\n\nYou can compile this keymap using this command: `qmk compile {keymap}`\"\n",
+  "keyboard": "ferris/0_2/bling",
+  "keymap": "ferris_0_2_bling_ferris_0_2_bling_layout_split_3x5_2_mine",
+  "layout": "LAYOUT_split_3x5_2",
+  "layers": [
+    [
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_P",
+      "LGUI_T(KC_A)",
+      "LALT_T(KC_S)",
+      "LSFT_T(KC_D)",
+      "LCTL_T(KC_F)",
+      "KC_G",
+      "KC_H",
+      "LCTL_T(KC_J)",
+      "RSFT_T(KC_K)",
+      "LALT_T(KC_L)",
+      "LGUI_T(KC_SCLN)",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_V",
+      "KC_B",
+      "KC_N",
+      "KC_M",
+      "KC_COMM",
+      "KC_DOT",
+      "KC_SLSH",
+      "LT(1,KC_SPC)",
+      "LT(2,KC_ENT)",
+      "RALT_T(KC_ESC)",
+      "LT(1,KC_TAB)"
+    ],
+    [
+      "KC_PSLS",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_GRV",
+      "KC_HOME",
+      "KC_PGDN",
+      "KC_PGUP",
+      "KC_END",
+      "KC_PSCR",
+      "LSFT(KC_N)",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_0",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT",
+      "KC_BSPC",
+      "KC_DOT",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_N",
+      "KC_MPLY",
+      "KC_VOLD",
+      "KC_VOLU",
+      "KC_MUTE",
+      "KC_DEL",
+      "OSL(2)",
+      "KC_NUBS",
+      "KC_NUBS",
+      "OSL(2)"
+    ],
+    [
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "OS_LCTL",
+      "KC_PWR",
+      "KC_SLEP",
+      "KC_WAKE",
+      "TO(0)",
+      "MS_WHLU",
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "TO(3)",
+      "MS_LEFT",
+      "MS_DOWN",
+      "MS_UP",
+      "MS_RGHT",
+      "MS_WHLD",
+      "KC_F9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "TO(4)",
+      "MS_BTN4",
+      "MS_BTN1",
+      "MS_BTN3",
+      "MS_BTN2",
+      "MS_BTN5",
+      "KC_TRNS",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO"
+    ],
+    [
+      "KC_Q",
+      "KC_C",
+      "KC_O",
+      "KC_P",
+      "KC_W",
+      "KC_J",
+      "KC_M",
+      "KC_D",
+      "TO(0)",
+      "KC_Y",
+      "KC_A",
+      "KC_S",
+      "KC_E",
+      "KC_N",
+      "KC_F",
+      "KC_L",
+      "KC_R",
+      "KC_T",
+      "KC_I",
+      "KC_U",
+      "KC_Z",
+      "KC_X",
+      "KC_MINS",
+      "KC_V",
+      "KC_B",
+      "KC_DOT",
+      "KC_H",
+      "KC_G",
+      "KC_COMM",
+      "KC_K",
+      "LT(1,KC_SPC)",
+      "LSFT_T(KC_ENT)",
+      "RALT_T(KC_ESC)",
+      "LT(1,KC_TAB)"
+    ],
+    [
+      "KC_TAB",
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_LSFT",
+      "KC_A",
+      "KC_S",
+      "KC_D",
+      "KC_F",
+      "KC_G",
+      "KC_H",
+      "KC_J",
+      "KC_K",
+      "KC_L",
+      "KC_LCTL",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_V",
+      "KC_B",
+      "KC_N",
+      "KC_M",
+      "KC_COMM",
+      "KC_DOT",
+      "LT(5,KC_LALT)",
+      "KC_SPC",
+      "TO(0)",
+      "KC_ESC"
+    ],
+    [
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "KC_F9",
+      "KC_PSCR",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_4",
+      "KC_T",
+      "KC_9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "KC_BSPC",
+      "KC_5",
+      "KC_6",
+      "KC_7",
+      "KC_8",
+      "KC_G",
+      "KC_0",
+      "KC_MINS",
+      "KC_EQL",
+      "KC_INT3",
+      "KC_ENT",
+      "KC_NO",
+      "KC_NO",
+      "TO(0)",
+      "KC_NO"
+    ]
+  ],
+  "author": ""
+}
--- a/json/xbows_nature.json
+++ b/json/xbows_nature.json
@@ -0,0 +1,451 @@
+{
+  "version": 1,
+  "notes": "",
+  "documentation": "\"This file is a QMK Configurator export. You can import this at <https://config.qmk.fm>. It can also be used directly with QMK's source code.\n\nTo setup your QMK environment check out the tutorial: <https://docs.qmk.fm/#/newbs>\n\nYou can convert this file to a keymap.c using this command: `qmk json2c {keymap}`\n\nYou can compile this keymap using this command: `qmk compile {keymap}`\"\n",
+  "keyboard": "xbows/nature",
+  "keymap": "xbows_nature_310",
+  "layout": "LAYOUT",
+  "layers": [
+    [
+      "KC_ESC",
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "KC_F9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "KC_DEL",
+      "KC_PSCR",
+      "KC_GRV",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_0",
+      "KC_MINS",
+      "KC_EQL",
+      "KC_BSPC",
+      "KC_RBRC",
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_P",
+      "KC_LBRC",
+      "KC_HOME",
+      "KC_END",
+      "KC_PGUP",
+      "LT(1,KC_CAPS)",
+      "LGUI_T(KC_A)",
+      "LALT_T(KC_S)",
+      "LSFT_T(KC_D)",
+      "LCTL_T(KC_F)",
+      "KC_G",
+      "KC_BSPC",
+      "KC_H",
+      "LCTL_T(KC_J)",
+      "LSFT_T(KC_K)",
+      "LALT_T(KC_L)",
+      "LGUI_T(KC_SCLN)",
+      "KC_QUOT",
+      "TO(1)",
+      "KC_PGDN",
+      "KC_LSFT",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_V",
+      "KC_B",
+      "KC_ENT",
+      "KC_N",
+      "KC_M",
+      "KC_COMM",
+      "KC_DOT",
+      "KC_SLSH",
+      "KC_BSLS",
+      "KC_RCTL",
+      "KC_LCTL",
+      "KC_LGUI",
+      "KC_LALT",
+      "LT(2,KC_SPC)",
+      "LT(3,KC_ENT)",
+      "RALT_T(KC_ESC)",
+      "LT(2,KC_TAB)",
+      "RCTL(KC_RSFT)",
+      "MO(1)",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT"
+    ],
+    [
+      "QK_BOOT",
+      "KC_MUTE",
+      "KC_VOLD",
+      "KC_VOLU",
+      "ANY(RGB_M_P)",
+      "UG_VALD",
+      "UG_VALU",
+      "UG_PREV",
+      "UG_NEXT",
+      "UG_TOGG",
+      "UG_SPDD",
+      "UG_SPDU",
+      "UG_HUEU",
+      "NK_TOGG",
+      "EE_CLR",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_NUM",
+      "KC_PSLS",
+      "KC_PAST",
+      "KC_PMNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_NUM",
+      "KC_CALC",
+      "KC_TRNS",
+      "KC_P7",
+      "KC_P8",
+      "KC_P9",
+      "KC_PPLS",
+      "KC_GRV",
+      "MS_BTN3",
+      "KC_TRNS",
+      "KC_TRNS",
+      "MS_WHLU",
+      "KC_PGUP",
+      "KC_TRNS",
+      "KC_INS",
+      "KC_HOME",
+      "KC_TRNS",
+      "TO(0)",
+      "KC_P4",
+      "KC_P5",
+      "KC_P6",
+      "KC_PCMM",
+      "KC_TRNS",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT",
+      "MS_WHLD",
+      "KC_PGDN",
+      "TO(0)",
+      "KC_END",
+      "KC_TRNS",
+      "KC_PDOT",
+      "KC_P1",
+      "KC_P2",
+      "KC_P3",
+      "KC_PEQL",
+      "KC_TRNS",
+      "MS_LEFT",
+      "MS_DOWN",
+      "MS_UP",
+      "MS_RGHT",
+      "MS_BTN1",
+      "KC_MUTE",
+      "KC_VOLU",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_P0",
+      "KC_PENT",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_TRNS",
+      "KC_MPLY",
+      "KC_MPRV",
+      "KC_VOLD",
+      "KC_MNXT"
+    ],
+    [
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_PSLS",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_GRV",
+      "KC_HOME",
+      "KC_PGDN",
+      "KC_PGUP",
+      "KC_END",
+      "KC_PSCR",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "LSFT(KC_N)",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_0",
+      "KC_NO",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT",
+      "KC_BSPC",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_DOT",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_N",
+      "KC_NO",
+      "KC_MPLY",
+      "KC_VOLD",
+      "KC_VOLU",
+      "KC_MUTE",
+      "KC_DEL",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "OSL(3)",
+      "KC_NUBS",
+      "KC_NUBS",
+      "OSL(3)",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO"
+    ],
+    [
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "RSFT(KC_LSFT)",
+      "KC_PWR",
+      "KC_SLEP",
+      "KC_WAKE",
+      "KC_NUBS",
+      "MS_WHLU",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "TO(4)",
+      "KC_NO",
+      "MS_LEFT",
+      "MS_DOWN",
+      "MS_UP",
+      "MS_RGHT",
+      "MS_WHLD",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_F9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "OS_LGUI",
+      "KC_NO",
+      "MS_BTN4",
+      "MS_BTN1",
+      "MS_BTN3",
+      "MS_BTN2",
+      "MS_BTN5",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_TRNS",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO",
+      "KC_NO"
+    ],
+    [
+      "KC_ESC",
+      "KC_F1",
+      "KC_F2",
+      "KC_F3",
+      "KC_F4",
+      "KC_F5",
+      "KC_F6",
+      "KC_F7",
+      "KC_F8",
+      "KC_F9",
+      "KC_F10",
+      "KC_F11",
+      "KC_F12",
+      "KC_DEL",
+      "KC_PSCR",
+      "KC_GRV",
+      "KC_1",
+      "KC_2",
+      "KC_3",
+      "KC_4",
+      "KC_5",
+      "KC_6",
+      "KC_7",
+      "KC_8",
+      "KC_9",
+      "KC_0",
+      "KC_MINS",
+      "KC_EQL",
+      "KC_BSPC",
+      "KC_TAB",
+      "KC_Q",
+      "KC_W",
+      "KC_E",
+      "KC_R",
+      "KC_T",
+      "KC_Y",
+      "KC_U",
+      "KC_I",
+      "KC_O",
+      "KC_P",
+      "KC_LBRC",
+      "KC_HOME",
+      "KC_END",
+      "KC_PGUP",
+      "KC_CAPS",
+      "KC_A",
+      "KC_S",
+      "KC_D",
+      "KC_F",
+      "KC_G",
+      "KC_BSPC",
+      "KC_H",
+      "KC_J",
+      "KC_K",
+      "KC_L",
+      "KC_SCLN",
+      "KC_QUOT",
+      "TO(0)",
+      "KC_PGDN",
+      "KC_LSFT",
+      "KC_Z",
+      "KC_X",
+      "KC_C",
+      "KC_V",
+      "KC_B",
+      "KC_ENT",
+      "KC_N",
+      "KC_M",
+      "KC_COMM",
+      "KC_DOT",
+      "KC_SLSH",
+      "KC_BSLS",
+      "KC_RCTL",
+      "KC_LCTL",
+      "KC_LGUI",
+      "KC_LALT",
+      "KC_SPC",
+      "LSFT_T(KC_ENT)",
+      "KC_RALT",
+      "KC_TAB",
+      "RCTL(KC_RSFT)",
+      "MO(1)",
+      "KC_LEFT",
+      "KC_DOWN",
+      "KC_UP",
+      "KC_RGHT"
+    ]
+  ],
+  "author": ""
+}
Author	SHA1	Message	Date
Fabrice Mouhartem	e4177dbec4	fix(keymap): better names for Base and NavNum layers	2025-07-27 14:36:17 +02:00
Fabrice Mouhartem	f72650af58	docs(img/readme): add example	2025-07-27 14:31:10 +02:00
Fabrice Mouhartem	d3f18ddcf2	feat(image generation): add yaml + makefile to generate images	2025-07-27 14:29:24 +02:00
Fabrice Mouhartem	7b8feedb46	fix(images): typo in NavNum layer	2025-07-26 22:51:51 +02:00
Fabrice Mouhartem	305978c893	fix(illustrations): use svg images from keyboard-drawer	2025-07-26 22:39:53 +02:00
Fabrice Mouhartem	9fb627b94e	docs(readme): minor, change a title	2025-07-13 13:53:44 +02:00
Fabrice Mouhartem	99ca6a82af	docs(readme): add a paragraph about PERMISSIVE_HOLD	2025-07-13 13:52:20 +02:00
Fabrice Mouhartem	0bc802b2d8	docs(readme): Personalise the readme + include images	2025-07-13 13:44:15 +02:00
Fabrice Mouhartem	f4af49ee35	feat(assets): add static assets	2025-07-13 13:43:54 +02:00