Add missing keycode

Port RGB extension from timer to periodic task
Implement a heap based task scheduler
2023-04-01 21:55:45 +00:00 · 2023-04-01 00:12:49 +00:00 · 2023-04-01 00:12:49 +00:00 · 2023-03-26 22:28:35 +00:00 · 2023-03-25 00:51:15 +00:00 · 2023-03-24 22:22:41 +00:00
314 changed files with 17237 additions and 3493 deletions
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG] Title"
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+* Setup and configuration of the affected parts of the firmware (avoid copy-pasting the entire configuration if possible)
+* Setup and configuration of peripherals
+* Input: keys pressed, ...
+(Choose which are applicable.)
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Debug output**
+If applicable, add debug output from the serial console to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[Enhancement] Title"
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
--- a/.gitignore
+++ b/.gitignore
@ -1,3 +1,25 @@
+# KMK Specific
+.compiled/
+.ampy
+.submodules
+.circuitpy-deps
+.micropython-deps
+.devdeps
+.docker_base
+.dist
+
+# Personal dev scripts
+.scripts
+
+# Mountpoints
+mnt/
+mnt2/
+
+# VSCode
+.vscode/
+
+# Everything below is from https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@ -20,6 +42,7 @@ parts/
 sdist/
 var/
 wheels/
+share/python-wheels/
 *.egg-info/
 .installed.cfg
 *.egg
@ -38,14 +61,17 @@ pip-delete-this-directory.txt
 # Unit test / coverage reports
 htmlcov/
 .tox/
+.nox/
 .coverage
 .coverage.*
 .cache
 nosetests.xml
 coverage.xml
 *.cover
+*.py,cover
 .hypothesis/
 .pytest_cache/
+cover/

 # Translations
 *.mo
@ -55,6 +81,7 @@ coverage.xml
 *.log
 local_settings.py
 db.sqlite3
+db.sqlite3-journal

 # Flask stuff:
 instance/
@ -67,16 +94,47 @@ instance/
 docs/_build/

 # PyBuilder
+.pybuilder/
 target/

 # Jupyter Notebook
 .ipynb_checkpoints

+# IPython
+profile_default/
+ipython_config.py
+
 # pyenv
 .python-version

-# celery beat schedule file
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+#.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
 celerybeat-schedule
+celerybeat.pid

 # SageMath parsed files
 *.sage.py
@ -103,27 +161,24 @@ venv.bak/
 # mypy
 .mypy_cache/
 .compiled/
+.dmypy.json
+dmypy.json

-.ampy
-.submodules
-.circuitpy-deps
-.micropython-deps
-.devdeps
-.docker_base
+# Pyre type checker
+.pyre/

-# Pycharms cruft
-.idea
+# pytype static type analyzer
+.pytype/

-# Personal dev scripts
-.scripts
+# Cython debug symbols
+cython_debug/

-# Mountpoints
-mnt/
-mnt2/
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/

-# build artifacts
-kmk/release_info.py
-kmk/release_info.mpy
-*.mpy
-.vscode
-.dist
+# Mac Finder
+.DS_Store
--- a/111
+++ b/111
@ -21,7 +21,7 @@ PIPENV ?= $(shell which pipenv 2>/dev/null)

 MPY_CROSS ?= $(shell which mpy-cross 2>/dev/null)
 MPY_FLAGS ?= '-O2'
-MPY_SOURCES = 'kmk/'
+MPY_SOURCES ?= 'kmk/'
 MPY_TARGET_DIR ?= .compiled
 PY_KMK_TREE = $(shell find $(MPY_SOURCES) -name "*.py")
 DIST_DESCRIBE = $(shell $(DIST_DESCRIBE_CMD))
@ -30,19 +30,19 @@ TIMESTAMP := $(shell date +%s)

 all: copy-kmk copy-bootpy copy-keymap copy-board

-compile: $(MPY_TARGET_DIR)/.mpy.compiled
-
-$(MPY_TARGET_DIR)/.mpy.compiled: $(PY_KMK_TREE)
+.PHONY: compile compile-check
+compile: compile-check
 ifeq ($(MPY_CROSS),)
+compile-check:
 	@echo "===> Could not find mpy-cross in PATH, exiting"
 	@false
-endif
+else
+compile-check: $(PY_KMK_TREE:%.py=$(MPY_TARGET_DIR)/%.mpy)
 	@echo "===> Compiling all py files to mpy with flags $(MPY_FLAGS)"
-	@mkdir -p $(MPY_TARGET_DIR)
-	@echo "KMK_RELEASE = '$(DIST_DESCRIBE)'" > $(MPY_SOURCES)/release_info.py
-	@find $(MPY_SOURCES) -name "*.py" -exec sh -c 'mkdir -p $(MPY_TARGET_DIR)/$$(dirname {}) && mpy-cross $(MPY_FLAGS) {} -o $(MPY_TARGET_DIR)/$$(dirname {})/$$(basename -s .py {}).mpy' \;
-	@rm -rf $(MPY_SOURCES)/release_info.py
-	@touch $(MPY_TARGET_DIR)/.mpy.compiled
+$(MPY_TARGET_DIR)/%.mpy: %.py
+	@mkdir -p $(dir $@)
+	@$(MPY_CROSS) $(MPY_FLAGS) $? -o $@
+endif

 .devdeps: Pipfile.lock
 	@echo "===> Installing dependencies with pipenv"
@ -68,7 +68,7 @@ fix-formatting: devdeps
 	@$(PIPENV) run black .

 fix-isort: devdeps
-	@find kmk/ user_keymaps/ boards/ -name "*.py" | xargs $(PIPENV) run isort
+	@find boards/ kmk/ tests/ user_keymaps/ -name "*.py" | xargs $(PIPENV) run isort

 clean: clean-dist
 	@echo "===> Cleaning build artifacts"
@ -88,7 +88,11 @@ powerwash: clean
 	@echo "===> Removing pipenv-managed virtual environment"
 	@$(PIPENV) --rm || true

-test: lint
+test: lint unit-tests
+
+.PHONY: unit-tests
+unit-tests: devdeps
+	@$(PIPENV) run python3 -m unittest $(TESTS)

 reset-bootloader:
 	@echo "===> Rebooting your board to bootloader (safe to ignore file not found errors)"
@ -98,55 +102,44 @@ reset-board:
 	@echo "===> Rebooting your board (safe to ignore file not found errors)"
 	@-timeout -k 5s 10s $(PIPENV) run ampy -p /dev/ttyACM0 -d ${AMPY_DELAY} -b ${AMPY_BAUD} run util/reset.py

-ifdef MOUNTPOINT
-$(MOUNTPOINT)/kmk/.copied: $(shell find kmk/ -name "*.py" | xargs -0)
-	@echo "===> Copying KMK source folder"
-	@rsync -rh kmk $(MOUNTPOINT)/
-	@touch $(MOUNTPOINT)/kmk/.copied
-	@sync
-
-copy-kmk: $(MOUNTPOINT)/kmk/.copied
-else
-copy-kmk:
-	echo "**** MOUNTPOINT must be defined (wherever your CIRCUITPY drive is mounted) ****" && exit 1
-endif
-
-copy-board: $(MOUNTPOINT)/kb.py
-$(MOUNTPOINT)/kb.py: $(BOARD)
-	@echo "===> Copying your board to kb.py"
-	@rsync -rh $(BOARD) $@
-	@sync

 ifdef MOUNTPOINT
-$(MOUNTPOINT)/kmk/boot.py: boot.py
-	@echo "===> Copying required boot.py"
-	@rsync -rh boot.py $(MOUNTPOINT)/
-	@sync
-
-copy-bootpy: $(MOUNTPOINT)/kmk/boot.py
-else
-copy-bootpy:
-	echo "**** MOUNTPOINT must be defined (wherever your CIRCUITPY drive is mounted) ****" && exit 1
-endif
-
-ifdef MOUNTPOINT
-ifndef USER_KEYMAP
-$(MOUNTPOINT)/main.py:
-	@echo "**** USER_KEYMAP must be defined (ex. USER_KEYMAP=user_keymaps/noop.py) ****" && exit 1
-else
-$(MOUNTPOINT)/main.py: $(USER_KEYMAP)
-	@echo "===> Copying your keymap to main.py"
-	@rsync -rh $(USER_KEYMAP) $@
-	@sync
-endif # USER_KEYMAP
-
-copy-keymap: $(MOUNTPOINT)/main.py
-else
-copy-keymap:
-	echo "**** MOUNTPOINT must be defined (wherever your CIRCUITPY drive is mounted) ****" && exit 1
-
 ifdef BOARD
-copy-board: $(MOUNTPOINT)/kb.py
+copy-board:
+	@echo "===> Copying your board from $(BOARD) to $(MOUNTPOINT)"
+	@rsync -rhu $(BOARD)/*.py $(MOUNTPOINT)/
+	@sync
+else # BOARD
+copy-board:
+	@echo "**** Missing BOARD argument ****" && exit 1
 endif # BOARD

-endif # MOUNTPOINT
+copy-bootpy:
+	@echo "===> Copying required boot.py"
+	@rsync -rhu boot.py $(MOUNTPOINT)/boot.py
+	@sync
+
+copy-compiled:
+	@echo "===> Copying compiled KMK folder"
+	@rsync -rhu $(MPY_TARGET_DIR)/* $(MOUNTPOINT)/
+	@sync
+
+ifdef USER_KEYMAP
+copy-keymap:
+	@echo "===> Copying your keymap to main.py"
+	@rsync -rhu $(USER_KEYMAP) $(MOUNTPOINT)/main.py
+	@sync
+else # USER_KEYMAP
+copy-keymap:
+	@echo "**** Missing USER_KEYMAP argument ****" && exit 1
+endif # USER_KEYMAP
+
+copy-kmk:
+	@echo "===> Copying KMK source folder"
+	@rsync -rhu kmk $(MOUNTPOINT)/
+	@sync
+
+else # MOUNTPOINT
+copy-board copy-bootpy copy-compiled copy-keymap copy-kmk:
+	@echo "**** MOUNTPOINT must be defined (wherever your CIRCUITPY drive is mounted) ****" && exit 1
+endif # ifndef MOUNTPOINT
--- a/2
+++ b/2
@ -17,6 +17,6 @@ ipython = "*"
 isort = "*"
 neovim = "*"
 s3cmd = "*"
-black = "==21.6b0"
+black = "==22.3.0"
 flake8-quotes = "*"
 flake8-black = "*"
--- a/Pipfile.lock
+++ b/Pipfile.lock
@ -1,7 +1,7 @@
 {
    "_meta": {
        "hash": {
-            "sha256": "0a04ec24d4aef6828e4f5eefa0a7d2c312f21f2b2f18c42c7004cdbe0c02bd53"
+            "sha256": "8c1b0ad909dc0ac0fc8013756ca7db8b5420f51c25cc1c2d1612f62fe5e19843"
        },
        "pipfile-spec": 6,
        "requires": {},
@ -23,12 +23,12 @@
            "index": "pypi",
            "version": "==1.1.0"
        },
-        "appdirs": {
+        "asttokens": {
            "hashes": [
-                "sha256:7d5d0167b2b1ba821647616af46a749d1c653740dd0d2415100fe26e27afdf41",
-                "sha256:a841dacd6b99318a741b166adb07e19ee71a274450e68237b4650ca1055ab128"
+                "sha256:4622110b2a6f30b77e1473affaa97e711bc2f07d3f10848420ff1898edbe94f3",
+                "sha256:6b0ac9e93fb0335014d382b8fa9b3afa7df546984258005da0b9e7095b3deb1c"
            ],
-            "version": "==1.4.4"
+            "version": "==2.2.1"
        },
        "backcall": {
            "hashes": [
@ -39,222 +39,281 @@
        },
        "black": {
            "hashes": [
-                "sha256:dc132348a88d103016726fe360cb9ede02cecf99b76e3660ce6c596be132ce04",
-                "sha256:dfb8c5a069012b2ab1e972e7b908f5fb42b6bbabcba0a788b86dc05067c7d9c7"
+                "sha256:06f9d8846f2340dfac80ceb20200ea5d1b3f181dd0556b47af4e8e0b24fa0a6b",
+                "sha256:10dbe6e6d2988049b4655b2b739f98785a884d4d6b85bc35133a8fb9a2233176",
+                "sha256:2497f9c2386572e28921fa8bec7be3e51de6801f7459dffd6e62492531c47e09",
+                "sha256:30d78ba6bf080eeaf0b7b875d924b15cd46fec5fd044ddfbad38c8ea9171043a",
+                "sha256:328efc0cc70ccb23429d6be184a15ce613f676bdfc85e5fe8ea2a9354b4e9015",
+                "sha256:35020b8886c022ced9282b51b5a875b6d1ab0c387b31a065b84db7c33085ca79",
+                "sha256:5795a0375eb87bfe902e80e0c8cfaedf8af4d49694d69161e5bd3206c18618bb",
+                "sha256:5891ef8abc06576985de8fa88e95ab70641de6c1fca97e2a15820a9b69e51b20",
+                "sha256:637a4014c63fbf42a692d22b55d8ad6968a946b4a6ebc385c5505d9625b6a464",
+                "sha256:67c8301ec94e3bcc8906740fe071391bce40a862b7be0b86fb5382beefecd968",
+                "sha256:6d2fc92002d44746d3e7db7cf9313cf4452f43e9ea77a2c939defce3b10b5c82",
+                "sha256:6ee227b696ca60dd1c507be80a6bc849a5a6ab57ac7352aad1ffec9e8b805f21",
+                "sha256:863714200ada56cbc366dc9ae5291ceb936573155f8bf8e9de92aef51f3ad0f0",
+                "sha256:9b542ced1ec0ceeff5b37d69838106a6348e60db7b8fdd245294dc1d26136265",
+                "sha256:a6342964b43a99dbc72f72812bf88cad8f0217ae9acb47c0d4f141a6416d2d7b",
+                "sha256:ad4efa5fad66b903b4a5f96d91461d90b9507a812b3c5de657d544215bb7877a",
+                "sha256:bc58025940a896d7e5356952228b68f793cf5fcb342be703c3a2669a1488cb72",
+                "sha256:cc1e1de68c8e5444e8f94c3670bb48a2beef0e91dddfd4fcc29595ebd90bb9ce",
+                "sha256:cee3e11161dde1b2a33a904b850b0899e0424cc331b7295f2a9698e79f9a69a0",
+                "sha256:e3556168e2e5c49629f7b0f377070240bd5511e45e25a4497bb0073d9dda776a",
+                "sha256:e8477ec6bbfe0312c128e74644ac8a02ca06bcdb8982d4ee06f209be28cdf163",
+                "sha256:ee8f1f7228cce7dffc2b464f07ce769f478968bfb3dd1254a4c2eeed84928aad",
+                "sha256:fd57160949179ec517d32ac2ac898b5f20d68ed1a9c977346efbac9c2f1e779d"
            ],
            "index": "pypi",
-            "version": "==21.6b0"
+            "version": "==22.3.0"
        },
        "click": {
            "hashes": [
-                "sha256:8c04c11192119b1ef78ea049e0a6f0463e4c48ef00a30160c704337586f3ad7a",
-                "sha256:fba402a4a47334742d782209a7c79bc448911afe1149d07bdabdf480b3e2f4b6"
+                "sha256:7682dc8afb30297001674575ea00d1814d808d6a36af415a82bd481d37ba7b8e",
+                "sha256:bb4d8133cb15a609f44e8213d9b391b0809795062913b383c62be0ee95b1db48"
            ],
-            "markers": "python_version >= '3.6'",
-            "version": "==8.0.1"
+            "markers": "python_version >= '3.7'",
+            "version": "==8.1.3"
        },
        "decorator": {
            "hashes": [
-                "sha256:6e5c199c16f7a9f0e3a61a4a54b3d27e7dad0dbdde92b944426cb20914376323",
-                "sha256:72ecfba4320a893c53f9706bebb2d55c270c1e51a28789361aa93e4a21319ed5"
+                "sha256:637996211036b6385ef91435e4fae22989472f9d571faba8927ba8253acbc330",
+                "sha256:b8c3f85900b9dc423225913c5aace94729fe1fa9763b38939a95226f02d37186"
            ],
-            "markers": "python_version >= '3.5'",
-            "version": "==5.0.9"
+            "markers": "python_version < '3.11' and python_version >= '3.7'",
+            "version": "==5.1.1"
+        },
+        "executing": {
+            "hashes": [
+                "sha256:0314a69e37426e3608aada02473b4161d4caf5a4b244d1d0c48072b8fee7bacc",
+                "sha256:19da64c18d2d851112f09c287f8d3dbbdf725ab0e569077efb6cdcbd3497c107"
+            ],
+            "version": "==1.2.0"
        },
        "flake8": {
            "hashes": [
-                "sha256:07528381786f2a6237b061f6e96610a4167b226cb926e2aa2b6b1d78057c576b",
-                "sha256:bf8fd333346d844f616e8d47905ef3a3384edae6b4e9beb0c5101e25e3110907"
+                "sha256:3833794e27ff64ea4e9cf5d410082a8b97ff1a06c16aa3d2027339cd0f1195c7",
+                "sha256:c61007e76655af75e6785a931f452915b371dc48f56efd765247c8fe68f2b181"
            ],
            "index": "pypi",
-            "version": "==3.9.2"
+            "version": "==6.0.0"
        },
        "flake8-black": {
            "hashes": [
-                "sha256:941514149cb8b489cb17a4bb1cf18d84375db3b34381bb018de83509437931a0",
-                "sha256:f26651bc10db786c03f4093414f7c9ea982ed8a244cec323c984feeffdf4c118"
+                "sha256:0dfbca3274777792a5bcb2af887a4cad72c72d0e86c94e08e3a3de151bb41c34",
+                "sha256:fe8ea2eca98d8a504f22040d9117347f6b367458366952862ac3586e7d4eeaca"
            ],
            "index": "pypi",
-            "version": "==0.2.1"
+            "version": "==0.3.6"
        },
        "flake8-commas": {
            "hashes": [
-                "sha256:d3005899466f51380387df7151fb59afec666a0f4f4a2c6a8995b975de0f44b7",
-                "sha256:ee2141a3495ef9789a3894ed8802d03eff1eaaf98ce6d8653a7c573ef101935e"
+                "sha256:940441ab8ee544df564ae3b3f49f20462d75d5c7cac2463e0b27436e2050f263",
+                "sha256:ebb96c31e01d0ef1d0685a21f3f0e2f8153a0381430e748bf0bbbb5d5b453d54"
            ],
            "index": "pypi",
-            "version": "==2.0.0"
+            "version": "==2.1.0"
        },
        "flake8-comprehensions": {
            "hashes": [
-                "sha256:b07aef3277623db32310aa241a1cec67212b53c1d18e767d7e26d4d83aa05bf7",
-                "sha256:f24be9032587127f7a5bc6d066bf755b6e66834f694383adb8a673e229c1f559"
+                "sha256:412052ac4a947f36b891143430fef4859705af11b2572fbb689f90d372cf26ab",
+                "sha256:d763de3c74bc18a79c039a7ec732e0a1985b0c79309ceb51e56401ad0a2cd44e"
            ],
            "index": "pypi",
-            "version": "==3.5.0"
+            "version": "==3.10.1"
        },
        "flake8-isort": {
            "hashes": [
-                "sha256:2b91300f4f1926b396c2c90185844eb1a3d5ec39ea6138832d119da0a208f4d9",
-                "sha256:729cd6ef9ba3659512dee337687c05d79c78e1215fdf921ed67e5fe46cce2f3c"
+                "sha256:537f453a660d7e903f602ecfa36136b140de279df58d02eb1b6a0c84e83c528c",
+                "sha256:aa0cac02a62c7739e370ce6b9c31743edac904bae4b157274511fc8a19c75bbc"
            ],
            "index": "pypi",
-            "version": "==4.0.0"
+            "version": "==6.0.0"
        },
        "flake8-quotes": {
            "hashes": [
-                "sha256:3f1116e985ef437c130431ac92f9b3155f8f652fda7405ac22ffdfd7a9d1055e"
+                "sha256:6e26892b632dacba517bf27219c459a8396dcfac0f5e8204904c5a4ba9b480e1"
            ],
            "index": "pypi",
-            "version": "==3.2.0"
+            "version": "==3.3.2"
        },
        "greenlet": {
            "hashes": [
-                "sha256:03f28a5ea20201e70ab70518d151116ce939b412961c33827519ce620957d44c",
-                "sha256:06d7ac89e6094a0a8f8dc46aa61898e9e1aec79b0f8b47b2400dd51a44dbc832",
-                "sha256:06ecb43b04480e6bafc45cb1b4b67c785e183ce12c079473359e04a709333b08",
-                "sha256:096cb0217d1505826ba3d723e8981096f2622cde1eb91af9ed89a17c10aa1f3e",
-                "sha256:0c557c809eeee215b87e8a7cbfb2d783fb5598a78342c29ade561440abae7d22",
-                "sha256:0de64d419b1cb1bfd4ea544bedea4b535ef3ae1e150b0f2609da14bbf48a4a5f",
-                "sha256:14927b15c953f8f2d2a8dffa224aa78d7759ef95284d4c39e1745cf36e8cdd2c",
-                "sha256:16183fa53bc1a037c38d75fdc59d6208181fa28024a12a7f64bb0884434c91ea",
-                "sha256:206295d270f702bc27dbdbd7651e8ebe42d319139e0d90217b2074309a200da8",
-                "sha256:22002259e5b7828b05600a762579fa2f8b33373ad95a0ee57b4d6109d0e589ad",
-                "sha256:2325123ff3a8ecc10ca76f062445efef13b6cf5a23389e2df3c02a4a527b89bc",
-                "sha256:258f9612aba0d06785143ee1cbf2d7361801c95489c0bd10c69d163ec5254a16",
-                "sha256:3096286a6072553b5dbd5efbefc22297e9d06a05ac14ba017233fedaed7584a8",
-                "sha256:3d13da093d44dee7535b91049e44dd2b5540c2a0e15df168404d3dd2626e0ec5",
-                "sha256:408071b64e52192869129a205e5b463abda36eff0cebb19d6e63369440e4dc99",
-                "sha256:598bcfd841e0b1d88e32e6a5ea48348a2c726461b05ff057c1b8692be9443c6e",
-                "sha256:5d928e2e3c3906e0a29b43dc26d9b3d6e36921eee276786c4e7ad9ff5665c78a",
-                "sha256:5f75e7f237428755d00e7460239a2482fa7e3970db56c8935bd60da3f0733e56",
-                "sha256:60848099b76467ef09b62b0f4512e7e6f0a2c977357a036de602b653667f5f4c",
-                "sha256:6b1d08f2e7f2048d77343279c4d4faa7aef168b3e36039cba1917fffb781a8ed",
-                "sha256:70bd1bb271e9429e2793902dfd194b653221904a07cbf207c3139e2672d17959",
-                "sha256:76ed710b4e953fc31c663b079d317c18f40235ba2e3d55f70ff80794f7b57922",
-                "sha256:7920e3eccd26b7f4c661b746002f5ec5f0928076bd738d38d894bb359ce51927",
-                "sha256:7db68f15486d412b8e2cfcd584bf3b3a000911d25779d081cbbae76d71bd1a7e",
-                "sha256:8833e27949ea32d27f7e96930fa29404dd4f2feb13cce483daf52e8842ec246a",
-                "sha256:944fbdd540712d5377a8795c840a97ff71e7f3221d3fddc98769a15a87b36131",
-                "sha256:9a6b035aa2c5fcf3dbbf0e3a8a5bc75286fc2d4e6f9cfa738788b433ec894919",
-                "sha256:9bdcff4b9051fb1aa4bba4fceff6a5f770c6be436408efd99b76fc827f2a9319",
-                "sha256:a9017ff5fc2522e45562882ff481128631bf35da444775bc2776ac5c61d8bcae",
-                "sha256:aa4230234d02e6f32f189fd40b59d5a968fe77e80f59c9c933384fe8ba535535",
-                "sha256:ad80bb338cf9f8129c049837a42a43451fc7c8b57ad56f8e6d32e7697b115505",
-                "sha256:adb94a28225005890d4cf73648b5131e885c7b4b17bc762779f061844aabcc11",
-                "sha256:b3090631fecdf7e983d183d0fad7ea72cfb12fa9212461a9b708ff7907ffff47",
-                "sha256:b33b51ab057f8a20b497ffafdb1e79256db0c03ef4f5e3d52e7497200e11f821",
-                "sha256:b97c9a144bbeec7039cca44df117efcbeed7209543f5695201cacf05ba3b5857",
-                "sha256:be13a18cec649ebaab835dff269e914679ef329204704869f2f167b2c163a9da",
-                "sha256:be9768e56f92d1d7cd94185bab5856f3c5589a50d221c166cc2ad5eb134bd1dc",
-                "sha256:c1580087ab493c6b43e66f2bdd165d9e3c1e86ef83f6c2c44a29f2869d2c5bd5",
-                "sha256:c35872b2916ab5a240d52a94314c963476c989814ba9b519bc842e5b61b464bb",
-                "sha256:c70c7dd733a4c56838d1f1781e769081a25fade879510c5b5f0df76956abfa05",
-                "sha256:c767458511a59f6f597bfb0032a1c82a52c29ae228c2c0a6865cfeaeaac4c5f5",
-                "sha256:c87df8ae3f01ffb4483c796fe1b15232ce2b219f0b18126948616224d3f658ee",
-                "sha256:ca1c4a569232c063615f9e70ff9a1e2fee8c66a6fb5caf0f5e8b21a396deec3e",
-                "sha256:cc407b68e0a874e7ece60f6639df46309376882152345508be94da608cc0b831",
-                "sha256:da862b8f7de577bc421323714f63276acb2f759ab8c5e33335509f0b89e06b8f",
-                "sha256:dfe7eac0d253915116ed0cd160a15a88981a1d194c1ef151e862a5c7d2f853d3",
-                "sha256:ed1377feed808c9c1139bdb6a61bcbf030c236dd288d6fca71ac26906ab03ba6",
-                "sha256:f42ad188466d946f1b3afc0a9e1a266ac8926461ee0786c06baac6bd71f8a6f3",
-                "sha256:f92731609d6625e1cc26ff5757db4d32b6b810d2a3363b0ff94ff573e5901f6f"
+                "sha256:03a8f4f3430c3b3ff8d10a2a86028c660355ab637cee9333d63d66b56f09d52a",
+                "sha256:0bf60faf0bc2468089bdc5edd10555bab6e85152191df713e2ab1fcc86382b5a",
+                "sha256:18a7f18b82b52ee85322d7a7874e676f34ab319b9f8cce5de06067384aa8ff43",
+                "sha256:18e98fb3de7dba1c0a852731c3070cf022d14f0d68b4c87a19cc1016f3bb8b33",
+                "sha256:1a819eef4b0e0b96bb0d98d797bef17dc1b4a10e8d7446be32d1da33e095dbb8",
+                "sha256:26fbfce90728d82bc9e6c38ea4d038cba20b7faf8a0ca53a9c07b67318d46088",
+                "sha256:2780572ec463d44c1d3ae850239508dbeb9fed38e294c68d19a24d925d9223ca",
+                "sha256:283737e0da3f08bd637b5ad058507e578dd462db259f7f6e4c5c365ba4ee9343",
+                "sha256:2d4686f195e32d36b4d7cf2d166857dbd0ee9f3d20ae349b6bf8afc8485b3645",
+                "sha256:2dd11f291565a81d71dab10b7033395b7a3a5456e637cf997a6f33ebdf06f8db",
+                "sha256:30bcf80dda7f15ac77ba5af2b961bdd9dbc77fd4ac6105cee85b0d0a5fcf74df",
+                "sha256:32e5b64b148966d9cccc2c8d35a671409e45f195864560829f395a54226408d3",
+                "sha256:36abbf031e1c0f79dd5d596bfaf8e921c41df2bdf54ee1eed921ce1f52999a86",
+                "sha256:3a06ad5312349fec0ab944664b01d26f8d1f05009566339ac6f63f56589bc1a2",
+                "sha256:3a51c9751078733d88e013587b108f1b7a1fb106d402fb390740f002b6f6551a",
+                "sha256:3c9b12575734155d0c09d6c3e10dbd81665d5c18e1a7c6597df72fd05990c8cf",
+                "sha256:3f6ea9bd35eb450837a3d80e77b517ea5bc56b4647f5502cd28de13675ee12f7",
+                "sha256:4b58adb399c4d61d912c4c331984d60eb66565175cdf4a34792cd9600f21b394",
+                "sha256:4d2e11331fc0c02b6e84b0d28ece3a36e0548ee1a1ce9ddde03752d9b79bba40",
+                "sha256:5454276c07d27a740c5892f4907c86327b632127dd9abec42ee62e12427ff7e3",
+                "sha256:561091a7be172ab497a3527602d467e2b3fbe75f9e783d8b8ce403fa414f71a6",
+                "sha256:6c3acb79b0bfd4fe733dff8bc62695283b57949ebcca05ae5c129eb606ff2d74",
+                "sha256:703f18f3fda276b9a916f0934d2fb6d989bf0b4fb5a64825260eb9bfd52d78f0",
+                "sha256:7492e2b7bd7c9b9916388d9df23fa49d9b88ac0640db0a5b4ecc2b653bf451e3",
+                "sha256:76ae285c8104046b3a7f06b42f29c7b73f77683df18c49ab5af7983994c2dd91",
+                "sha256:7cafd1208fdbe93b67c7086876f061f660cfddc44f404279c1585bbf3cdc64c5",
+                "sha256:7efde645ca1cc441d6dc4b48c0f7101e8d86b54c8530141b09fd31cef5149ec9",
+                "sha256:88d9ab96491d38a5ab7c56dd7a3cc37d83336ecc564e4e8816dbed12e5aaefc8",
+                "sha256:8eab883b3b2a38cc1e050819ef06a7e6344d4a990d24d45bc6f2cf959045a45b",
+                "sha256:910841381caba4f744a44bf81bfd573c94e10b3045ee00de0cbf436fe50673a6",
+                "sha256:9190f09060ea4debddd24665d6804b995a9c122ef5917ab26e1566dcc712ceeb",
+                "sha256:937e9020b514ceedb9c830c55d5c9872abc90f4b5862f89c0887033ae33c6f73",
+                "sha256:94c817e84245513926588caf1152e3b559ff794d505555211ca041f032abbb6b",
+                "sha256:971ce5e14dc5e73715755d0ca2975ac88cfdaefcaab078a284fea6cfabf866df",
+                "sha256:9d14b83fab60d5e8abe587d51c75b252bcc21683f24699ada8fb275d7712f5a9",
+                "sha256:9f35ec95538f50292f6d8f2c9c9f8a3c6540bbfec21c9e5b4b751e0a7c20864f",
+                "sha256:a1846f1b999e78e13837c93c778dcfc3365902cfb8d1bdb7dd73ead37059f0d0",
+                "sha256:acd2162a36d3de67ee896c43effcd5ee3de247eb00354db411feb025aa319857",
+                "sha256:b0ef99cdbe2b682b9ccbb964743a6aca37905fda5e0452e5ee239b1654d37f2a",
+                "sha256:b80f600eddddce72320dbbc8e3784d16bd3fb7b517e82476d8da921f27d4b249",
+                "sha256:b864ba53912b6c3ab6bcb2beb19f19edd01a6bfcbdfe1f37ddd1778abfe75a30",
+                "sha256:b9ec052b06a0524f0e35bd8790686a1da006bd911dd1ef7d50b77bfbad74e292",
+                "sha256:ba2956617f1c42598a308a84c6cf021a90ff3862eddafd20c3333d50f0edb45b",
+                "sha256:bdfea8c661e80d3c1c99ad7c3ff74e6e87184895bbaca6ee8cc61209f8b9b85d",
+                "sha256:be4ed120b52ae4d974aa40215fcdfde9194d63541c7ded40ee12eb4dda57b76b",
+                "sha256:c4302695ad8027363e96311df24ee28978162cdcdd2006476c43970b384a244c",
+                "sha256:c48f54ef8e05f04d6eff74b8233f6063cb1ed960243eacc474ee73a2ea8573ca",
+                "sha256:c9c59a2120b55788e800d82dfa99b9e156ff8f2227f07c5e3012a45a399620b7",
+                "sha256:cd021c754b162c0fb55ad5d6b9d960db667faad0fa2ff25bb6e1301b0b6e6a75",
+                "sha256:d27ec7509b9c18b6d73f2f5ede2622441de812e7b1a80bbd446cb0633bd3d5ae",
+                "sha256:d5508f0b173e6aa47273bdc0a0b5ba055b59662ba7c7ee5119528f466585526b",
+                "sha256:d75209eed723105f9596807495d58d10b3470fa6732dd6756595e89925ce2470",
+                "sha256:db1a39669102a1d8d12b57de2bb7e2ec9066a6f2b3da35ae511ff93b01b5d564",
+                "sha256:dbfcfc0218093a19c252ca8eb9aee3d29cfdcb586df21049b9d777fd32c14fd9",
+                "sha256:e0f72c9ddb8cd28532185f54cc1453f2c16fb417a08b53a855c4e6a418edd099",
+                "sha256:e7c8dc13af7db097bed64a051d2dd49e9f0af495c26995c00a9ee842690d34c0",
+                "sha256:ea9872c80c132f4663822dd2a08d404073a5a9b5ba6155bea72fb2a79d1093b5",
+                "sha256:eff4eb9b7eb3e4d0cae3d28c283dc16d9bed6b193c2e1ace3ed86ce48ea8df19",
+                "sha256:f82d4d717d8ef19188687aa32b8363e96062911e63ba22a0cff7802a8e58e5f1",
+                "sha256:fc3a569657468b6f3fb60587e48356fe512c1754ca05a564f11366ac9e306526"
            ],
            "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4'",
-            "version": "==1.1.0"
+            "version": "==2.0.2"
        },
        "ipdb": {
            "hashes": [
-                "sha256:951bd9a64731c444fd907a5ce268543020086a697f6be08f7cc2c9a752a278c5"
+                "sha256:c23b6736f01fd4586cc2ecbebdf79a5eb454796853e1cd8f2ed3b7b91d4a3e93",
+                "sha256:f74c2f741c18b909eaf89f19fde973f745ac721744aa1465888ce45813b63a9c"
            ],
            "index": "pypi",
-            "version": "==0.13.9"
+            "version": "==0.13.11"
        },
        "ipython": {
            "hashes": [
-                "sha256:9bc24a99f5d19721fb8a2d1408908e9c0520a17fff2233ffe82620847f17f1b6",
-                "sha256:d513e93327cf8657d6467c81f1f894adc125334ffe0e4ddd1abbb1c78d828703"
+                "sha256:b13a1d6c1f5818bd388db53b7107d17454129a70de2b87481d555daede5eb49e",
+                "sha256:b38c31e8fc7eff642fc7c597061fff462537cf2314e3225a19c906b7b0d8a345"
            ],
            "index": "pypi",
-            "version": "==7.24.1"
-        },
-        "ipython-genutils": {
-            "hashes": [
-                "sha256:72dd37233799e619666c9f639a9da83c34013a73e8bbc79a7a6348d93c61fab8",
-                "sha256:eb2e116e75ecef9d4d228fdc66af54269afa26ab4463042e33785b887c628ba8"
-            ],
-            "version": "==0.2.0"
+            "version": "==8.10.0"
        },
        "isort": {
            "hashes": [
-                "sha256:0a943902919f65c5684ac4e0154b1ad4fac6dcaa5d9f3426b732f1c8b5419be6",
-                "sha256:2bb1680aad211e3c9944dbce1d4ba09a989f04e238296c87fe2139faa26d655d"
+                "sha256:8bef7dde241278824a6d83f44a544709b065191b95b6e50894bdc722fcba0504",
+                "sha256:f84c2818376e66cf843d497486ea8fed8700b340f308f076c6fb1229dff318b6"
            ],
            "index": "pypi",
-            "version": "==5.8.0"
+            "version": "==5.12.0"
        },
        "jedi": {
            "hashes": [
-                "sha256:18456d83f65f400ab0c2d3319e48520420ef43b23a086fdc05dff34132f0fb93",
-                "sha256:92550a404bad8afed881a137ec9a461fed49eca661414be45059329614ed0707"
+                "sha256:203c1fd9d969ab8f2119ec0a3342e0b49910045abe6af0a3ae83a5764d54639e",
+                "sha256:bae794c30d07f6d910d32a7048af09b5a39ed740918da923c6b780790ebac612"
            ],
            "markers": "python_version >= '3.6'",
-            "version": "==0.18.0"
+            "version": "==0.18.2"
        },
        "matplotlib-inline": {
            "hashes": [
-                "sha256:5cf1176f554abb4fa98cb362aa2b55c500147e4bdbb07e3fda359143e1da0811",
-                "sha256:f41d5ff73c9f5385775d5c0bc13b424535c8402fe70ea8210f93e11f3683993e"
+                "sha256:f1f41aab5328aa5aaea9b16d083b128102f8712542f819fe7e6a420ff581b311",
+                "sha256:f887e5f10ba98e8d2b150ddcf4702c1e5f8b3a20005eb0f74bfdbd360ee6f304"
            ],
            "markers": "python_version >= '3.5'",
-            "version": "==0.1.2"
+            "version": "==0.1.6"
        },
        "mccabe": {
            "hashes": [
-                "sha256:ab8a6258860da4b6677da4bd2fe5dc2c659cff31b3ee4f7f5d64e79735b80d42",
-                "sha256:dd8d182285a0fe56bace7f45b5e7d1a6ebcbf524e8f3bd87eb0f125271b8831f"
+                "sha256:348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325",
+                "sha256:6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e"
            ],
-            "version": "==0.6.1"
+            "markers": "python_version >= '3.6'",
+            "version": "==0.7.0"
        },
        "msgpack": {
            "hashes": [
-                "sha256:0cb94ee48675a45d3b86e61d13c1e6f1696f0183f0715544976356ff86f741d9",
-                "sha256:1026dcc10537d27dd2d26c327e552f05ce148977e9d7b9f1718748281b38c841",
-                "sha256:26a1759f1a88df5f1d0b393eb582ec022326994e311ba9c5818adc5374736439",
-                "sha256:2a5866bdc88d77f6e1370f82f2371c9bc6fc92fe898fa2dec0c5d4f5435a2694",
-                "sha256:31c17bbf2ae5e29e48d794c693b7ca7a0c73bd4280976d408c53df421e838d2a",
-                "sha256:497d2c12426adcd27ab83144057a705efb6acc7e85957a51d43cdcf7f258900f",
-                "sha256:5a9ee2540c78659a1dd0b110f73773533ee3108d4e1219b5a15a8d635b7aca0e",
-                "sha256:8521e5be9e3b93d4d5e07cb80b7e32353264d143c1f072309e1863174c6aadb1",
-                "sha256:87869ba567fe371c4555d2e11e4948778ab6b59d6cc9d8460d543e4cfbbddd1c",
-                "sha256:8ffb24a3b7518e843cd83538cf859e026d24ec41ac5721c18ed0c55101f9775b",
-                "sha256:92be4b12de4806d3c36810b0fe2aeedd8d493db39e2eb90742b9c09299eb5759",
-                "sha256:9ea52fff0473f9f3000987f313310208c879493491ef3ccf66268eff8d5a0326",
-                "sha256:a4355d2193106c7aa77c98fc955252a737d8550320ecdb2e9ac701e15e2943bc",
-                "sha256:a99b144475230982aee16b3d249170f1cccebf27fb0a08e9f603b69637a62192",
-                "sha256:ac25f3e0513f6673e8b405c3a80500eb7be1cf8f57584be524c4fa78fe8e0c83",
-                "sha256:b28c0876cce1466d7c2195d7658cf50e4730667196e2f1355c4209444717ee06",
-                "sha256:b55f7db883530b74c857e50e149126b91bb75d35c08b28db12dcb0346f15e46e",
-                "sha256:b6d9e2dae081aa35c44af9c4298de4ee72991305503442a5c74656d82b581fe9",
-                "sha256:c747c0cc08bd6d72a586310bda6ea72eeb28e7505990f342552315b229a19b33",
-                "sha256:d6c64601af8f3893d17ec233237030e3110f11b8a962cb66720bf70c0141aa54",
-                "sha256:d8167b84af26654c1124857d71650404336f4eb5cc06900667a493fc619ddd9f",
-                "sha256:de6bd7990a2c2dabe926b7e62a92886ccbf809425c347ae7de277067f97c2887",
-                "sha256:e36a812ef4705a291cdb4a2fd352f013134f26c6ff63477f20235138d1d21009",
-                "sha256:e89ec55871ed5473a041c0495b7b4e6099f6263438e0bd04ccd8418f92d5d7f2",
-                "sha256:f3e6aaf217ac1c7ce1563cf52a2f4f5d5b1f64e8729d794165db71da57257f0c",
-                "sha256:f484cd2dca68502de3704f056fa9b318c94b1539ed17a4c784266df5d6978c87",
-                "sha256:fae04496f5bc150eefad4e9571d1a76c55d021325dcd484ce45065ebbdd00984",
-                "sha256:fe07bc6735d08e492a327f496b7850e98cb4d112c56df69b0c844dbebcbb47f6"
+                "sha256:002b5c72b6cd9b4bafd790f364b8480e859b4712e91f43014fe01e4f957b8467",
+                "sha256:0a68d3ac0104e2d3510de90a1091720157c319ceeb90d74f7b5295a6bee51bae",
+                "sha256:0df96d6eaf45ceca04b3f3b4b111b86b33785683d682c655063ef8057d61fd92",
+                "sha256:0dfe3947db5fb9ce52aaea6ca28112a170db9eae75adf9339a1aec434dc954ef",
+                "sha256:0e3590f9fb9f7fbc36df366267870e77269c03172d086fa76bb4eba8b2b46624",
+                "sha256:11184bc7e56fd74c00ead4f9cc9a3091d62ecb96e97653add7a879a14b003227",
+                "sha256:112b0f93202d7c0fef0b7810d465fde23c746a2d482e1e2de2aafd2ce1492c88",
+                "sha256:1276e8f34e139aeff1c77a3cefb295598b504ac5314d32c8c3d54d24fadb94c9",
+                "sha256:1576bd97527a93c44fa856770197dec00d223b0b9f36ef03f65bac60197cedf8",
+                "sha256:1e91d641d2bfe91ba4c52039adc5bccf27c335356055825c7f88742c8bb900dd",
+                "sha256:26b8feaca40a90cbe031b03d82b2898bf560027160d3eae1423f4a67654ec5d6",
+                "sha256:2999623886c5c02deefe156e8f869c3b0aaeba14bfc50aa2486a0415178fce55",
+                "sha256:2a2df1b55a78eb5f5b7d2a4bb221cd8363913830145fad05374a80bf0877cb1e",
+                "sha256:2bb8cdf50dd623392fa75525cce44a65a12a00c98e1e37bf0fb08ddce2ff60d2",
+                "sha256:2cc5ca2712ac0003bcb625c96368fd08a0f86bbc1a5578802512d87bc592fe44",
+                "sha256:35bc0faa494b0f1d851fd29129b2575b2e26d41d177caacd4206d81502d4c6a6",
+                "sha256:3c11a48cf5e59026ad7cb0dc29e29a01b5a66a3e333dc11c04f7e991fc5510a9",
+                "sha256:449e57cc1ff18d3b444eb554e44613cffcccb32805d16726a5494038c3b93dab",
+                "sha256:462497af5fd4e0edbb1559c352ad84f6c577ffbbb708566a0abaaa84acd9f3ae",
+                "sha256:4733359808c56d5d7756628736061c432ded018e7a1dff2d35a02439043321aa",
+                "sha256:48f5d88c99f64c456413d74a975bd605a9b0526293218a3b77220a2c15458ba9",
+                "sha256:49565b0e3d7896d9ea71d9095df15b7f75a035c49be733051c34762ca95bbf7e",
+                "sha256:4ab251d229d10498e9a2f3b1e68ef64cb393394ec477e3370c457f9430ce9250",
+                "sha256:4d5834a2a48965a349da1c5a79760d94a1a0172fbb5ab6b5b33cbf8447e109ce",
+                "sha256:4dea20515f660aa6b7e964433b1808d098dcfcabbebeaaad240d11f909298075",
+                "sha256:545e3cf0cf74f3e48b470f68ed19551ae6f9722814ea969305794645da091236",
+                "sha256:63e29d6e8c9ca22b21846234913c3466b7e4ee6e422f205a2988083de3b08cae",
+                "sha256:6916c78f33602ecf0509cc40379271ba0f9ab572b066bd4bdafd7434dee4bc6e",
+                "sha256:6a4192b1ab40f8dca3f2877b70e63799d95c62c068c84dc028b40a6cb03ccd0f",
+                "sha256:6c9566f2c39ccced0a38d37c26cc3570983b97833c365a6044edef3574a00c08",
+                "sha256:76ee788122de3a68a02ed6f3a16bbcd97bc7c2e39bd4d94be2f1821e7c4a64e6",
+                "sha256:7760f85956c415578c17edb39eed99f9181a48375b0d4a94076d84148cf67b2d",
+                "sha256:77ccd2af37f3db0ea59fb280fa2165bf1b096510ba9fe0cc2bf8fa92a22fdb43",
+                "sha256:81fc7ba725464651190b196f3cd848e8553d4d510114a954681fd0b9c479d7e1",
+                "sha256:85f279d88d8e833ec015650fd15ae5eddce0791e1e8a59165318f371158efec6",
+                "sha256:9667bdfdf523c40d2511f0e98a6c9d3603be6b371ae9a238b7ef2dc4e7a427b0",
+                "sha256:a75dfb03f8b06f4ab093dafe3ddcc2d633259e6c3f74bb1b01996f5d8aa5868c",
+                "sha256:ac5bd7901487c4a1dd51a8c58f2632b15d838d07ceedaa5e4c080f7190925bff",
+                "sha256:aca0f1644d6b5a73eb3e74d4d64d5d8c6c3d577e753a04c9e9c87d07692c58db",
+                "sha256:b17be2478b622939e39b816e0aa8242611cc8d3583d1cd8ec31b249f04623243",
+                "sha256:c1683841cd4fa45ac427c18854c3ec3cd9b681694caf5bff04edb9387602d661",
+                "sha256:c23080fdeec4716aede32b4e0ef7e213c7b1093eede9ee010949f2a418ced6ba",
+                "sha256:d5b5b962221fa2c5d3a7f8133f9abffc114fe218eb4365e40f17732ade576c8e",
+                "sha256:d603de2b8d2ea3f3bcb2efe286849aa7a81531abc52d8454da12f46235092bcb",
+                "sha256:e83f80a7fec1a62cf4e6c9a660e39c7f878f603737a0cdac8c13131d11d97f52",
+                "sha256:eb514ad14edf07a1dbe63761fd30f89ae79b42625731e1ccf5e1f1092950eaa6",
+                "sha256:eba96145051ccec0ec86611fe9cf693ce55f2a3ce89c06ed307de0e085730ec1",
+                "sha256:ed6f7b854a823ea44cf94919ba3f727e230da29feb4a99711433f25800cf747f",
+                "sha256:f0029245c51fd9473dc1aede1160b0a29f4a912e6b1dd353fa6d317085b219da",
+                "sha256:f5d869c18f030202eb412f08b28d2afeea553d6613aee89e200d7aca7ef01f5f",
+                "sha256:fb62ea4b62bfcb0b380d5680f9a4b3f9a2d166d9394e9bbd9666c0ee09a3645c",
+                "sha256:fcb8a47f43acc113e24e910399376f7277cf8508b27e5b88499f053de6b115a8"
            ],
-            "version": "==1.0.2"
+            "version": "==1.0.4"
        },
        "mypy-extensions": {
            "hashes": [
-                "sha256:090fedd75945a69ae91ce1303b5824f428daf5a028d2f6ab8a299250a846f15d",
-                "sha256:2d82818f5bb3e369420cb3c4060a7970edba416647068eb4c5343488a6c604a8"
+                "sha256:4392f6c0eb8a5668a69e23d168ffa70f0be9ccfd32b5cc2d26a34ae5b844552d",
+                "sha256:75dbf8955dc00442a438fc4d0666508a9a97b6bd41aa2f0ffe9d2f2725af0782"
            ],
-            "version": "==0.4.3"
+            "markers": "python_version >= '3.5'",
+            "version": "==1.0.0"
        },
        "neovim": {
            "hashes": [
@ -265,18 +324,19 @@
        },
        "parso": {
            "hashes": [
-                "sha256:12b83492c6239ce32ff5eed6d3639d6a536170723c6f3f1506869f1ace413398",
-                "sha256:a8c4922db71e4fdb90e0d0bc6e50f9b273d3397925e5e60a717e719201778d22"
+                "sha256:8c07be290bb59f03588915921e29e8a50002acaf2cdc5fa0e0114f91709fafa0",
+                "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"
            ],
            "markers": "python_version >= '3.6'",
-            "version": "==0.8.2"
+            "version": "==0.8.3"
        },
        "pathspec": {
            "hashes": [
-                "sha256:86379d6b86d75816baba717e64b1a3a3469deb93bb76d613c9ce79edc5cb68fd",
-                "sha256:aa0cb481c4041bf52ffa7b0d8fa6cd3e88a2ca4879c533c9153882ee2556790d"
+                "sha256:3a66eb970cbac598f9e5ccb5b2cf58930cd8e3ed86d393d541eaf2d8b1705229",
+                "sha256:64d338d4e0914e91c1792321e6907b5a593f1ab1851de7fc269557a21b30ebbc"
            ],
-            "version": "==0.8.1"
+            "markers": "python_version >= '3.7'",
+            "version": "==0.11.0"
        },
        "pexpect": {
            "hashes": [
@ -293,13 +353,21 @@
            ],
            "version": "==0.7.5"
        },
+        "platformdirs": {
+            "hashes": [
+                "sha256:8a1228abb1ef82d788f74139988b137e78692984ec7b08eaa6c65f1723af28f9",
+                "sha256:b1d5eb14f221506f50d6604a561f4c5786d9e80355219694a1b244bcd96f4567"
+            ],
+            "markers": "python_version >= '3.7'",
+            "version": "==3.0.0"
+        },
        "prompt-toolkit": {
            "hashes": [
-                "sha256:08360ee3a3148bdb5163621709ee322ec34fc4375099afa4bbf751e9b7b7fa4f",
-                "sha256:7089d8d2938043508aa9420ec18ce0922885304cddae87fb96eebca942299f88"
+                "sha256:3e163f254bef5a03b146397d7c1963bd3e2812f0964bb9a24e6ec761fd28db63",
+                "sha256:aa64ad242a462c5ff0363a7b9cfe696c20d55d9fc60c11fd8e632d064804d305"
            ],
-            "markers": "python_full_version >= '3.6.1'",
-            "version": "==3.0.19"
+            "markers": "python_full_version >= '3.6.2'",
+            "version": "==3.0.36"
        },
        "ptyprocess": {
            "hashes": [
@ -308,29 +376,36 @@
            ],
            "version": "==0.7.0"
        },
+        "pure-eval": {
+            "hashes": [
+                "sha256:01eaab343580944bc56080ebe0a674b39ec44a945e6d09ba7db3cb8cec289350",
+                "sha256:2b45320af6dfaa1750f543d714b6d1c520a1688dec6fd24d339063ce0aaa9ac3"
+            ],
+            "version": "==0.2.2"
+        },
        "pycodestyle": {
            "hashes": [
-                "sha256:514f76d918fcc0b55c6680472f0a37970994e07bbb80725808c17089be302068",
-                "sha256:c389c1d06bf7904078ca03399a4816f974a1d590090fecea0c63ec26ebaf1cef"
+                "sha256:347187bdb476329d98f695c213d7295a846d1152ff4fe9bacb8a9590b8ee7053",
+                "sha256:8a4eaf0d0495c7395bdab3589ac2db602797d76207242c17d470186815706610"
            ],
-            "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'",
-            "version": "==2.7.0"
+            "markers": "python_version >= '3.6'",
+            "version": "==2.10.0"
        },
        "pyflakes": {
            "hashes": [
-                "sha256:7893783d01b8a89811dd72d7dfd4d84ff098e5eed95cfa8905b22bbffe52efc3",
-                "sha256:f5bc8ecabc05bb9d291eb5203d6810b49040f6ff446a756326104746cc00c1db"
+                "sha256:ec55bf7fe21fff7f1ad2f7da62363d749e2a470500eab1b555334b67aa1ef8cf",
+                "sha256:ec8b276a6b60bd80defed25add7e439881c19e64850afd9b346283d4165fd0fd"
            ],
-            "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'",
-            "version": "==2.3.1"
+            "markers": "python_version >= '3.6'",
+            "version": "==3.0.1"
        },
        "pygments": {
            "hashes": [
-                "sha256:a18f47b506a429f6f4b9df81bb02beab9ca21d0a5fee38ed15aef65f0545519f",
-                "sha256:d66e804411278594d764fc69ec36ec13d9ae9147193a1740cd34d272ca383b8e"
+                "sha256:b3ed06a9e8ac9a9aae5a6f5dbe78a8a58655d17b43b93c078f094ddc476ae297",
+                "sha256:fa7bd7bd2771287c0de303af8bfdfc731f51bd2c6a47ab69d117138893b82717"
            ],
-            "markers": "python_version >= '3.5'",
-            "version": "==2.9.0"
+            "markers": "python_version >= '3.6'",
+            "version": "==2.14.0"
        },
        "pynvim": {
            "hashes": [
@ -347,80 +422,35 @@
        },
        "python-dateutil": {
            "hashes": [
-                "sha256:73ebfe9dbf22e832286dafa60473e4cd239f8592f699aa5adaf10050e6e1823c",
-                "sha256:75bb3f31ea686f1197762692a9ee6a7550b59fc6ca3a1f4b5d7e32fb98e2da2a"
+                "sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86",
+                "sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9"
            ],
            "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'",
-            "version": "==2.8.1"
+            "version": "==2.8.2"
        },
        "python-dotenv": {
            "hashes": [
-                "sha256:dd8fe852847f4fbfadabf6183ddd4c824a9651f02d51714fa075c95561959c7d",
-                "sha256:effaac3c1e58d89b3ccb4d04a40dc7ad6e0275fda25fd75ae9d323e2465e202d"
+                "sha256:1c93de8f636cde3ce377292818d0e440b6e45a82f215c3744979151fa8151c49",
+                "sha256:41e12e0318bebc859fcc4d97d4db8d20ad21721a6aa5047dd59f090391cb549a"
            ],
-            "version": "==0.18.0"
+            "markers": "python_version >= '3.7'",
+            "version": "==0.21.1"
        },
        "python-magic": {
            "hashes": [
-                "sha256:4fec8ee805fea30c07afccd1592c0f17977089895bdfaae5fec870a84e997626",
-                "sha256:de800df9fb50f8ec5974761054a708af6e4246b03b4bdaee993f948947b0ebcf"
+                "sha256:c1ba14b08e4a5f5c31a302b7721239695b2f0f058d125bd5ce1ee36b9d9d3c3b",
+                "sha256:c212960ad306f700aa0d01e5d7a325d20548ff97eb9920dcd29513174f0294d3"
            ],
            "index": "pypi",
-            "version": "==0.4.24"
-        },
-        "regex": {
-            "hashes": [
-                "sha256:01afaf2ec48e196ba91b37451aa353cb7eda77efe518e481707e0515025f0cd5",
-                "sha256:11d773d75fa650cd36f68d7ca936e3c7afaae41b863b8c387a22aaa78d3c5c79",
-                "sha256:18c071c3eb09c30a264879f0d310d37fe5d3a3111662438889ae2eb6fc570c31",
-                "sha256:1e1c20e29358165242928c2de1482fb2cf4ea54a6a6dea2bd7a0e0d8ee321500",
-                "sha256:281d2fd05555079448537fe108d79eb031b403dac622621c78944c235f3fcf11",
-                "sha256:314d66636c494ed9c148a42731b3834496cc9a2c4251b1661e40936814542b14",
-                "sha256:32e65442138b7b76dd8173ffa2cf67356b7bc1768851dded39a7a13bf9223da3",
-                "sha256:339456e7d8c06dd36a22e451d58ef72cef293112b559010db3d054d5560ef439",
-                "sha256:3916d08be28a1149fb97f7728fca1f7c15d309a9f9682d89d79db75d5e52091c",
-                "sha256:3a9cd17e6e5c7eb328517969e0cb0c3d31fd329298dd0c04af99ebf42e904f82",
-                "sha256:47bf5bf60cf04d72bf6055ae5927a0bd9016096bf3d742fa50d9bf9f45aa0711",
-                "sha256:4c46e22a0933dd783467cf32b3516299fb98cfebd895817d685130cc50cd1093",
-                "sha256:4c557a7b470908b1712fe27fb1ef20772b78079808c87d20a90d051660b1d69a",
-                "sha256:52ba3d3f9b942c49d7e4bc105bb28551c44065f139a65062ab7912bef10c9afb",
-                "sha256:563085e55b0d4fb8f746f6a335893bda5c2cef43b2f0258fe1020ab1dd874df8",
-                "sha256:598585c9f0af8374c28edd609eb291b5726d7cbce16be6a8b95aa074d252ee17",
-                "sha256:619d71c59a78b84d7f18891fe914446d07edd48dc8328c8e149cbe0929b4e000",
-                "sha256:67bdb9702427ceddc6ef3dc382455e90f785af4c13d495f9626861763ee13f9d",
-                "sha256:6d1b01031dedf2503631d0903cb563743f397ccaf6607a5e3b19a3d76fc10480",
-                "sha256:741a9647fcf2e45f3a1cf0e24f5e17febf3efe8d4ba1281dcc3aa0459ef424dc",
-                "sha256:7c2a1af393fcc09e898beba5dd59196edaa3116191cc7257f9224beaed3e1aa0",
-                "sha256:7d9884d86dd4dd489e981d94a65cd30d6f07203d90e98f6f657f05170f6324c9",
-                "sha256:90f11ff637fe8798933fb29f5ae1148c978cccb0452005bf4c69e13db951e765",
-                "sha256:919859aa909429fb5aa9cf8807f6045592c85ef56fdd30a9a3747e513db2536e",
-                "sha256:96fcd1888ab4d03adfc9303a7b3c0bd78c5412b2bfbe76db5b56d9eae004907a",
-                "sha256:97f29f57d5b84e73fbaf99ab3e26134e6687348e95ef6b48cfd2c06807005a07",
-                "sha256:980d7be47c84979d9136328d882f67ec5e50008681d94ecc8afa8a65ed1f4a6f",
-                "sha256:a91aa8619b23b79bcbeb37abe286f2f408d2f2d6f29a17237afda55bb54e7aac",
-                "sha256:ade17eb5d643b7fead300a1641e9f45401c98eee23763e9ed66a43f92f20b4a7",
-                "sha256:b9c3db21af35e3b3c05764461b262d6f05bbca08a71a7849fd79d47ba7bc33ed",
-                "sha256:bd28bc2e3a772acbb07787c6308e00d9626ff89e3bfcdebe87fa5afbfdedf968",
-                "sha256:bf5824bfac591ddb2c1f0a5f4ab72da28994548c708d2191e3b87dd207eb3ad7",
-                "sha256:c0502c0fadef0d23b128605d69b58edb2c681c25d44574fc673b0e52dce71ee2",
-                "sha256:c38c71df845e2aabb7fb0b920d11a1b5ac8526005e533a8920aea97efb8ec6a4",
-                "sha256:ce15b6d103daff8e9fee13cf7f0add05245a05d866e73926c358e871221eae87",
-                "sha256:d3029c340cfbb3ac0a71798100ccc13b97dddf373a4ae56b6a72cf70dfd53bc8",
-                "sha256:e512d8ef5ad7b898cdb2d8ee1cb09a8339e4f8be706d27eaa180c2f177248a10",
-                "sha256:e8e5b509d5c2ff12f8418006d5a90e9436766133b564db0abaec92fd27fcee29",
-                "sha256:ee54ff27bf0afaf4c3b3a62bcd016c12c3fdb4ec4f413391a90bd38bc3624605",
-                "sha256:fa4537fb4a98fe8fde99626e4681cc644bdcf2a795038533f9f711513a862ae6",
-                "sha256:fd45ff9293d9274c5008a2054ecef86a9bfe819a67c7be1afb65e69b405b3042"
-            ],
-            "version": "==2021.4.4"
+            "version": "==0.4.27"
        },
        "s3cmd": {
            "hashes": [
-                "sha256:49cd23d516b17974b22b611a95ce4d93fe326feaa07320bd1d234fed68cbccfa",
-                "sha256:966b0a494a916fc3b4324de38f089c86c70ee90e8e1cae6d59102103a4c0cc03"
+                "sha256:15330776e7ff993d8ae0ac213bf896f210719e9b91445f5f7626a8fa7e74e30b",
+                "sha256:2204306742c33c24fbca02b78e059bacfc1bfc04af09c7e9866f267a11a9ddb2"
            ],
            "index": "pypi",
-            "version": "==2.1.0"
+            "version": "==2.3.0"
        },
        "six": {
            "hashes": [
@ -430,35 +460,35 @@
            "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'",
            "version": "==1.16.0"
        },
-        "testfixtures": {
+        "stack-data": {
            "hashes": [
-                "sha256:5ec3a0dd6f71cc4c304fbc024a10cc293d3e0b852c868014b9f233203e149bda",
-                "sha256:9ed31e83f59619e2fa17df053b241e16e0608f4580f7b5a9333a0c9bdcc99137"
+                "sha256:32d2dd0376772d01b6cb9fc996f3c8b57a357089dec328ed4b6553d037eaf815",
+                "sha256:cbb2a53eb64e5785878201a97ed7c7b94883f48b87bfb0bbe8b623c74679e4a8"
            ],
-            "version": "==6.17.1"
+            "version": "==0.6.2"
        },
-        "toml": {
+        "tomli": {
            "hashes": [
-                "sha256:806143ae5bfb6a3c6e736a764057db0e6a0e05e338b5630894a5f779cabb4f9b",
-                "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f"
+                "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc",
+                "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"
            ],
-            "markers": "python_version >= '2.6' and python_version not in '3.0, 3.1, 3.2, 3.3'",
-            "version": "==0.10.2"
+            "markers": "python_version < '3.11'",
+            "version": "==2.0.1"
        },
        "traitlets": {
            "hashes": [
-                "sha256:178f4ce988f69189f7e523337a3e11d91c786ded9360174a3d9ca83e79bc5396",
-                "sha256:69ff3f9d5351f31a7ad80443c2674b7099df13cc41fc5fa6e2f6d3b0330b0426"
+                "sha256:9e6ec080259b9a5940c797d58b613b5e31441c2257b87c2e795c5228ae80d2d8",
+                "sha256:f6cde21a9c68cf756af02035f72d5a723bf607e862e7be33ece505abf4a3bad9"
            ],
            "markers": "python_version >= '3.7'",
-            "version": "==5.0.5"
+            "version": "==5.9.0"
        },
        "wcwidth": {
            "hashes": [
-                "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784",
-                "sha256:c4d647b99872929fdb7bdcaa4fbe7f01413ed3d98077df798530e5b04f116c83"
+                "sha256:795b138f6875577cd91bba52baf9e445cd5118fd32723b460e30a0af30ea230e",
+                "sha256:a5220780a404dbe3353789870978e472cfe477761f06ee55077256e509b156d0"
            ],
-            "version": "==0.2.5"
+            "version": "==0.2.6"
        }
    }
 }
--- a/README.md
+++ b/README.md
@ -1,35 +1,26 @@
 # KMK: Clackety Keyboards Powered by Python
-![GitHub](
-https://img.shields.io/github/license/KMKfw/kmk_firmware
-)![GitHub contributors](
-https://img.shields.io/github/contributors/KMKfw/kmk_firmware
-)![Discord](
-https://img.shields.io/discord/493256121075761173?logo=Discord
-)![Lines of code](https://img.shields.io/tokei/lines/github/KMKfw/kmk_firmware
-)![GitHub issues](https://img.shields.io/github/issues-raw/KMKfw/kmk_firmware
-)![GitHub closed issues](https://img.shields.io/github/issues-closed/KMKfw/kmk_firmware)
-
+![GitHub](https://img.shields.io/github/license/KMKfw/kmk_firmware)
+![GitHub contributors](https://img.shields.io/github/contributors/KMKfw/kmk_firmware)
+![Lines of code](https://img.shields.io/tokei/lines/github/KMKfw/kmk_firmware)
+![GitHub issues](https://img.shields.io/github/issues-raw/KMKfw/kmk_firmware)
+![GitHub closed issues](https://img.shields.io/github/issues-closed/KMKfw/kmk_firmware)

 KMK is a feature-rich and beginner-friendly firmware for computer keyboards
 written and configured in
-[CircuitPython](https://github.com/adafruit/circuitpython). **KMK is currently
-in public beta, however should handle most workflows without major issues**.
+[CircuitPython](https://github.com/adafruit/circuitpython).

-<!--
-@klardotsh 06 July 2021: commented for now because CDN builds have been broken
-for ages and folks are (reasonably) getting confused.
+## Support

-You can always find the latest releases on our CDN, in [compiled and
-optimized](https://cdn.kmkfw.io/kmk-latest.zip) and [raw, hackable text
-file](https://cdn.kmkfw.io/kmk-latest.unoptimized.zip) forms. These follow the
-`master` branch here on GitHub.
-->
+For asynchronous support and chatter about KMK, [join our Zulip
+community](https://kmkfw.zulipchat.com)!

-> If you need support with KMK or just want to say hi, find us in
-> [#kmkfw:klar.sh on Matrix](https://matrix.to/#/#kmkfw:klar.sh).  This channel
-> is bridged to Discord
-> [here](https://discordapp.com/widget?id=493256121075761173&theme=dark) for
-> convenience.
+If you ask for help in chat or open a bug report, if possible
+make sure your copy of KMK is up-to-date.
+In particular, swing by the Zulip chat *before* opening a GitHub Issue about
+configuration, documentation, etc. concerns.
+
+> The former Matrix and Discord rooms once linked to in this README are no
+> longer officially supported, please do not use them!

 ## Features

@ -37,37 +28,24 @@ file](https://cdn.kmkfw.io/kmk-latest.unoptimized.zip) forms. These follow the
  on a "flash-drive"-esque space on your microcontroller - edit on the go
  without DFU or other devtooling available!
 - Single-piece or [two-piece split
-  keyboards](https://github.com/KMKfw/kmk_firmware/blob/master/docs/split_keyboards.md)
+  keyboards](/docs/en/split_keyboards.md)
  are supported
 - [Chainable
-  keys](https://github.com/KMKfw/kmk_firmware/blob/master/docs/keys.md) such as
+  keys](/docs/en/keys.md) such as
  `KC.LWIN(KC.L)` to lock the screen on a Windows PC
- [Built-in unicode macros, including
-  emojis](https://github.com/KMKfw/kmk_firmware/blob/master/docs/sequences.md)
- [RGB underglow](https://github.com/KMKfw/kmk_firmware/blob/master/docs/rgb.md)
+- [Built-in Unicode macros, including
+  emojis](/docs/en/sequences.md)
+- [RGB underglow](/docs/en/rgb.md)
  and [LED
-  backlights](https://github.com/KMKfw/kmk_firmware/blob/master/docs/led.md)
+  backlights](/docs/en/led.md)
 - One key can turn into many more based on [how many times you tap
-  it](https://github.com/KMKfw/kmk_firmware/blob/master/docs/tapdance.md)
+  it](/docs/en/tapdance.md)
 - Bluetooth HID and split keyboards. No more wires.

 ## Getting Started
-
+KMK requires [CircuitPython](https://circuitpython.org/) version 7.0 or higher.
 Our getting started guide can be found
-[here](https://github.com/KMKfw/kmk_firmware/blob/master/docs/Getting_Started.md)
-
-## The KMK Team
-
-KMK is primarily written and maintained by @klardotsh and @kdb424, but
-contributions are welcome from all, whether it's in the form of code,
-documentation, hardware designs, feature ideas, or anything else that comes to
-mind. A list of KMK's contributors can be found [on
-GitHub](https://github.com/KMKfw/kmk_firmware/graphs/contributors).
-
-> While Adafruit employees and affiliates are occasionally found in the commit
-> log and their help has been crucial to KMK's success, KMK is not an official
-> Adafruit project, and the Core team is not compensated by Adafruit for its
-> development.
+[here](/docs/en/Getting_Started.md).

 ## Code Style

@ -80,11 +58,24 @@ found in `setup.cfg` loosening the rules in isolated cases, notably
 `user_keymaps` (which is *also* not subject to Black formatting for reasons
 documented in `pyproject.toml`).

+## Tests
+
+Unit tests within the `tests` folder mock various CircuitPython modules to allow
+them to be executed in a desktop development environment.
+
+Execute tests using the command `python -m unittest`.
+
 ## License, Copyright, and Legal

 All software in this repository is licensed under the [GNU Public License,
-verison 3](https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)).
+version 3](https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)).
 All documentation and hardware designs are licensed under the [Creative Commons
 Attribution-ShareAlike 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
 license. Contributions to this repository must use these licenses unless
 otherwise agreed to by the Core team.
+
+**Due to ethical and legal concerns, any works derived from GitHub Copilot or
+similar artificial intelligence tooling are unacceptable for inclusion in any
+first-party KMK repository or other code collection. We further recommend not
+using GitHub Copilot while developing anything KMK-related, regardless of
+intent to submit upstream.**
--- a/boards/Pico14/README.md
+++ b/boards/Pico14/README.md
@ -0,0 +1,10 @@
+# Pico 14 Numerical Keypad
+
+![Pico14](https://www.boltind.com/wp-content/uploads/2022/01/PXL_20220119_171113903-scaled.jpg)
+
+Pico 14 Numerical Keypad / Macro Pad PCB’s and Hardware Kit.
+
+`kb.py` is designed to work with the Pi Pico.
+
+Retailers:
+[Bolt Industries](https://www.boltind.com/product/pico-14-numerical-keypad-macro-pad-pcbs-and-hardware-kit/)
--- a/boards/Pico14/kb.py
+++ b/boards/Pico14/kb.py
@ -0,0 +1,23 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP0,
+        board.GP1,
+        board.GP2,
+    )
+
+    row_pins = (
+        board.GP18,
+        board.GP19,
+        board.GP20,
+        board.GP21,
+        board.GP22,
+    )
+
+    diode_orientation = DiodeOrientation.COLUMNS
+    led_pin = board.GP27
--- a/boards/Pico14/main.py
+++ b/boards/Pico14/main.py
@ -0,0 +1,56 @@
+from kb import KMKKeyboard
+
+from kmk.extensions.LED import LED
+from kmk.extensions.lock_status import LockStatus
+from kmk.keys import KC
+from kmk.modules.layers import Layers
+
+Pico14 = KMKKeyboard()
+
+
+class LEDLockStatus(LockStatus):
+    def __init__(self, leds):
+        super().__init__()
+        self._leds = leds
+
+    def set_lock_leds(self):
+        if self.get_num_lock():
+            self._leds.set_brightness(100, leds=[0])
+        else:
+            self._leds.set_brightness(0, leds=[0])
+
+    def after_hid_send(self, sandbox):
+        super().after_hid_send(sandbox)  # Critically important. Removing this will break lock status.
+
+        if self.report_updated:
+            self.set_lock_leds()
+
+
+Pico14.modules.append(Layers())
+leds = LED(led_pin=[Pico14.led_pin], val=0)
+Pico14.extensions.append(leds)
+Pico14.extensions.append(LEDLockStatus(leds))
+
+# Make this for better looking formatting...
+______ = KC.TRNS
+XXXXXX = KC.NO
+
+Pico14.keymap = [[
+  # Layer 0 QWERTY
+    KC.NUMLOCK,  KC.NUMPAD_SLASH, KC.NUMPAD_ASTERISK,
+    KC.NUMPAD_7, KC.NUMPAD_8,     KC.NUMPAD_9,
+    KC.NUMPAD_4, KC.NUMPAD_5,     KC.NUMPAD_6,
+    KC.NUMPAD_1, KC.NUMPAD_2,     KC.NUMPAD_1,
+    KC.NUMPAD_0, XXXXXX,          KC.NUMPAD_DOT
+  ], [
+  # Layer 1
+    ______,      ______,          ______,
+    KC.HOME,     KC.UP,           KC.PGUP,
+    KC.LEFT,     ______,          KC.RIGHT,
+    KC.END,      KC.DOWN,         KC.PGDN,
+    KC.INS,      XXXXXX,          KC.DEL
+  ]
+]
+
+if __name__ == '__main__':
+    Pico14.go()
--- a/boards/Pico87/kb.py
+++ b/boards/Pico87/kb.py
@ -0,0 +1,42 @@
+import board
+
+from kmk.extensions.LED import LED
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP0,
+        board.GP1,
+        board.GP2,
+        board.GP3,
+        board.GP4,
+        board.GP5,
+        board.GP6,
+        board.GP7,
+        board.GP8,
+        board.GP9,
+        board.GP10,
+        board.GP11,
+        board.GP12,
+        board.GP13,
+        board.GP14,
+        board.GP15,
+        board.GP16,
+        board.GP17,
+    )
+
+    row_pins = (
+        board.GP18,
+        board.GP19,
+        board.GP20,
+        board.GP21,
+        board.GP22,
+        board.GP26,
+    )
+
+    diode_orientation = DiodeOrientation.COLUMNS
+
+    leds = LED(led_pin=[board.GP27, board.GP28])
+    _KMKKeyboard.extensions.append(leds)
--- a/boards/Pico87/main.py
+++ b/boards/Pico87/main.py
@ -0,0 +1,60 @@
+import board
+
+from kb import KMKKeyboard
+
+from kmk.extensions.lock_status import LockStatus
+from kmk.extensions.stringy_keymaps import StringyKeymaps
+from kmk.keys import KC
+from kmk.modules.layers import Layers
+
+Pico87 = KMKKeyboard()
+
+
+class LEDLockStatus(LockStatus):
+    def set_lock_leds(self):
+        if self.get_caps_lock():
+            Pico87.leds.set_brightness(50, leds=[0])
+        else:
+            Pico87.leds.set_brightness(0, leds=[0])
+
+        if self.get_scroll_lock():
+            Pico87.leds.set_brightness(50, leds=[1])
+        else:
+            Pico87.leds.set_brightness(0, leds=[1])
+
+    def after_hid_send(self, sandbox):
+        super().after_hid_send(sandbox)  # Critically important. Removing this will break lock status.
+
+        if self.report_updated:
+            self.set_lock_leds()
+
+
+Pico87.modules.append(Layers())
+Pico87.extensions.append(LEDLockStatus())
+Pico87.extensions.append(StringyKeymaps())
+
+MOLYR = KC.MO(1)
+
+# Make this for better looking formatting...
+______ = 'NO'
+
+Pico87.keymap = [[
+  # Layer 0 QWERTY
+    'ESC', ______,   'F1',   'F2',   'F3',   'F4', ______,   'F5',   'F6',   'F7',   'F8',   'F9',  'F10',  'F11',  'F12', 'PSCR', 'SLCK', 'PAUS',
+    'GRV',   'N1',   'N2',   'N3',   'N4',   'N5',   'N6',   'N7',   'N8',   'N9',   'N0', 'MINS',  'EQL', ______, 'BSPC',  'INS', 'HOME', 'PGUP',
+    'TAB', ______,    'Q',    'W',    'E',    'R',    'T',    'Y',    'U',    'I',    'O',    'P', 'LBRC', 'RBRC', 'BSLS',  'DEL',  'END', 'PGDN',
+   'CAPS', ______,    'A',    'S',    'D',    'F',    'G',    'H',    'J',    'K',    'L', 'SCLN', 'QUOT',  'ENT', ______, ______, ______, ______,
+   ______, 'LSFT',    'Z',    'X',    'C',    'V',    'B',    'N',    'M', 'COMM',  'DOT', 'SLSH', ______, 'RSFT', ______, ______,   'UP', ______,
+   'LCTL', 'LGUI', ______, 'LALT', ______, ______,  'SPC', ______, ______, ______, 'RALT', 'RGUI', ______,  MOLYR, 'RCTL', 'LEFT', 'DOWN', 'RGHT',
+], [
+  # Layer 1
+    'ESC', ______,   'F1',   'F2',   'F3',   'F4', ______,   'F5',   'F6',   'F7',   'F8',   'F9',  'F10',  'F11',  'F12', 'PSCR', 'SLCK', 'PAUS',
+    'GRV',   'N1',   'N2',   'N3',   'N4',   'N5',   'N6',   'N7',   'N8',   'N9',   'N0', 'MINS',  'EQL', ______, 'BSPC',  'INS', 'HOME', 'PGUP',
+    'TAB', ______,    'Q',    'W',    'E',    'R',    'T',    'Y',    'U',    'I',    'O',    'P', 'LBRC', 'RBRC', 'BSLS',  'DEL',  'END', 'PGDN',
+   'CAPS', ______,    'A',    'S',    'D',    'F',    'G',    'H',    'J',    'K',    'L', 'SCLN', 'QUOT',  'ENT', ______, ______, ______, ______,
+   ______, 'LSFT',    'Z',    'X',    'C',    'V',    'B',    'N',    'M', 'COMM',  'DOT', 'SLSH', ______, 'RSFT', ______, ______,   'UP', ______,
+   'LCTL', 'LGUI', ______, 'LALT', ______, ______,  'SPC', ______, ______, ______, 'RALT', 'RGUI', ______,  MOLYR, 'RCTL', 'LEFT', 'DOWN', 'RGHT',
+]]
+
+if __name__ == '__main__':
+    Pico87.go()
--- a/boards/ZFR_KBD/RP2.65-F/kb.py
+++ b/boards/ZFR_KBD/RP2.65-F/kb.py
@ -0,0 +1,105 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.matrix import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.COL0,
+        board.COL1,
+        board.COL2,
+        board.COL3,
+        board.COL4,
+        board.COL5,
+        board.COL6,
+        board.COL7,
+    )
+    row_pins = (
+        board.ROW0,
+        board.ROW1,
+        board.ROW2,
+        board.ROW3,
+        board.ROW4,
+        board.ROW5,
+        board.ROW6,
+        board.ROW7,
+        board.ROW8,
+        board.ROW9,
+    )
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.LED
+    rgb_num_pixels = 70
+
+    coord_mapping = [
+        0,
+        8,
+        1,
+        9,
+        2,
+        10,
+        3,
+        11,
+        4,
+        12,
+        5,
+        13,
+        6,
+        14,
+        7,
+        15,
+        24,
+        17,
+        25,
+        18,
+        26,
+        19,
+        27,
+        20,
+        28,
+        21,
+        29,
+        22,
+        23,
+        31,
+        40,
+        33,
+        41,
+        34,
+        42,
+        35,
+        43,
+        36,
+        44,
+        37,
+        45,
+        38,
+        46,
+        39,
+        47,
+        56,
+        49,
+        57,
+        50,
+        58,
+        51,
+        59,
+        52,
+        60,
+        53,
+        61,
+        54,
+        55,
+        63,
+        72,
+        65,
+        73,
+        74,
+        75,
+        76,
+        69,
+        77,
+        78,
+        71,
+        79,
+    ]
--- a/boards/anavi/anavi-arrows/README.md
+++ b/boards/anavi/anavi-arrows/README.md
@ -0,0 +1,12 @@
+# ANAVI Arrows
+
+ANAVI Arrows is an open source, programmable mechanical keyboard with 4 hot-swappable mechanical switches, RGB WS2812B underlighting and yellow backlit a rotary encoder, [Seeed XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html) and a mini OLED I2C yellow-blue display.
+
+ANAVI Arrows has been designed with the cross platform and open source electronics design automation suite KiCad. All KiCad [files and schematics are available at GitHub](https://github.com/anavitechnology/anavi-arrows) under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Extensions enabled by default:
+- [Encoder](/docs/en/encoder.md) Twist control for all the things
+- [LED](/docs/en/led.md) Light your keys up (for backlit)
+- [RGB](/docs/en/rgb.md) Light it up (for underlighting)
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
+- [PEG_OLED](/docs/peg_oled_display.md) Show information on the mini OLED display
--- a/boards/anavi/anavi-arrows/arrows.py
+++ b/boards/anavi/anavi-arrows/arrows.py
@ -0,0 +1,20 @@
+'''
+KMK keyboard for ANAVI Arrows
+
+This is a macro pad with 4 mechanical switches based on the RP2040. Each key is
+attached to a single GPIO, so the KMK matrix scanner needs to be overridden.
+'''
+
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard
+from kmk.scanners.keypad import KeysScanner
+
+
+class AnaviArrows(KMKKeyboard):
+    '''
+    Default keyboard config for ANAVI Arrows.
+    '''
+
+    def __init__(self):
+        self.matrix = KeysScanner([board.D1, board.D2, board.D3, board.D6])
--- a/boards/anavi/anavi-arrows/code.py
+++ b/boards/anavi/anavi-arrows/code.py
@ -0,0 +1,90 @@
+import board
+
+from arrows import AnaviArrows
+
+from kmk.extensions.LED import LED
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.peg_oled_Display import (
+    Oled,
+    OledData,
+    OledDisplayMode,
+    OledReactionType,
+)
+from kmk.extensions.RGB import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.modules.encoder import EncoderHandler
+
+keyboard = AnaviArrows()
+
+# I2C pins for the mini OLED display
+keyboard.SCL = board.D5
+keyboard.SDA = board.D4
+
+# fmt: off
+keyboard.keymap = [
+    [
+        KC.RIGHT, KC.DOWN, KC.LEFT, KC.UP,
+    ]
+]
+# fmt: on
+
+oled_ext = Oled(
+    OledData(
+        corner_one={0: OledReactionType.STATIC, 1: ['ANAVI Arrows']},
+        corner_two={0: OledReactionType.STATIC, 1: [' ']},
+        corner_three={0: OledReactionType.STATIC, 1: ['Open Source']},
+        corner_four={0: OledReactionType.STATIC, 1: [' ']},
+    ),
+    oWidth=128,
+    oHeight=64,
+    toDisplay=OledDisplayMode.TXT,
+    flip=False,
+)
+keyboard.extensions.append(oled_ext)
+
+led_ext = LED(
+    led_pin=[
+        board.D0,
+    ],
+    brightness=100,
+    brightness_step=5,
+    brightness_limit=100,
+    breathe_center=1.5,
+    animation_mode=AnimationModes.STATIC,
+    animation_speed=1,
+    user_animation=None,
+    val=100,
+)
+keyboard.extensions.append(led_ext)
+
+# WS2812B LED strips on the back
+underglow = RGB(
+    pixel_pin=board.D10,
+    num_pixels=4,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(underglow)
+
+# Neopixel on XIAO RP2040
+frontglow = RGB(
+    pixel_pin=board.NEOPIXEL,
+    num_pixels=1,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(frontglow)
+
+media_keys = MediaKeys()
+keyboard.extensions.append(media_keys)
+
+# Rotary encoder that also acts as a key
+encoder_handler = EncoderHandler()
+encoder_handler.pins = ((board.D8, board.D7, board.D9),)
+encoder_handler.map = (((KC.VOLD, KC.VOLU, KC.MUTE),),)
+keyboard.modules.append(encoder_handler)
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/anavi/knob1/README.md
+++ b/boards/anavi/knob1/README.md
@ -0,0 +1,10 @@
+# ANAVI Knob 1
+
+ANAVI Knob 1 is an open source, programmable mechanical keyboard with a single rotary encoder and [Seeed XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html).
+
+ANAVI Knob 1 is open source hardware designed with KiCad. All KiCad [files and schematics are available at GitHub](https://github.com/AnaviTechnology/anavi-knob-1) under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Extensions enabled by default:
+- [Encoder](/docs/en/encoder.md) Twist control for all the things
+- [RGB](/docs/en/rgb.md) Light it up (for underlighting)
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/anavi/knob1/init.py
+++ b/boards/anavi/knob1/init.py
--- a/boards/anavi/knob1/code.py
+++ b/boards/anavi/knob1/code.py
@ -0,0 +1,35 @@
+import board
+
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.RGB import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.kmk_keyboard import KMKKeyboard
+from kmk.modules.encoder import EncoderHandler
+from kmk.scanners.keypad import KeysScanner
+
+knob = KMKKeyboard()
+knob.matrix = KeysScanner([])
+
+media_keys = MediaKeys()
+knob.extensions.append(media_keys)
+
+# Rotary encoder that also acts as a key
+encoder_handler = EncoderHandler()
+encoder_handler.divisor = 2
+encoder_handler.pins = ((board.D1, board.D2, board.D0),)
+encoder_handler.map = (((KC.VOLD, KC.VOLU, KC.MUTE),),)
+knob.modules.append(encoder_handler)
+
+rgb_ext = RGB(
+    pixel_pin=board.NEOPIXEL,
+    num_pixels=1,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+knob.extensions.append(rgb_ext)
+
+knob.keymap = [[KC.MUTE]]
+
+if __name__ == '__main__':
+    knob.go()
--- a/boards/anavi/knobs3/README.md
+++ b/boards/anavi/knobs3/README.md
@ -0,0 +1,10 @@
+# ANAVI Knobs 3
+
+ANAVI Knobs 3 is an open source, programmable mechanical keyboard with 3 rotary encoders and [Seeed XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html).
+
+ANAVI Knobs 3 is open source hardware designed with KiCad. All KiCad [files and schematics are available at GitHub](https://github.com/AnaviTechnology/anavi-knobs-3) under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Extensions enabled by default:
+- [Encoder](/docs/en/encoder.md) Twist control for all the things
+- [RGB](/docs/en/rgb.md) Light it up (for underlighting)
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/anavi/knobs3/init.py
+++ b/boards/anavi/knobs3/init.py
--- a/boards/anavi/knobs3/code.py
+++ b/boards/anavi/knobs3/code.py
@ -0,0 +1,43 @@
+import board
+
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.RGB import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.kmk_keyboard import KMKKeyboard
+from kmk.modules.encoder import EncoderHandler
+from kmk.scanners.keypad import KeysScanner
+
+knob = KMKKeyboard()
+knob.matrix = KeysScanner([])
+
+media_keys = MediaKeys()
+knob.extensions.append(media_keys)
+
+# Rotary encoders that also acts as keys
+encoder_handler = EncoderHandler()
+encoder_handler.divisor = 2
+encoder_handler.pins = (
+    (board.D1, board.D2, board.D0),
+    (board.D9, board.D10, board.D3),
+    (board.D7, board.D8, board.D6),
+)
+encoder_handler.map = (
+    ((KC.VOLD, KC.VOLU, KC.MUTE), (KC.UP, KC.DOWN, KC.A), (KC.RIGHT, KC.LEFT, KC.B)),
+)
+knob.modules.append(encoder_handler)
+
+print('ANAVI Knobs 3')
+
+rgb_ext = RGB(
+    pixel_pin=board.NEOPIXEL,
+    num_pixels=1,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+knob.extensions.append(rgb_ext)
+
+knob.keymap = [[KC.MUTE]]
+
+if __name__ == '__main__':
+    knob.go()
--- a/boards/anavi/macro-pad-10/README.md
+++ b/boards/anavi/macro-pad-10/README.md
@ -0,0 +1,11 @@
+# ANAVI Macro Pad 10
+
+ANAVI Macro Pad 10 is an open source, programmable mechanical keyboard with 9 hot-swappable mechanical switches, RGB WS2812B underlighting and yellow backlit a rotary encoder and [Seeed XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html).
+
+ANAVI Macro Pad 10 has been designed with the cross platform and open source electronics design automation suite KiCad. All KiCad [files and schematics are available at GitHub](https://github.com/anavitechnology/anavi-macro-pad-10) under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Extensions enabled by default:
+- [Encoder](/docs/en/encoder.md) Twist control for all the things
+- [LED](/docs/en/led.md) Light your keys up (for backlit)
+- [RGB](/docs/en/rgb.md) Light it up (for underlighting)
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/anavi/macro-pad-10/code.py
+++ b/boards/anavi/macro-pad-10/code.py
@ -0,0 +1,87 @@
+import board
+
+from kmk.extensions.LED import LED
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.RGB import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.kmk_keyboard import KMKKeyboard
+from kmk.modules.encoder import EncoderHandler
+from kmk.scanners import DiodeOrientation
+
+print('ANAVI Macro Pad 10')
+
+keyboard = KMKKeyboard()
+led_ext = LED(
+    led_pin=[
+        board.D0,
+    ],
+    brightness=100,
+    brightness_step=5,
+    brightness_limit=100,
+    breathe_center=1.5,
+    animation_mode=AnimationModes.STATIC,
+    animation_speed=1,
+    user_animation=None,
+    val=100,
+)
+keyboard.extensions.append(led_ext)
+
+# WS2812B LED strips on the back
+underglow = RGB(
+    pixel_pin=board.D10,
+    num_pixels=4,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(underglow)
+
+# Neopixel on XIAO RP2040
+frontglow = RGB(
+    pixel_pin=board.NEOPIXEL,
+    num_pixels=1,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(frontglow)
+
+keyboard.col_pins = (
+    board.D4,
+    board.D5,
+    board.D6,
+)
+keyboard.row_pins = (
+    board.D3,
+    board.D2,
+    board.D1,
+)
+keyboard.diode_orientation = DiodeOrientation.COL2ROW
+
+media_keys = MediaKeys()
+keyboard.extensions.append(media_keys)
+
+# Matrix 3x3 keymap, 9 keys in total
+keyboard.keymap = [
+    [
+        KC.N1,
+        KC.N2,
+        KC.N3,
+        KC.N4,
+        KC.N5,
+        KC.N6,
+        KC.N7,
+        KC.N8,
+        KC.N9,
+    ]
+]
+
+# Rotary encoder that also acts as a key
+encoder_handler = EncoderHandler()
+encoder_handler.divisor = 2
+encoder_handler.pins = ((board.D8, board.D7, board.D9),)
+encoder_handler.map = (((KC.VOLD, KC.VOLU, KC.MUTE),),)
+keyboard.modules.append(encoder_handler)
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/anavi/macro-pad-12/README.md
+++ b/boards/anavi/macro-pad-12/README.md
@ -0,0 +1,12 @@
+# ANAVI Macro Pad 12
+
+ANAVI Macro Pad 12 is an open source, programmable mechanical keyboard with 9 hot-swappable mechanical switches, RGB WS2812B underlighting and yellow backlit a rotary encoder and [Seeed XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html).
+
+ANAVI Macro Pad 12 has been designed with the cross platform and open source electronics design automation suite KiCad. All KiCad [files and schematics are available at GitHub](https://github.com/anavitechnology/anavi-macro-pad-12) under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+Extensions enabled by default:
+- [Encoder](/docs/en/encoder.md) Twist control for all the things
+- [LED](/docs/en/led.md) Light your keys up (for backlit)
+- [RGB](/docs/en/rgb.md) Light it up (for underlighting)
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
+- [PEG_OLED](/docs/peg_oled_display.md) Show information on the mini OLED display
--- a/boards/anavi/macro-pad-12/code.py
+++ b/boards/anavi/macro-pad-12/code.py
@ -0,0 +1,97 @@
+import board
+
+from kmk.extensions.LED import LED
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.peg_oled_Display import (
+    Oled,
+    OledData,
+    OledDisplayMode,
+    OledReactionType,
+)
+from kmk.extensions.RGB import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.kmk_keyboard import KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+keyboard = KMKKeyboard()
+
+# I2C pins for the mini OLED display
+keyboard.SCL = board.D5
+keyboard.SDA = board.D4
+
+oled_ext = Oled(
+    OledData(
+        corner_one={0: OledReactionType.STATIC, 1: ['ANAVI Macro Pad 12']},
+        corner_two={0: OledReactionType.STATIC, 1: [' ']},
+        corner_three={0: OledReactionType.STATIC, 1: ['Open Source']},
+        corner_four={0: OledReactionType.STATIC, 1: [' ']},
+    ),
+    oWidth=128,
+    oHeight=64,
+    toDisplay=OledDisplayMode.TXT,
+    flip=False,
+)
+keyboard.extensions.append(oled_ext)
+
+led_ext = LED(
+    led_pin=[
+        board.D0,
+    ],
+    brightness=100,
+    brightness_step=5,
+    brightness_limit=100,
+    breathe_center=1.5,
+    animation_mode=AnimationModes.STATIC,
+    animation_speed=1,
+    user_animation=None,
+    val=100,
+)
+keyboard.extensions.append(led_ext)
+
+# WS2812B LED strips on the back
+underglow = RGB(
+    pixel_pin=board.D10,
+    num_pixels=6,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(underglow)
+
+# Neopixel on XIAO RP2040
+frontglow = RGB(
+    pixel_pin=board.NEOPIXEL,
+    num_pixels=1,
+    val_limit=100,
+    val_default=25,
+    animation_mode=AnimationModes.RAINBOW,
+)
+keyboard.extensions.append(frontglow)
+
+keyboard.col_pins = (board.D6, board.D8, board.D9)
+keyboard.row_pins = (board.D1, board.D2, board.D3, board.D7)
+keyboard.diode_orientation = DiodeOrientation.COL2ROW
+
+media_keys = MediaKeys()
+keyboard.extensions.append(media_keys)
+
+# Matrix 4x3 keymap, 12 keys in total
+keyboard.keymap = [
+    [
+        KC.N1,
+        KC.N2,
+        KC.N3,
+        KC.N4,
+        KC.N5,
+        KC.N6,
+        KC.N7,
+        KC.N8,
+        KC.N9,
+        KC.N0,
+        KC.A,
+        KC.B,
+    ]
+]
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/atreus62/README.md
+++ b/boards/atreus62/README.md
@ -10,7 +10,7 @@ Retailers (USA)
 [Atreus62](https://shop.profetkeyboards.com/product/atreus62-keyboard)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) Light it up
- [Encoder](https://github.com/KMKfw/kmk_firmware/tree/master/docs/encoder.md) Twist control for all the things
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [Encoder](/docs/en/encoder.md) Twist control for all the things

--- a/boards/atreus62/kb.py
+++ b/boards/atreus62/kb.py
@ -1,9 +1,7 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-
-# from kmk.matrix import intify_coordinate as ic
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
--- a/boards/atreus62/main.py
+++ b/boards/atreus62/main.py
@ -20,28 +20,13 @@ Zoom_out = KC.LCTRL(KC.MINUS)
 _______ = KC.TRNS
 XXXXXXX = KC.NO

-#  for use in the encoder extension
-encoder_map = [
-    [
-        (
-            KC.VOLU,
-            KC.VOLD,
-            2,
-        ),  #  Only 1 encoder is being used, so only one tuple per layer is required
-    ],
-    [
-        (Zoom_in, Zoom_out, 1),
-    ],
-    [
-        (_______, _______, 1),  #  no action taken by the encoder on this layer
-    ],
-]

 layers_ext = Layers()

-encoder_ext = EncoderHandler([board.D40], [board.D41], encoder_map)
-encoder_ext.encoders[0].is_inverted = True
-
+# 1 encoder, no button, inversed = True
+encoder_ext = EncoderHandler(
+    (board.D40, board.D41, None, True),
+)
 keyboard.modules = [layers_ext, encoder_ext]

 keyboard.tap_time = 250
@ -216,5 +201,23 @@ keyboard.keymap = [
    ],
 ]

+
+#  for use in the encoder extension
+encoder_map = [
+    [
+        (
+            KC.VOLU,
+            KC.VOLD,
+            None,
+        ),  #  Only 1 encoder is being used, so only one tuple per layer is required
+    ],
+    [
+        (Zoom_in, Zoom_out, None),
+    ],
+    [
+        (_______, _______, None),  #  no action taken by the encoder on this layer
+    ],
+]
+
 if __name__ == '__main__':
    keyboard.go()
--- a/boards/boardsource/3x4/README.md
+++ b/boards/boardsource/3x4/README.md
@ -10,4 +10,12 @@ Retailers (USA)
 [Boardsource](https://boardsource.xyz/store/5ecc2008eee64242946c98c1)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/boardsource/3x4/kb.py
+++ b/boards/boardsource/3x4/kb.py
@ -1,12 +1,12 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P1_15, board.P0_02, board.P0_29)
-    col_pins = (board.P0_09, board.P0_10, board.P1_11, board.P1_13)
+    row_pins = (pins[16], pins[17], pins[18])
+    col_pins = (pins[12], pins[13], pins[14], pins[15])
    diode_orientation = DiodeOrientation.COLUMNS
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/boardsource/3x4/main.py
+++ b/boards/boardsource/3x4/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.keys import KC
 from kmk.modules.layers import Layers

--- a/boards/boardsource/4x12/README.md
+++ b/boards/boardsource/4x12/README.md
@ -3,9 +3,9 @@
 ![Boardsource4x12](https://boardsource.imgix.net/164c3388-5057-46c8-8fcd-82c58c7870ce.jpg?raw=true)
 ![Boardsource4x12LP](https://boardsource.imgix.net/c2108ea4-7d70-4327-b4b4-88c8191b1369.jpg?raw=true)

-The 4x12 ortholinear keyboard is an extremely common and beloved layout within the keyboard community. Made popular by Jack's Planck from OLKB, the 4x12 ortholinear layout is possibly the most popular non-stagger layout available.  
-
-kb.py is designed to work with the nice!nano  
+The 4x12 ortholinear keyboard is an extremely common and beloved layout within
+the keyboard community. Made popular by Jack's Planck from OLKB, the 4x12
+ortholinear layout is possibly the most popular non-staggered layout available.

 Retailers (USA)  
 4x12  
@ -14,8 +14,15 @@ Low profile 4x12
 [Boardsource](https://boardsource.xyz/store/5ecb7dad86879c9a0c22db32)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [MediaKeys](https://github.com/KMKfw/kmk_firmware/tree/master/docs/media_keys.md) Control volume and other media functions
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions

 Common Extensions
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
--- a/boards/boardsource/4x12/kb.py
+++ b/boards/boardsource/4x12/kb.py
@ -1,25 +1,25 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P0_08, board.P0_06, board.P0_17, board.P0_20)
+    row_pins = (board.pins[1], pins[0], board.pins[4], board.pins[5])
    col_pins = (
-        board.P0_31,
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
-        board.P1_06,
-        board.P1_04,
-        board.P0_11,
-        board.P1_00,
+        board.pins[19],
+        board.pins[18],
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
+        board.pins[13],
+        board.pins[12],
+        board.pins[11],
+        board.pins[10],
+        board.pins[9],
+        board.pins[8],
    )
    diode_orientation = DiodeOrientation.COLUMNS
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/boardsource/4x12/main.py
+++ b/boards/boardsource/4x12/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.media_keys import MediaKeys
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/boardsource/5x12/README.md
+++ b/boards/boardsource/5x12/README.md
@ -3,9 +3,12 @@
 ![Boardsource5x12](https://boardsource.imgix.net/74abb511-792e-42d9-9f6e-8100c521b2e0.jpg?raw=true)
 ![Boardsource5x12LP](https://boardsource.imgix.net/57ad3f69-3c88-4ae8-9592-6e4d2f45a58e.jpg?raw=true)

-5x12 ortholinear -- for when just really don't want to give up your number row. The 5x12 ortholinear keyboard is a common ortholinear layout that many people prefer because it includes a number row. Made popular by Jack's Preonic from OLKB, the 5x12 ortholinear layout is a great option for those who want to try ortholinear but feel they aren't ready to make the jump to a 40%. The 5x12 Ortho is an approachable keyboard with hotswap compatibility.  
-
-kb.py is designed to work with the nice!nano  
+5x12 ortholinear -- for when just really don't want to give up your number row.
+The 5x12 ortholinear keyboard is a common ortholinear layout that many people
+prefer because it includes a number row. Made popular by Jack's Preonic from
+OLKB, the 5x12 ortholinear layout is a great option for those who want to try
+ortholinear but feel they aren't ready to make the jump to a 40%. The 5x12 Ortho
+is an approachable keyboard with hotswap compatibility.

 Retailers (USA)  
 5x12  
@ -14,8 +17,15 @@ Low Profile 5x12
 [Boardsource](https://boardsource.xyz/store/5ecb822386879c9a0c22db84)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [MediaKeys](https://github.com/KMKfw/kmk_firmware/tree/master/docs/media_keys.md) Control volume and other media functions
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions

 Common Extensions
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
--- a/boards/boardsource/5x12/kb.py
+++ b/boards/boardsource/5x12/kb.py
@ -1,25 +1,25 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P0_08, board.P0_06, board.P0_17, board.P0_20, board.P0_22)
+    row_pins = (board.pins[1], pins[0], board.pins[4], board.pins[5], board.pins[6])
    col_pins = (
-        board.P0_31,
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
-        board.P1_06,
-        board.P1_04,
-        board.P0_11,
-        board.P1_00,
+        board.pins[19],
+        board.pins[18],
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
+        board.pins[13],
+        board.pins[12],
+        board.pins[11],
+        board.pins[10],
+        board.pins[9],
+        board.pins[8],
    )
    diode_orientation = DiodeOrientation.COLUMNS
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/boardsource/5x12/main.py
+++ b/boards/boardsource/5x12/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.media_keys import MediaKeys
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/boardsource/Lulu/README.md
+++ b/boards/boardsource/Lulu/README.md
@ -0,0 +1,21 @@
+# Lulu
+
+![Lulu](https://boardsource.imgix.net/c93fba70-71bc-11ec-bb73-09003ca81902.jpg?raw=true)
+
+Based on the form factor of the Lily58, but with new features. The Lulu is a 58 key split keyboard design by Boardsource, featuring a 6x4 columnar stagger and 4 thumb cluster keys on each hand. The Lulu is a perfect choice for people who want to be on a split keyboard but still want to have a fairly standard amount of keys, and a premium case avaliable.
+
+Hardware Availability: [PCB & Case Source](https://boardsource.xyz/store/5ec9df84c6b834480de6c3d0)  
+kb.py is designed to work with the PCBA version directly from them.
+
+Retailers (USA)  
+[Boardsource](https://boardsource.xyz/store/5ec9df84c6b834480de6c3d0)  
+
+Extensions enabled by default  
+- [Split](/docs/en/split.md) Connects halves using a wire.
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [PEG_RGB](/docs/en/peg_rgb_matrix.md) Light it up!
+- [PEG_OLED](/docs/en/peg_oled_display.md) Screens to see things on of course.
+
+Common Extensions
+- [Power](/docs/en/power.md) Powersaving features for battery life.
+- [BLE_Split](/docs/en/split.md) Connects halves without wires (For the DIY version)
--- a/boards/boardsource/Lulu/kb.py
+++ b/boards/boardsource/Lulu/kb.py
@ -0,0 +1,73 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+from kmk.scanners.encoder import RotaryioEncoder
+from kmk.scanners.keypad import MatrixScanner
+
+
+class KMKKeyboard(_KMKKeyboard):
+    def __init__(self):
+        # create and register the scanner
+        self.matrix = [
+            MatrixScanner(
+                # required arguments:
+                column_pins = self.col_pins,
+                row_pins = self.row_pins,
+                # optional arguments with defaults:
+                columns_to_anodes=DiodeOrientation.COL2ROW,
+                interval=0.02,
+                max_events=64
+            ),
+            RotaryioEncoder(
+                pin_a=board.GP08,
+                pin_b=board.GP09,
+                # optional
+                divisor=4,
+            )
+        ]
+    col_pins = (
+        board.GP02,
+        board.GP03,
+        board.GP04,
+        board.GP05,
+        board.GP06,
+        board.GP07,
+    )
+    row_pins = (board.GP14, board.GP15, board.GP16, board.GP17, board.GP18)
+    diode_orientation = DiodeOrientation.COLUMNS
+    rx = board.RX
+    tx = board.TX
+    rgb_pixel_pin = board.GP29
+    i2c = board.I2C
+    data_pin = board.RX
+    rgb_pixel_pin = board.GP29
+    i2c = board.I2C
+    SCL=board.SCL
+    SDA=board.SDA
+    encoder_a=board.GP08
+    encoder_b=board.GP09
+    # NOQA
+    # flake8: noqa
+    led_key_pos =[11,10,9 ,8 ,7 ,6 ,      41,42,43,44,45,46,
+                12,13,14,15,16,17,      52,51,50,49,48,47,
+                23,22,21,20,19,18,      53,54,55,56,57,58,
+                24,25,26,27,28,29,30,65,64,63,62,61,60,59,
+                         34,33,32,31,66,67,68,69,
+                         3 ,4 ,5 ,      40,39,38,
+                         2 ,1 ,0 ,      35,36,37
+                         ]
+    brightness_limit = 0.5
+    num_pixels = 70
+
+    # NOQA
+    # flake8: noqa
+    coord_mapping = [
+     0,  1,  2,  3,  4,  5,         37, 36, 35, 34, 33, 32,
+     6,  7,  8,  9, 10, 11,         43, 42, 41, 40, 39, 38,
+    12, 13, 14, 15, 16, 17,         49, 48, 47, 46, 45, 44,
+    18, 19, 20, 21, 22, 23, 29, 61, 55, 54, 53, 52, 51, 50,
+             25,26, 27, 28,         60, 59, 58, 57,
+                    30,31,          62,63 
+    ]
+
--- a/boards/boardsource/Lulu/main.py
+++ b/boards/boardsource/Lulu/main.py
@ -0,0 +1,230 @@
+import supervisor
+
+from kb import KMKKeyboard
+
+from kmk.extensions.peg_oled_Display import (
+    Oled,
+    OledData,
+    OledDisplayMode,
+    OledReactionType,
+)
+from kmk.extensions.peg_rgb_matrix import Rgb_matrix
+from kmk.handlers.sequences import send_string
+from kmk.hid import HIDModes
+from kmk.keys import KC
+from kmk.modules.holdtap import HoldTap
+from kmk.modules.layers import Layers
+from kmk.modules.split import Split, SplitSide, SplitType
+
+keyboard = KMKKeyboard()
+holdtap = HoldTap()
+layers_ext = Layers()
+keyboard.modules.append(layers_ext)
+keyboard.modules.append(holdtap)
+
+oled_ext = Oled(
+    OledData(
+        corner_one={0: OledReactionType.STATIC, 1: ['qwertyzzzz']},
+        corner_two={
+            0: OledReactionType.LAYER,
+            1: ['1', '2', '3', '4', '5', '6', '7', '8'],
+        },
+        corner_three={
+            0: OledReactionType.LAYER,
+            1: ['base', 'raise', 'lower', 'adjust', '5', '6', '7', '8'],
+        },
+        corner_four={
+            0: OledReactionType.LAYER,
+            1: ['qwertyzzz', 'nums', 'shifted', 'leds', '5', '6', '7', '8'],
+        },
+    ),
+    toDisplay=OledDisplayMode.TXT,
+    flip=False,
+)
+keyboard.extensions.append(oled_ext)
+
+# Default RGB matrix colours
+rgb_ext = Rgb_matrix(
+    ledDisplay=[
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+        [85, 0, 255],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [0, 255, 234],
+        [85, 0, 255],
+    ],
+    split=True,
+    rightSide=False,
+    disable_auto_write=True,
+)
+keyboard.extensions.append(rgb_ext)
+
+# TODO Comment one of these on each side
+split_side = SplitSide.LEFT
+# split_side = SplitSide.RIGHT
+split = Split(data_pin=keyboard.rx, data_pin2=keyboard.tx, uart_flip=False)
+keyboard.modules.append(split)
+
+keyboard.keymap = [
+    [
+        KC.ESC,  KC.N1,   KC.N2,   KC.N3,    KC.N4,   KC.N5,                    KC.N6,   KC.N7,    KC.N8,   KC.N9, KC.N0,    KC.GRV,
+        KC.TAB,  KC.Q,    KC.W,    KC.E,     KC.R,    KC.T,                     KC.Y,    KC.U,     KC.I,    KC.O,  KC.P,     KC.MINS,
+        KC.LCTL, KC.A,    KC.S,    KC.D,     KC.F,    KC.G,                     KC.H,    KC.J,     KC.K,    KC.L,  KC.SCLN,  KC.QUOT,
+        KC.LSFT, KC.Z,    KC.X,    KC.C,     KC.V,    KC.B,   KC.LBRC, KC.RBRC, KC.N,    KC.M,  KC.COMMA, KC.DOT,  KC.SLSH,  KC.RSFT,
+                                   KC.LGUI, KC.MO(1), KC.LCTL, KC.SPC, KC.ENT,  KC.MO(2), KC.BSPC, KC.RGUI,
+        # Encoders
+        KC.AUDIO_VOL_UP,
+        KC.AUDIO_VOL_DOWN,
+        KC.MEDIA_PREV_TRACK,
+        KC.MEDIA_NEXT_TRACK,
+    ],
+    [
+        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.TRNS, KC.TRNS, KC.UP,   KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.EQL, KC.TRNS,
+        KC.TRNS, KC.LEFT, KC.DOWN, KC.RGHT, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.DEL,  KC.TRNS,
+        # Encoders
+        KC.AUDIO_VOL_UP,
+        KC.AUDIO_VOL_DOWN,
+        KC.MEDIA_PREV_TRACK,
+        KC.MEDIA_NEXT_TRACK,
+    ],
+    [
+        KC.N2,   KC.EXLM, KC.AT,   KC.HASH, KC.DLR,  KC.PERC,                   KC.CIRC, KC.AMPR, KC.ASTR, KC.LPRN, KC.RPRN, KC.TILD,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.PLUS, KC.UNDS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.COLN, KC.DQT,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.LCBR, KC.RCBR, KC.TRNS, KC.TRNS, KC.LABK, KC.RABK, KC.QUES, KC.TRNS,
+                                   KC.LGUI, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.AUDIO_VOL_UP,
+        KC.AUDIO_VOL_DOWN,
+        KC.MEDIA_PREV_TRACK,
+        KC.MEDIA_NEXT_TRACK,
+    ],
+    [
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        # Encoders
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+    ],
+    [
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        # Encoders
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+    ],
+    [
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        # Encoders
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+    ],
+    [
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        # Encoders
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+    ],
+    [
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+                                   KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS, KC.TRNS,
+        # Encoders
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+        KC.TRNS,
+    ],
+]
+if __name__ == '__main__':
+    keyboard.go(hid_type=HIDModes.USB)
--- a/boards/boardsource/microdox/README.md
+++ b/boards/boardsource/microdox/README.md
@ -2,18 +2,26 @@

 ![microdox](https://boardsource.imgix.net/337ae65a-d061-46a4-b119-9916b043c58f.jpg?raw=true)

-The Microdox is is a feature-packed 30% split columnar staggered keyboard. Even though the Microdox is an extremely small keyboard it offers tons of features from larger boards while maintaining a tiny footprint.  
-
-kb.py is designed to work with the nice!nano  
+The Microdox is is a feature-packed 30% split columnar staggered keyboard. Even
+though the Microdox is an extremely small keyboard it offers tons of features
+from larger boards while maintaining a tiny footprint.

 Retailers (USA)  
 [Boardsource](https://boardsource.xyz/store/5f2e7e4a2902de7151494f92)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
- [ModTap](https://github.com/KMKfw/kmk_firmware/tree/master/docs/modtap.md) Allows mod keys to act as different keys when tapped.
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires
+- [HoldTap](/docs/en/holdtap.md) Allows mod keys to act as different keys when tapped.

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/enpower.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/boardsource/microdox/kb.py
+++ b/boards/boardsource/microdox/kb.py
@ -1,24 +1,31 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    col_pins = (board.P0_31, board.P0_29, board.P0_02, board.P1_15, board.P1_13)
-    row_pins = (board.P0_10, board.P0_09, board.P1_04, board.P1_06)
+    col_pins = (
+        board.pins[19],
+        board.pins[18],
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+    )
+    row_pins = (board.pins[13], board.pins[12], board.pins[10], board.pins[11])
    diode_orientation = DiodeOrientation.COLUMNS
-    data_pin = board.P0_08
-    rgb_pixel_pin = board.P0_06
+    data_pin = board.pins[1]
+    rgb_pixel_pin = pins[0]
    rgb_num_pixels = 12
    i2c = board.I2C
-    powersave_pin = board.P0_13

-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(10))
-    coord_mapping.extend(ic(1, x) for x in range(10))
-    coord_mapping.extend(ic(2, x) for x in range(10))
-
-    # And now, to handle R3, which at this point is down to just six keys
-    coord_mapping.extend(ic(3, x) for x in range(3, 9))
+    # NOQA
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+     0,  1,  2,  3,  4,  20, 21, 22, 23, 24,
+     5,  6,  7,  8,  9,  25, 26, 27, 28, 29,
+    10, 11, 12, 13, 14,  30, 31, 32, 33, 34,
+            17, 18, 19,  35, 36, 37,
+    ]
--- a/boards/boardsource/microdox/main.py
+++ b/boards/boardsource/microdox/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.keys import KC
 from kmk.modules.layers import Layers
 from kmk.modules.split import Split, SplitSide, SplitType
--- a/boards/crkbd/README.md
+++ b/boards/crkbd/README.md
@ -6,8 +6,6 @@

 A split keyboard with a 3x6 columnar stagger and 3 thumb keys.

-kb.py is designed to work with the nice!nano
-
 Hardware Availability: [PCB & Case Source](https://github.com/foostan/crkbd)  

 Retailers (USA)  
@ -18,10 +16,18 @@ Corne LP
 [Boardsource](https://boardsource.xyz/store/5f2efc462902de7151495057)  

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) Light it up
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/crkbd/kb.py
+++ b/boards/crkbd/kb.py
@ -1,30 +1,35 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
    col_pins = (
-        board.P0_31,
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
+        pins[19],
+        pins[18],
+        pins[17],
+        pins[16],
+        pins[15],
+        pins[14],
+    )
+    row_pins = (
+        pins[6],
+        pins[7],
+        pins[8],
+        pins[9],
    )
-    row_pins = (board.P0_22, board.P0_24, board.P1_00, board.P0_11)
    diode_orientation = DiodeOrientation.COLUMNS
-    data_pin = board.P0_08
-    rgb_pixel_pin = board.P0_06
+    data_pin = pins[1]
+    rgb_pixel_pin = pins[0]
    i2c = board.I2C
-    powersave_pin = board.P0_13

-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(12))
-    coord_mapping.extend(ic(1, x) for x in range(12))
-    coord_mapping.extend(ic(2, x) for x in range(12))
-
-    # And now, to handle R3, which at this point is down to just six keys
-    coord_mapping.extend(ic(3, x) for x in range(3, 9))
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+     0,  1,  2,  3,  4,  5,  29, 28, 27, 26, 25, 24,
+     6,  7,  8,  9, 10, 11,  35, 34, 33, 32, 31, 30,
+    12, 13, 14, 15, 16, 17,  41, 40, 39, 38, 37, 36,
+                21, 22, 23,  47, 46, 45,
+    ]
--- a/boards/crkbd/kb_rp2040.py
+++ b/boards/crkbd/kb_rp2040.py
@ -1,29 +0,0 @@
-import board
-
-from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
-
-
-class KMKKeyboard(_KMKKeyboard):
-    col_pins = (
-        board.A3,
-        board.A2,
-        board.A1,
-        board.A0,
-        board.SCK,
-        board.MISO,
-    )
-    row_pins = (board.D4, board.D5, board.D6, board.D7)
-    diode_orientation = DiodeOrientation.COLUMNS
-    data_pin = board.RX
-    rgb_pixel_pin = board.D0
-    i2c = board.I2C
-
-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(12))
-    coord_mapping.extend(ic(1, x) for x in range(12))
-    coord_mapping.extend(ic(2, x) for x in range(12))
-
-    # And now, to handle R3, which at this point is down to just six keys
-    coord_mapping.extend(ic(3, x) for x in range(3, 9))
--- a/boards/crkbd/main.py
+++ b/boards/crkbd/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.rgb import RGB
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/crowboard/README.md
+++ b/boards/crowboard/README.md
@ -0,0 +1,8 @@
+# Crowboard
+![crowboard](https://i.imgur.com/Rg7IYPw.jpg)
+ Single Board 34/36 Key Keyboard Based on Raspberry pi Pico
+ 
+ [Link to the Github repo](https://github.com/doesntfazer/CrowBoard)
+ 
+ 
+ You can Buy this keyboard at KeyboardDweebs.net
--- a/boards/crowboard/kb.py
+++ b/boards/crowboard/kb.py
@ -0,0 +1,26 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP6,
+        board.GP7,
+        board.GP8,
+        board.GP9,
+        board.GP10,
+        board.GP18,
+        board.GP19,
+        board.GP20,
+        board.GP21,
+        board.GP22,
+    )
+    row_pins = (
+        board.GP14,
+        board.GP15,
+        board.GP16,
+        board.GP17,
+    )
+    diode_orientation = DiodeOrientation.COL2ROW
--- a/boards/crowboard/main.py
+++ b/boards/crowboard/main.py
@ -0,0 +1,92 @@
+import board
+
+from kb import KMKKeyboard
+
+from kmk.keys import KC
+from kmk.modules.holdtap import HoldTap
+from kmk.modules.layers import Layers
+from kmk.scanners import DiodeOrientation
+
+keyboard = KMKKeyboard()
+
+keyboard.modules.append(Layers())
+
+holdtap = HoldTap()
+keyboard.modules.append(holdtap)
+
+
+NONE = KC.NO
+QWERTY = KC.MO(0)
+LOWER = KC.MO(1)
+RAISE = KC.MO(2)
+ADJUST = KC.MO(3)
+CAE = KC.LCTL(KC.LALT(KC.END))
+CAD = KC.LCTL(KC.LALT(KC.DEL))
+
+
+
+ZSFT = KC.HT(KC.Z, KC.LSFT, prefer_hold=True, tap_interrupted=False, tap_time=3000)
+SLSHSFT = KC.HT(KC.SLSH, KC.LSFT, prefer_hold=True, tap_interrupted=False, tap_time=3000)
+ALCTL = KC.HT(KC.A, KC.LCTRL, prefer_hold=False, tap_interrupted=False, tap_time=150)
+
+# flake8: noqa: E261
+keyboard.keymap = [
+    [ # QWERTY
+     KC.Q,  KC.W,  KC.E,     KC.R,    KC.T,     KC.Y,    KC.U,     KC.I,    KC.O,   KC.P,
+     ALCTL, KC.S,  KC.D,     KC.F,    KC.G,     KC.H,    KC.J,     KC.K,    KC.L,   KC.QUOT,
+     ZSFT,  KC.X,  KC.C,     KC.V,    KC.B,     KC.N,    KC.M,     KC.COMM, KC.DOT, SLSHSFT,
+     NONE, NONE,   KC.LCTL,  LOWER,   KC.SPACE, KC.BSPC, RAISE, KC.RALT,    NONE,  NONE,
+
+     ],
+    [ # LOWER
+     KC.N1,  KC.N2,  KC.N3,     KC.N4,    KC.N5,     KC.N6,    KC.N7,     KC.N8,    KC.N9,   KC.N0,
+     KC.TAB,  KC.LEFT,  KC.DOWN,     KC.UP,    KC.RIGHT,     KC.TRNS,    KC.MINUS,     KC.EQUAL,    KC.LBRC,   KC.RBRC,
+     KC.LCTL,  KC.GRAVE,  KC.LGUI,     KC.LALT,    KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS, 	KC.BSLS, KC.SCLN,
+     KC.NO, KC.NO, KC.TRNS,     KC.TRNS,    KC.TRNS, KC.ENTER, ADJUST,     KC.TRNS,    KC.NO,  KC.NO,
+
+     ],
+    [ # RAISE
+     KC.EXLM,  KC.AT,  KC.HASH,     KC.DLR,    KC.PERC,     KC.CIRC,    KC.AMPR,     KC.ASTR,    KC.LPRN,   KC.RPRN,
+     KC.ESC,  KC.TRNS,  KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS,    KC.UNDS,     KC.PLUS,    KC.LCBR,   KC.RCBR,
+     KC.CAPS,  KC.TILDE,  KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS, KC.PIPE, KC.COLN,
+     KC.NO, KC.NO, KC.TRNS,     ADJUST,    KC.TRNS, KC.ENTER, KC.TRNS,     KC.DEL,    KC.NO,  KC.NO,
+
+     ],
+     [ # ADJUST
+     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.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS,    KC.TRNS,     CAE,    CAD,   CAD,
+     KC.TRNS,  KC.TRNS,  KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS,    KC.TRNS,     KC.TRNS, KC.TRNS, KC.TRNS,
+     KC.NO, KC.NO, KC.TRNS,     KC.TRNS,    KC.TRNS, KC.ENTER, KC.TRNS,     KC.TRNS,    KC.NO,  KC.NO,
+
+     ]
+]
+
+# Uncomment for Trackball
+# from kmk.modules.pimoroni_trackball import Trackball, TrackballMode
+# import busio as io
+
+# i2c1 = io.I2C(scl=board.GP3, sda=board.GP2)
+# trackball = Trackball(i2c1, mode=TrackballMode.MOUSE_MODE)
+# keyboard.modules.append(trackball)
+# trackball.set_rgbw(255, 255, 255, 30)
+# trackball.set_red(20)
+# trackball.set_green(100)
+# trackball.set_blue(100)
+# trackball.set_white(40)
+
+# uncomment for Encoders
+# from kmk.modules.encoder import EncoderHandler
+# encoder_handler = EncoderHandler()
+# keyboard.modules = [encoder_handler]
+# encoder_handler.pins = ((board.GP12, board.GP13, None, False), (board.GP27, board.GP26, None, False),)
+
+# encoder_handler.map = [(( KC.VOLD, KC.VOLU),(KC.VOLD, KC.VOLU),), # Layer 1
+#                      ((KC.VOLD, KC.VOLU),(KC.VOLD, KC.VOLU),), # Layer 2
+#                      ((KC.VOLD, KC.VOLU),(KC.VOLD, KC.VOLU),), # Layer 3
+#                      ((KC.VOLD, KC.VOLU),(KC.VOLD, KC.VOLU),), # Layer 4
+#                      ]
+
+# keyboard.debug_enabled = True
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/ergo_travel/README.md
+++ b/boards/ergo_travel/README.md
@ -2,20 +2,38 @@

 ![ergo_travel](https://boardsource.imgix.net/fa53de62-fd37-4c75-8c5b-b4bec37927c1.jpg?raw=true)

-As the name implies, the Ergo Travel was originally designed as a travel keyboard, but it works just as well on your desk as a main daily use keyboard. The Ergo Travel is a popular choice by many because it offers a few more keys than other keyboards in similar sizes, and that is why we chose to stock it. Additionally, the Ergo Travel has nice customization options in the thumb cluster because you can configure the main thumb key to use a single larger 2u key, or two smaller 1u keys depending on your preference. The clean and simple aesthetic of the Ergo Travel and the few extra keys make it an awesome option for people wanting a 40%-ish split keyboard.
-
-kb.py is designed to work with the nice!nano
+As the name implies, the Ergo Travel was originally designed as a travel
+keyboard, but it works just as well on your desk as a main daily use keyboard.
+The Ergo Travel is a popular choice by many because it offers a few more keys
+than other keyboards in similar sizes, and that is why we chose to stock it.
+Additionally, the Ergo Travel has nice customization options in the thumb
+cluster because you can configure the main thumb key to use a single larger 2u
+key, or two smaller 1u keys depending on your preference. The clean and simple
+aesthetic of the Ergo Travel and the few extra keys make it an awesome option
+for people wanting a 40%-ish split keyboard.

 Hardware Availability: [PCB & Case Source](https://github.com/jpconstantineau/ErgoTravel/blob/master/OrderingInstructions.md)  

 Retailers (USA)  
-[Boardsource](https://boardsource.xyz/store/5eed23430883e03ef9a69d6a)  
+[Boardsource](https://boardsource.xyz/store/5eed23430883e03ef9a69d6a)
+
+Retailers (Canada)  
+[BlueMicro Store (ErgoTravel's creator)](https://store.jpconstantineau.com/#/group/split_boards)    

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
- [MediaKeys](https://github.com/KMKfw/kmk_firmware/tree/master/docs/media_keys.md) Control volume and other media functions
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/ergo_travel/kb.py
+++ b/boards/ergo_travel/kb.py
@ -1,33 +1,34 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P0_24, board.P1_00, board.P0_11, board.P1_04)
+    row_pins = (pins[7], pins[8], pins[9], pins[10])
    col_pins = (
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
+        pins[17],
+        pins[16],
+        pins[15],
+        pins[14],
+        pins[13],
+        pins[12],
+        pins[10],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    led_pin = board.P1_06
-    rgb_pixel_pin = board.P0_06
+    led_pin = pins[9]
+    rgb_pixel_pin = pins[0]
    rgb_num_pixels = 12
-    data_pin = board.P0_08
+    data_pin = pins[1]
    i2c = board.I2C
-    powersave_pin = board.P0_13

-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(14))
-    coord_mapping.extend(ic(1, x) for x in range(14))
-    coord_mapping.extend(ic(2, x) for x in range(14))
-
-    # And now, to handle R3, which at this point is down to just six keys
-    coord_mapping.extend(ic(3, x) for x in range(3, 12))
+    # NOQA
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+     0,  1,  2,  3,  4,  5,  6,  34, 33, 32, 31, 30, 29, 28,
+     7,  8,  9, 10, 11, 12, 13,  41, 40, 39, 38, 37, 36, 35,
+    14, 15, 16, 17, 18, 19, 20,  48, 47, 46, 45, 44, 43, 42,
+    21, 22, 23, 24, 25, 26,          54, 53, 52, 51, 50, 49,
+    ]
--- a/boards/ergo_travel/main.py
+++ b/boards/ergo_travel/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.media_keys import MediaKeys
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/ferris_sweep/README.md
+++ b/boards/ferris_sweep/README.md
@ -0,0 +1,6 @@
+# Ferris Sweep
+
+The [Ferris Sweep](https://github.com/davidphilipbarr/Sweep) is a split, 34 key keyboard designed by David Philip Barr. It uses a Pro-Micro footprint.
+
+It's based in turn on the Ferris by Philip Chevalier.
+The default keymap is based on the [original Ferris default keymap](https://github.com/qmk/qmk_firmware/tree/master/keyboards/ferris/keymaps/default).
--- a/boards/ferris_sweep/kb.py
+++ b/boards/ferris_sweep/kb.py
@ -0,0 +1,36 @@
+# Ferris Sweep pinout translated from QMK repo
+# CreditT: 2018-2020 ENDO Katsuhiro, David Philip Barr, Pierre Chevalier
+
+import board
+
+from storage import getmount
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.quickpin.pro_micro.kb2040 import pinout as pins
+from kmk.scanners.keypad import KeysScanner
+
+# GPIO to key mapping - each line is a new row.
+# fmt: off
+_KEY_CFG_LEFT = [
+     pins[9], pins[16], pins[17], pins[18], pins[19],
+    pins[15], pins[14], pins[13], pins[12],  pins[0],
+     pins[4],  pins[5],  pins[6],  pins[7],  pins[8],
+                                  pins[10], pins[11],
+]
+
+
+# fmt: on
+
+class KMKKeyboard(_KMKKeyboard):
+    def __init__(self):
+        # create and register the scanner
+        self.matrix = KeysScanner(_KEY_CFG_LEFT)
+
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+     0,  1,  2,  3,  4,   21, 20, 19, 18, 17,
+     5,  6,  7,  8,  9,   26, 25, 24, 23, 22,
+    10, 11, 12, 13, 14,   31, 30, 29, 28, 27,
+                15, 16,   33, 32
+    ]
--- a/boards/ferris_sweep/main.py
+++ b/boards/ferris_sweep/main.py
@ -0,0 +1,115 @@
+# Replicates default Ferris keymap from QMK
+# Credit: Pierre Chevalier, 2020
+# https://github.com/qmk/qmk_firmware/tree/master/keyboards/ferris/keymaps/default
+
+import board
+
+from kb import KMKKeyboard
+
+from kmk.keys import KC
+from kmk.modules.holdtap import HoldTap
+from kmk.modules.layers import Layers
+from kmk.modules.mouse_keys import MouseKeys
+from kmk.modules.split import Split, SplitSide
+
+keyboard = KMKKeyboard()
+
+# TODO Comment one of these on each side
+# split_side = SplitSide.LEFT
+split_side = SplitSide.RIGHT
+split = Split(
+    # split_flip=True,
+    data_pin=board.D1,
+    split_side=split_side,
+    split_target_left=False,
+    # Using the default wasn't working, try pio
+    use_pio=True,
+    uart_flip=True,
+)
+
+layers_ext = Layers()
+holdtap = HoldTap()
+mouse_key = MouseKeys()
+
+
+keyboard.modules = [layers_ext, split, mod_tap, mouse_key]
+
+# Cleaner key names
+_______ = KC.TRNS
+XXXXXXX = KC.NO
+
+
+# Mod-taps
+A_SFT = KC.HT(KC.A, KC.LSFT)
+SCLN_SFT = KC.HT(KC.SCLN, KC.LSFT)
+X_CTL = KC.HT(KC.X, KC.LCTRL)
+C_ALT = KC.HT(KC.C, KC.LALT)
+COM_ALT = KC.HT(KC.COMM, KC.LALT)
+DOT_CTL = KC.HT(KC.DOT, KC.LCTRL)
+CTL_ALT = KC.LCTRL(KC.LALT)
+
+
+# Layer tap for other home row keys
+S_L5 = KC.LT(5, KC.S)
+D_L1 = KC.LT(1, KC.D)
+F_L3 = KC.LT(3, KC.F)
+J_L4 = KC.LT(4, KC.J)
+K_L2 = KC.LT(2, KC.K)
+L_L6 = KC.LT(6, KC.L)
+SPC_L7 = KC.LT(7, KC.SPC)
+
+# fmt: off
+# flake8: noqa
+keyboard.keymap = [
+    [  # QWERTY
+       KC.Q,   KC.W,   KC.E,    KC.R,    KC.T,    KC.Y,    KC.U,    KC.I,    KC.O,     KC.P,
+      A_SFT,   S_L5,   D_L1,    F_L3,    KC.G,    KC.H,    J_L4,    K_L2,    L_L6, SCLN_SFT,
+       KC.Z,  X_CTL,  C_ALT,    KC.V,    KC.B,    KC.N,    KC.M, COM_ALT, DOT_CTL,  KC.SLSH,
+                             KC.LGUI, KC.BSPC,  SPC_L7,  KC.ENT,
+    ],
+    [  # MOUSE
+    _______,   _______, _______,   _______, _______, _______, KC.MB_LMB, KC.MW_UP, KC.MB_LMB,  _______,
+    _______, KC.MB_RMB, _______, KC.MB_LMB, _______, _______,  KC.MS_LT, KC.MS_DN,  KC.MS_UP, KC.MS_RT,
+    _______,   _______, _______,   _______, _______, _______,   _______, KC.MW_DN,   _______,  _______,
+                                   _______, _______, _______, _______,
+    ],
+    [  # NAVIGATION
+    _______, _______, KC.PGUP, _______, _______, _______, _______, _______, _______, _______,
+    KC.LEFT,   KC.UP, KC.DOWN, KC.RGHT, _______, _______, KC.LGUI, CTL_ALT,  KC.MEH, KC.HYPR,
+    _______, KC.HOME, KC.PGDN,  KC.END, _______, _______, _______, _______, _______, _______,
+                               _______, _______, _______, _______,
+    ],
+    [  # RIGHT SYMBOLS
+    _______, _______, _______, _______, _______, _______, KC.UNDS, KC.PIPE, KC.QUOT, _______,
+    KC.CIRC, KC.ASTR, KC.AMPR, _______, _______, KC.HASH, KC.TILD, KC.SLSH, KC.DQUO,  KC.DLR,
+    _______, _______, _______, _______, _______, _______, KC.MINS, KC.BSLS,  KC.GRV, _______,
+                               _______, _______, _______, _______,
+    ],
+    [  # LEFT SYMBOLS
+    _______, KC.COLN, KC.LABK, KC.RABK, KC.SCLN, _______, _______, _______, _______, _______,
+    KC.LCBR, KC.RCBR, KC.LPRN, KC.RPRN,   KC.AT, _______, _______,  KC.EQL, KC.PLUS, KC.PERC,
+    _______, KC.EXLM, KC.LBRC, KC.RBRC, _______, _______, _______, _______, _______, _______,
+                               _______, _______, _______, _______,
+    ],
+    [  # 5 FUNCTION
+    _______, _______, _______, _______, _______, _______, KC.F7, KC.F8, KC.F9, KC.F10,
+    _______, _______, _______, _______, _______, _______, KC.F4, KC.F5, KC.F6, KC.F11,
+    _______, _______, _______, _______, _______, _______, KC.F1, KC.F2, KC.F3, KC.F12,
+                               _______, _______, _______, _______,
+    ],
+    [  # 6 NUMBERS
+    KC.SLSH,   KC.N7,   KC.N8,   KC.N9, KC.PLUS, _______, _______, _______, _______, _______,
+      KC.N0,   KC.N1,   KC.N2,   KC.N3, KC.MINS, _______, _______, _______, _______, _______,
+    KC.ASTR,   KC.N4,   KC.N5,   KC.N6,  KC.EQL, _______, _______, _______, _______, _______,
+                               _______, _______, _______, _______,
+    ],
+    [  # 7 ALWAYS AVAILABLE
+    _______, _______, KC.COLN,  KC.ESC, _______, _______, _______, _______, _______,  KC.DEL,
+    _______, KC.PERC, KC.SLSH,  KC.ENT, _______, KC.DF(1), KC.LGUI, _______, _______, _______,
+    _______, _______, _______, KC.PERC, _______, KC.DF(0), KC.RALT, KC.RCTL, _______, KC.RESET,
+                               _______,  KC.TAB, _______, _______,
+    ],
+]
+
+if __name__ == "__main__":
+    keyboard.go()
--- a/boards/fingerpunch/ffkb/README.md
+++ b/boards/fingerpunch/ffkb/README.md
@ -0,0 +1,25 @@
+# Faux Fox Keyboard (ffkb)
+
+![ffkb](https://fingerpunch.xyz/product/faux-fox-keyboard)
+
+A 36 or 42 key keyboard with support for per key LEDs, 2 rotary encoders (EC11
+or evqwgd001), and a feature in the center (EC11, OLED (128x64), or pimoroni
+trackball). KMK support is available for the BYO MCU option only.
+
+Use `nice_nano/kb.py` when using a Nice!Nano v2 MCU.
+
+> Note: The Nice!Nano doesn't have a lot of ROM, so there are a couple of extra
+> steps. See guidance [over
+> here](../../docs/en/Officially_Supported_Microcontrollers.md#nicenano).
+
+Use `kb2040/kb.py` when using any other pro micro footprint MCU.
+
+An example `main.py` file is included for each MCU.
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/fingerpunch/ffkb/nice_nano/kb.py
+++ b/boards/fingerpunch/ffkb/nice_nano/kb.py
@ -0,0 +1,39 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.P1_06,
+        board.P1_04,
+        board.P0_11,
+        board.P1_00,
+        board.P0_24,
+        board.P0_22,
+        board.MOSI,
+        board.MISO,
+    )
+    row_pins = (
+        board.P0_08,
+        board.P0_31,
+        board.P0_29,
+        board.P0_02,
+        board.P1_15,
+        board.SCK,
+    )
+    diode_orientation = DiodeOrientation.COLUMNS
+    rgb_pixel_pin = board.P0_06
+    rgb_num_pixels = 42
+    i2c = board.I2C
+
+# flake8: noqa
+    coord_mapping = [
+       0,   1,  2,  3,  4,  5,      6,  7, 35, 28, 37, 31,
+       8,   9, 10, 11, 12, 13, 33, 14, 15, 26, 36, 29, 39,
+       16, 17, 18, 19, 20, 21,     22, 23, 34, 27, 30, 38,
+       41,         43, 44, 45,     46, 47, 42,         40,
+        ]
+
+encoder_pins = ((board.P0_20, board.P0_17, board.P0_09, False))
--- a/boards/fingerpunch/ffkb/nice_nano/main.py
+++ b/boards/fingerpunch/ffkb/nice_nano/main.py
@ -0,0 +1,70 @@
+import board
+
+import kb
+
+from kmk.keys import KC
+from kmk.modules.combos import Combos, Sequence
+from kmk.modules.dynamic_sequences import DynamicSequences
+from kmk.modules.layers import Layers
+from kmk.modules.oneshot import OneShot
+
+combos = Combos()
+dyn_seq = DynamicSequences(
+    slots=1, # The number of sequence slots to use
+    timeout=60000,  # Maximum time to spend in record or config mode before stopping automatically, milliseconds
+    key_interval=20,  # Milliseconds between key events while playing
+    use_recorded_speed=False,  # Whether to play the sequence at the speed it was typed
+)
+layers = Layers()
+oneshot = OneShot()
+
+keyboard = kb.KMKKeyboard()
+keyboard.modules = [combos, dyn_seq, layers, oneshot]
+keyboard.debug_enabled = False
+
+# Convenience variables for the Keymap
+_______ = KC.TRNS
+xxxxxxx = KC.NO
+
+L1_TAB = KC.LT(1, KC.TAB, prefer_hold=True)
+L2_ENT = KC.LT(2, KC.ENT, prefer_hold=True)
+
+OS_LSFT = KC.OS(KC.LSFT)
+
+SEQ_REC = KC.RECORD_SEQUENCE()
+SEQ_STP = KC.STOP_SEQUENCE()
+SEQ_PLY = KC.PLAY_SEQUENCE()
+
+combos.combos = [
+    Sequence((KC.LEADER, KC.A), KC.LCTL(KC.A)),  # select All
+    Sequence((KC.LEADER, KC.T), KC.LCTL(KC.X)),  # cuT
+    Sequence((KC.LEADER, KC.C), KC.LCTL(KC.C)),  # Copy
+    Sequence((KC.LEADER, KC.P), KC.LCTL(KC.V)),  # Paste
+    Sequence((KC.LEADER, KC.U), KC.LCTL(KC.Z)),  # Undo
+    Sequence((KC.LEADER, KC.Y), KC.LCTL(KC.Y)),  # redo
+    ]
+
+# flake8: noqa
+keyboard.keymap = [
+    [  # 0: Colemak-DH letters
+        KC.ESC,  KC.Q,    KC.W,    KC.F,    KC.P,    KC.B,             KC.J,    KC.L,    KC.U,    KC.Y,    KC.SCLN, KC.LEADER,
+        KC.LCTL, KC.A,    KC.R,    KC.S,    KC.T,    KC.G,    xxxxxxx, KC.M,    KC.N,    KC.E,    KC.I,    KC.O,    KC.QUOT,
+        KC.LALT, KC.Z,    KC.X,    KC.C,    KC.D,    KC.V,             KC.K,    KC.H,    KC.COMM, KC.DOT,  KC.SLSH, KC.BSLS,
+                 xxxxxxx,          KC.LGUI, OS_LSFT, KC.BSPC,          L1_TAB,    KC.SPACE,L2_ENT,             xxxxxxx,
+    ],
+    [  # 1: Nav & Numbers
+        KC.TAB,  KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,            KC.N6,   KC.N7,   KC.N8,   KC.N9,   KC.N0,   KC.DEL,
+        _______, KC.LPRN, KC.LEFT, KC.UP,   KC.RIGHT,KC.RPRN, _______, KC.GRV,  KC.PLUS, KC.EQL,  xxxxxxx, xxxxxxx, xxxxxxx,
+        _______, KC.LBRC, KC.LCBR, KC.DOWN, KC.RCBR, KC.RBRC,          KC.TILD, KC.MINS, KC.UNDS, xxxxxxx, xxxxxxx, xxxxxxx,
+                 _______,          _______, _______, KC.DEL,           _______, _______, _______, _______,
+    ],
+    [  # 2: F-row & Board Functions
+        KC.F12,  KC.F1,   KC.F2,   KC.F3,   KC.F4,   KC.F5,            KC.F6,   KC.F7,   KC.F8,   KC.F9,    KC.F10,  KC.F11,
+        _______, SEQ_REC, SEQ_PLY, _______, _______, _______, _______, _______, _______, _______, _______,  _______, _______,
+        _______, SEQ_STP, _______, _______, _______, _______,          _______, _______, _______, _______,  _______, _______,
+                 _______,          _______, _______, _______,          _______, _______, _______,           _______, 
+    ],
+]
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/fingerpunch/ffkb/other_pro_micro/kb.py
+++ b/boards/fingerpunch/ffkb/other_pro_micro/kb.py
@ -0,0 +1,40 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation
+from kmk.scanners import intify_coordinate as ic
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        pins[11],
+        pins[10],
+        pins[9],
+        pins[8],
+        pins[7],
+        pins[6],
+        pins[10],
+        pins[12],
+    )
+    row_pins = (
+        pins[1],
+        pins[19],
+        pins[18],
+        pins[17],
+        pins[16],
+        pins[15],
+    )
+    diode_orientation = DiodeOrientation.COLUMNS
+    rgb_pixel_pin = pins[0]
+    rgb_num_pixels = 42
+    i2c = board.I2C
+
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+            ic(0, 0), ic(0, 1), ic(0, 2), ic(0, 3), ic(0, 4), ic(0, 5),           ic(0, 6), ic(0, 7), ic(4, 3), ic(3, 4), ic(4, 5), ic(3, 7),
+            ic(1, 0), ic(1, 1), ic(1, 2), ic(1, 3), ic(1, 4), ic(1, 5), ic(4, 1), ic(1, 6), ic(1, 7), ic(3, 2), ic(4, 4), ic(3, 5), ic(4, 7),
+            ic(2, 0), ic(2, 1), ic(2, 2), ic(2, 3), ic(2, 4), ic(2, 5),           ic(2, 6), ic(2, 7), ic(4, 2), ic(3, 3), ic(3, 6), ic(4, 6),
+            ic(5, 1),                     ic(5, 3), ic(5, 4), ic(5, 5),           ic(5, 6), ic(5, 7), ic(5, 2),                     ic(5, 0)
+    ]
--- a/boards/fingerpunch/ffkb/other_pro_micro/main.py
+++ b/boards/fingerpunch/ffkb/other_pro_micro/main.py
@ -0,0 +1,140 @@
+import board
+
+from kb_kb2040 import KMKKeyboard
+
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.rgb import RGB
+from kmk.keys import KC
+from kmk.modules.encoder import EncoderHandler
+from kmk.modules.holdtap import HoldTap
+from kmk.modules.layers import Layers
+from kmk.modules.mouse_keys import MouseKeys
+
+keyboard = KMKKeyboard()
+keyboard.tap_time = 150
+keyboard.debug_enabled = False
+
+# Cleaner key names
+_______ = KC.TRNS
+XXXXXXX = KC.NO
+
+# Adding extensions
+rgb = RGB(pixel_pin=keyboard.rgb_pixel_pin, num_pixels=keyboard.rgb_num_pixels, val_limit=50, hue_default=190, sat_default=100, val_default=5)
+
+holdtap = HoldTap()
+layers = Layers()
+media_keys = MediaKeys()
+
+encoder_handler = EncoderHandler()
+
+keyboard.modules = [layers, holdtap]  #, encoder_handler]
+keyboard.modules.append(MouseKeys())
+keyboard.extensions = [rgb, media_keys]
+
+
+encoder_handler.pins = ((board.D3, board.D2, board.D10, False))
+
+ZOOM_IN = KC.LCTRL(KC.EQUAL)
+ZOOM_OUT = KC.LCTRL(KC.MINUS)
+
+LYR_BASE, LYR_NAV, LYR_SYM, LYR_SNAV, LYR_MEDIA, LYR_MOUSE = 0, 1, 2, 3, 4, 5
+
+NAV_ENT = KC.LT(LYR_NAV, KC.ENT)
+SYM_SPC = KC.LT(LYR_SYM, KC.SPC)
+SNAV_TAB = KC.LT(LYR_SNAV, KC.TAB)
+MEDIA_BSPC = KC.LT(LYR_MEDIA, KC.BSPC)
+MOUSE_M = KC.LT(LYR_MOUSE, KC.M)
+
+# HOMEROW MODS
+LCTL_A = KC.HT(KC.A, KC.LCTRL)
+LGUI_R = KC.HT(KC.R, KC.LGUI)
+LALT_S = KC.HT(KC.S, KC.LALT)
+LSFT_T = KC.HT(KC.T, KC.LSFT)
+RSFT_N = KC.HT(KC.N, KC.RSFT)
+RALT_E = KC.HT(KC.E, KC.RALT)
+RGUI_I = KC.HT(KC.I, KC.RGUI)
+RCTL_O = KC.HT(KC.O, KC.RCTRL)
+
+# OTHER SHORTCUTS
+BRWSR_LFT = KC.LCTRL(KC.LSFT(KC.TAB))
+BRWSR_RGHT = KC.LCTRL(KC.TAB)
+DESK_LEFT = KC.LCTRL(KC.LGUI(KC.LEFT))
+DESK_RIGHT = KC.LCTRL(KC.LGUI(KC.RIGHT))
+CAPSWORD = _______  # TODO: IMPLEMENT THIS
+
+# SHIFT NAV
+SFT_PGUP = KC.LSFT(KC.PGUP)
+SFT_PGDN = KC.LSFT(KC.PGDN)
+SFT_HOME = KC.LSFT(KC.HOME)
+SFT_END = KC.LSFT(KC.END)
+SFT_UP = KC.LSFT(KC.UP)
+SFT_DOWN = KC.LSFT(KC.DOWN)
+SFT_LEFT = KC.LSFT(KC.LEFT)
+SFT_RGHT = KC.LSFT(KC.RIGHT)
+
+RGB_TOG = KC.RGB_TOG
+RGB_HUI = KC.RGB_HUI
+RGB_HUD = KC.RGB_HUI
+RGB_SAI = KC.RGB_SAI
+RGB_SAD = KC.RGB_SAD
+RGB_VAI = KC.RGB_VAI
+RGB_VAD = KC.RGB_VAD
+RGB_ANI = KC.RGB_ANI
+RGB_AND = KC.RGB_AND
+RGB_M_P = KC.RGB_MODE_PLAIN
+RGB_M_B = KC.RGB_MODE_BREATHE
+RGB_M_R = KC.RGB_MODE_RAINBOW
+RGB_M_BR = KC.RGB_MODE_BREATHE_RAINBOW
+RGB_M_K = KC.RGB_MODE_KNIGHT
+RGB_M_S = KC.RGB_MODE_SWIRL
+
+keyboard.keymap = [
+    [  #COLEMAK-DH
+        KC.ESC,    KC.Q,    KC.W,    KC.F,    KC.P,    KC.B,                          KC.J,       KC.L,    KC.U,     KC.Y,   KC.SCLN, KC.BSPC,
+        KC.CAPS,   LCTL_A,  LGUI_R,  LALT_S,  LSFT_T,  KC.G,          KC.MUTE,        MOUSE_M,    RSFT_N,  RALT_E,   RGUI_I, RCTL_O,  KC.QUOT,
+        KC.SPC,    KC.Z,    KC.X,    KC.C,    KC.D,    KC.V,                          KC.K,       KC.H,    KC.COMM,  KC.DOT, KC.SLSH, KC.RSFT,
+                            KC.MUTE, KC.DEL,  NAV_ENT, SNAV_TAB,                      MEDIA_BSPC, SYM_SPC, KC.QUOT,  KC.LCTRL(KC.BSPC)
+    ],
+    [  #NAVIGATION
+        _______,     KC.ESC,      KC.PGUP,     KC.UP,       KC.PGDN,     _______,             KC.ASTR,     KC.N7,     KC.N8,       KC.N9,     KC.PLUS,     _______,
+        _______,     KC.HOME,     KC.LEFT,     KC.DOWN,     KC.RIGHT,    KC.END,   _______,   KC.SLSH,     KC.N4,     KC.N5,       KC.N6,     KC.MINS,     _______,
+        _______,     _______,     _______,     _______,     _______,     _______,             KC.EQL,      KC.N1,     KC.N2,       KC.N3,     KC.N0,       _______,
+                                  _______,     _______,     _______,     _______,             KC.BKSP,     KC.SPC,    KC.DOT,      _______,
+    ],
+    [  #SYMBOLS
+        _______,     KC.EXLM,     KC.AT,       KC.HASH,     KC.DLR,      KC.PERC,             KC.CIRC,     KC.AMPR,     KC.ASTR,     KC.UNDS,     KC.EQL,      _______,
+        _______,     KC.MINS,     KC.LBRC,     KC.LCBR,     KC.LPRN,     KC.LABK,  _______,   KC.RABK,     KC.RPRN,     KC.RCBR,     KC.RBRC,     KC.PLUS,     _______,
+        _______,     KC.CAPS,     KC.GRV,      BRWSR_LFT,   DESK_LEFT,   CAPSWORD,            _______,     DESK_RIGHT,  BRWSR_RGHT,  _______,     KC.BSLS,     _______,
+                                  _______,     _______,     KC.ENT,      KC.TAB,              _______,     _______,     _______,     _______,
+    ],
+    [  #SHIFT NAVIGATION
+        _______,     _______,     SFT_PGUP,    SFT_UP,      SFT_PGDN,    _______,             _______,     _______,     _______,     _______,     _______,     _______,
+        _______,     SFT_HOME,    SFT_LEFT,    SFT_DOWN,    SFT_RGHT,    SFT_END,  _______,   KC.VOLU,     KC.MPLY,     KC.MSTP,     _______,     _______,     _______,
+        _______,     _______,     _______,     _______,     _______,     KC.MUTE,             KC.VOLD,     KC.MPRV,     KC.MNXT,     _______,     _______,     _______,
+                                  _______,     _______,     _______,     _______,             _______,     _______,     _______,     _______,
+    ],
+    [  #MEDIA
+        _______,     RGB_TOG,     _______,     _______,     _______,     _______,             _______,     _______,     _______,     _______,     _______,     _______,
+        _______,     _______,     RGB_HUI,     RGB_SAI,     RGB_VAI,     RGB_ANI,  _______,   RGB_M_P,     RGB_M_B,     RGB_M_R,     RGB_M_BR,    RGB_M_K,     _______,
+        _______,     _______,     RGB_HUD,     RGB_SAD,     RGB_VAD,     RGB_AND,             RGB_M_S,     _______,     _______,     _______,     _______,     _______,
+                                  _______,     _______,     _______,     _______,             _______,     _______,     _______,     _______,
+    ],
+    [  #MOUSE
+        _______,     KC.RESET,    KC.MW_UP,    KC.MS_UP,    KC.MW_DN,    _______,             _______,     _______,     _______,     _______,     _______,     _______,
+        _______,     _______,     KC.MS_LT,    KC.MS_DN,    KC.MS_RT,    _______,  _______,   _______,     _______,     _______,     _______,     _______,     _______,
+        _______,     _______,     _______,     _______,     _______,     _______,             _______,     _______,     _______,     _______,     _______,     _______,
+                                  _______,     _______,     _______,     _______,             _______,     _______,     _______,     _______,
+    ],
+]
+
+encoder_handler.map = [
+    ((KC.VOLD, KC.VOLU, KC.MUTE)),  # Layer 1
+    ((ZOOM_OUT, ZOOM_IN, _______)),  # Layer 2
+    ((_______, _______, _______)),  # Layer 3
+    ((_______, _______, _______)),  # Layer 4
+    ((_______, _______, _______)),  # Layer 5
+    ((_______, _______, _______)),  # Layer 6
+]
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/fourtypercentclub/gherkin/README.md
+++ b/boards/fourtypercentclub/gherkin/README.md
@ -4,14 +4,20 @@

 A keyboard with only 30 keys.  

-kb.py is designed to work with the nice!nano
-
 Hardware Availability: [Gherkin project on 40% Keyboards](http://www.40percent.club/2016/11/gherkin.html)

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [ModTap](https://github.com/KMKfw/kmk_firmware/tree/master/docs/modtap.md) Allows mod keys to act as different keys when tapped.
- [LED](https://github.com/KMKfw/kmk_firmware/tree/master/docs/led.md) Light your keys up
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [HoldTap](/docs/en/holdtap.md) Allows mod keys to act as different keys when tapped.
+- [LED](/docs/en/led.md) Light your keys up

 Common Extensions
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/fourtypercentclub/gherkin/kb.py
+++ b/boards/fourtypercentclub/gherkin/kb.py
@ -1,21 +1,21 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P1_15, board.P1_13, board.P1_11, board.P0_10, board.P0_09)
+    row_pins = (pins[16], pins[15], pins[14], pins[13], pins[12])
    col_pins = (
-        board.P1_04,
-        board.P0_11,
-        board.P1_00,
-        board.P0_24,
-        board.P0_22,
-        board.P0_20,
+        board.pins[10],
+        board.pins[9],
+        board.pins[8],
+        board.pins[7],
+        board.pins[6],
+        board.pins[5],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    led_pin = board.P1_06
+    led_pin = board.pins[11]
    rgb_num_pixels = 0
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/fourtypercentclub/gherkin/main.py
+++ b/boards/fourtypercentclub/gherkin/main.py
@ -1,17 +1,18 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.led import LED
 from kmk.keys import KC
+from kmk.modules.holdtap import HoldTap
 from kmk.modules.layers import Layers
-from kmk.modules.modtap import ModTap

 keyboard = KMKKeyboard()


-modtap = ModTap()
+holdtap = HoldTap()
 layers_ext = Layers()
 led = LED()
 keyboard.extensions = [led]
-keyboard.modules = [layers_ext, modtap]
+keyboard.modules = [layers_ext, holdtap]

 # Cleaner key names
 _______ = KC.TRNS
--- a/boards/fourtypercentclub/luddite/README.md
+++ b/boards/fourtypercentclub/luddite/README.md
@ -4,15 +4,20 @@

 Luddite 60% keyboard with backlight and RGB underglow.  

-kb.py is designed to work with the nice!nano
-kb_converter.py is designed to work with an itsybitsy with converter board found [here](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)
-
 Hardware Availability: [Luddite project on 40% Keyboards](http://www.40percent.club/search/label/luddite)

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) RGB underglow
- [LED](https://github.com/KMKfw/kmk_firmware/tree/master/docs/led.md) Light your keys up
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) RGB underglow
+- [LED](/docs/en/led.md) Light your keys up

 Common Extensions
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/fourtypercentclub/luddite/converter_kb.py
+++ b/boards/fourtypercentclub/luddite/converter_kb.py
@ -1,30 +0,0 @@
-import board
-
-from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-
-
-class KMKKeyboard(_KMKKeyboard):
-    col_pins = (
-        board.A0,
-        board.A1,
-        board.A2,
-        board.A3,
-        board.A4,
-        board.A5,
-        board.SCK,
-        board.MOSI,
-    )
-    row_pins = (
-        board.TX,
-        board.RX,
-        board.SDA,
-        board.SCL,
-        board.D13,
-        board.D12,
-        board.D11,
-        board.D10,
-    )
-    diode_orientation = DiodeOrientation.COLUMNS
-    rgb_pixel_pin = board.D9
-    rgb_num_pixels = 12
--- a/boards/fourtypercentclub/luddite/kb.py
+++ b/boards/fourtypercentclub/luddite/kb.py
@ -1,33 +1,33 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
    row_pins = (
-        board.P0_06,
-        board.P0_08,
-        board.P0_17,
-        board.P0_20,
-        board.P0_22,
-        board.P0_24,
-        board.P1_00,
-        board.P0_11,
+        pins[0],
+        board.pins[1],
+        board.pins[4],
+        board.pins[5],
+        board.pins[6],
+        board.pins[7],
+        board.pins[8],
+        board.pins[9],
    )
    col_pins = (
-        board.P0_31,
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
+        board.pins[19],
+        board.pins[18],
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
+        board.pins[13],
+        board.pins[12],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    led_pin = board.P1_06
-    rgb_pixel_pin = board.P1_04
+    led_pin = board.pins[11]
+    rgb_pixel_pin = board.pins[10]
    rgb_num_pixels = 8
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/fourtypercentclub/luddite/main.py
+++ b/boards/fourtypercentclub/luddite/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.led import LED
 from kmk.extensions.rgb import RGB
 from kmk.keys import KC
--- a/boards/helix/README.md
+++ b/boards/helix/README.md
@ -0,0 +1,111 @@
+# Helix
+
+![Helix](https://camo.githubusercontent.com/15552bce07c6ad8e2a9c25054bada9f6a12239d009771b372d2c2ea7a91ed8b2/68747470733a2f2f692e696d6775722e636f6d2f5842416d796e4e2e6a7067)
+
+A compact split ortholinear keyboard.
+
+* Keyboard Maintainer: [yushakobo](https://github.com/yushakobo)
+* Hardware Supported: Helix PCBs (probably rev2 only), Pro Micro RP2040 boards
+
+Copy the `kb.py` and `main.py` files from your preferred keymap folder into your root directory of your keyboard as detailed in the [KMK instructions](http://kmkfw.io/docs/Getting_Started/).
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
+
+## Layout
+
+### Qwerty
+
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |   `  |   1  |   2  |   3  |   4  |   5  |             |   6  |   7  |   8  |   9  |   0  | Del  |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Tab  |   Q  |   W  |   E  |   R  |   T  |             |   Y  |   U  |   I  |   O  |   P  | Bksp |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Ctrl |   A  |   S  |   D  |   F  |   G  |             |   H  |   J  |   K  |   L  |   ;  |  '   |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ | Shift|   Z  |   X  |   C  |   V  |   B  |   [  |   ]  |   N  |   M  |   ,  |   .  |   /  |Enter |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |Adjust| Esc  | Alt  | GUI  |      |Lower |Space |Space |Raise |      | Left | Down |  Up  |Right |
+ `-------------------------------------------------------------------------------------------------'
+```
+
+### Colemak
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |   `  |   1  |   2  |   3  |   4  |   5  |             |   6  |   7  |   8  |   9  |   0  | Del  |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Tab  |   Q  |   W  |   F  |   P  |   G  |             |   J  |   L  |   U  |   Y  |   ;  | Bksp |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Ctrl |   A  |   R  |   S  |   T  |   D  |             |   H  |   N  |   E  |   I  |   O  |  '   |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ | Shift|   Z  |   X  |   C  |   V  |   B  |   [  |   ]  |   K  |   M  |   ,  |   .  |   /  |Enter |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |Adjust| Esc  | Alt  | GUI  |      |Lower |Space |Space |Raise |      | Left | Down |  Up  |Right |
+ `-------------------------------------------------------------------------------------------------'
+```
+
+### Dvorak
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |   `  |   1  |   2  |   3  |   4  |   5  |             |   6  |   7  |   8  |   9  |   0  | Bksp |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Tab  |   '  |   ,  |   .  |   P  |   Y  |             |   F  |   G  |   C  |   R  |   L  | Del  |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ | Ctrl |   A  |   O  |   E  |   U  |   I  |             |   D  |   H  |   T  |   N  |   S  |  /   |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ | Shift|   ;  |   Q  |   J  |   K  |   X  |   [  |   ]  |   B  |   M  |   W  |   V  |   Z  |Enter |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |Adjust| Esc  | Alt  | GUI  |      |Lower |Space |Space |Raise |      | Left | Down |  Up  |Right |
+ `-------------------------------------------------------------------------------------------------'
+```
+
+### Lower
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |   ~  |   !  |   @  |   #  |   $  |   %  |             |   ^  |   &  |   *  |   (  |   )  |      |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |   ~  |   !  |   @  |   #  |   $  |   %  |             |   ^  |   &  |   *  |   (  |   )  |      |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |      |  F1  |  F2  |  F3  |  F4  |  F5  |             |  F6  |   _  |   +  |   {  |   }  |  |   |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |  F7  |  F8  |  F9  |  F10 |  F11 |  (   |   )  |  F12 |      |      | Home | End  |      |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |      |      |      |      |      |      |      |      |      | Next | Vol- | Vol+ | Play |
+ `-------------------------------------------------------------------------------------------------'
+```
+
+### Raise
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |   `  |   1  |   2  |   3  |   4  |   5  |             |   6  |   7  |   8  |   9  |   0  | Bksp |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |   `  |   1  |   2  |   3  |   4  |   5  |             |   6  |   7  |   8  |   9  |   0  | Del  |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |      |  F1  |  F2  |  F3  |  F4  |  F5  |             |  F6  |   -  |   =  |   [  |   ]  |  \   |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |  F7  |  F8  |  F9  |  F10 |  F11 |      |      |  F12 |      |      |PageDn|PageUp|      |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |      |      |      |      |      |      |      |      |      | Next | Vol- | Vol+ | Play |
+ `-------------------------------------------------------------------------------------------------'
+```
+
+### Adjust (Lower + Raise)
+```
+ ,-----------------------------------------.             ,-----------------------------------------.
+ |  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |             |  F7  |  F8  |  F9  |  F10 |  F11 |  F12 |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |      | Reset| Debug|      |      |      |             |      |      |      |      |      |  Del |
+ |------+------+------+------+------+------|             |------+------+------+------+------+------|
+ |      |      |      |      |      | Mac  |             | Win  |Qwerty|Colemk|Dvorak|      |      |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |      |      |      |      |      |      |      |      |      |RGB ON| HUE+ | SAT+ | VAL+ |
+ |------+------+------+------+------+------+------+------+------+------+------+------+------+------|
+ |      |      |      |      |      |      |      |      |      |      | MODE | HUE- | SAT- | VAL- |
+ `-------------------------------------------------------------------------------------------------'
+```
--- a/boards/helix/kb.py
+++ b/boards/helix/kb.py
@ -0,0 +1,37 @@
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.quickpin.pro_micro.sparkfun_promicro_rp2040 import pinout as pins
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        pins[19],
+        pins[18],
+        pins[17],
+        pins[16],
+        pins[15],
+        pins[14],
+        pins[13],
+    )
+    row_pins = (
+        pins[6],
+        pins[7],
+        pins[8],
+        pins[9],
+        pins[10],
+    )
+    diode_orientation = DiodeOrientation.COL2ROW
+    data_pin = pins[1]
+    rgb_pixel_pin = pins[0]
+    SDA = pins[4]
+    SCL = pins[5]
+
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+        0,   1,  2,  3,  4,  5,         40, 39, 38, 37, 36, 35,
+        7,   8,  9, 10, 11, 12,         47, 46, 45, 44, 43, 42,
+        14, 15, 16, 17, 18, 19,         54, 53, 52, 51, 50, 49,
+        21, 22, 23, 24, 25, 26, 27, 62, 61, 60, 59, 58, 57, 56,
+        28, 29, 30, 31, 32, 33, 34, 69, 68, 67, 66, 65, 64, 63
+    ]
--- a/boards/helix/main.py
+++ b/boards/helix/main.py
@ -0,0 +1,102 @@
+from kb import KMKKeyboard
+
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.rgb import RGB
+from kmk.keys import KC
+from kmk.modules.cg_swap import CgSwap
+from kmk.modules.layers import Layers
+from kmk.modules.split import Split, SplitSide
+
+keyboard = KMKKeyboard()
+
+# RGB backlight support
+rgb = RGB(pixel_pin=keyboard.rgb_pixel_pin, num_pixels=32, hue_default=80, sat_default=255, val_default=80)
+keyboard.extensions.append(rgb)
+
+# Split keyboard support
+split_side = SplitSide.LEFT
+split_side = SplitSide.RIGHT
+split = Split(
+    use_pio=True,
+    uart_flip=True,
+    data_pin=keyboard.data_pin
+    )
+keyboard.modules.append(split)
+
+# Media key support
+keyboard.extensions.append(MediaKeys())
+
+# CG Swap Module
+cg_swap = CgSwap()
+keyboard.modules.append(cg_swap)
+
+# Layer support
+layers_ext = Layers()
+keyboard.modules.append(layers_ext)
+
+# Cleaner key names
+_______ = KC.TRNS
+XXXXXXX = KC.NO
+
+QWERTY = KC.DF(0)
+COLEMAK = KC.DF(1)
+DVORAK = KC.DF(2)
+LOWER = KC.MO(3)
+RAISE = KC.MO(4)
+ADJUST = KC.MO(5)
+
+RGB_TOG = KC.RGB_TOG
+RGB_HUI = KC.RGB_HUI
+RGB_HUD = KC.RGB_HUI
+RGB_SAI = KC.RGB_SAI
+RGB_SAD = KC.RGB_SAD
+RGB_VAI = KC.RGB_VAI
+RGB_VAD = KC.RGB_VAD
+
+keyboard.keymap = [
+    [  # QWERTY
+        KC.GRV, KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,                      KC.N6,  KC.N7,   KC.N8,   KC.N9,   KC.N0,     KC.DEL,
+        KC.TAB,  KC.Q,    KC.W,    KC.E,    KC.R,    KC.T,                      KC.Y,    KC.U,    KC.I,    KC.O,    KC.P,    KC.BSPC,
+        KC.LCTL, KC.A,    KC.S,    KC.D,    KC.F,    KC.G,                      KC.H,    KC.J,    KC.K,    KC.L,    KC.SCLN, KC.QUOT,
+        KC.LSFT, KC.Z,    KC.X,    KC.C,    KC.V,    KC.B,    KC.LBRC, KC.RBRC, KC.N,    KC.M,    KC.COMM, KC.DOT,  KC.SLSH, KC.ENT ,
+        ADJUST,  KC.ESC,  KC.LALT, KC.LGUI, XXXXXXX,   LOWER,   KC.SPC,  KC.SPC,  RAISE, XXXXXXX,  KC.LEFT, KC.DOWN, KC.UP,   KC.RGHT
+    ],
+    [  # COLEMAK
+        KC.GRV, KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,                      KC.N6,  KC.N7,   KC.N8,   KC.N9,   KC.N0,     KC.DEL,
+        KC.TAB,  KC.Q,    KC.W,    KC.F,    KC.P,    KC.G,                      KC.J,    KC.L,    KC.U,    KC.Y,    KC.SCLN, KC.BSPC,
+        KC.LCTL, KC.A,    KC.R,    KC.S,    KC.T,    KC.D,                      KC.H,    KC.N,    KC.E,    KC.I,    KC.O,    KC.QUOT,
+        KC.LSFT, KC.Z,    KC.X,    KC.C,    KC.V,    KC.B,    KC.LBRC, KC.RBRC, KC.K,    KC.M,    KC.COMM, KC.DOT,  KC.SLSH, KC.ENT ,
+        ADJUST,  KC.ESC,  KC.LALT, KC.LGUI, XXXXXXX,   LOWER,   KC.SPC,  KC.SPC,  RAISE, XXXXXXX,  KC.LEFT, KC.DOWN, KC.UP,   KC.RGHT
+    ],
+    [  # DVORAK
+        KC.GRV, KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,                      KC.N6,  KC.N7,   KC.N8,   KC.N9,   KC.N0,     KC.DEL,
+        KC.TAB,  KC.QUOT, KC.COMM, KC.DOT,  KC.P,    KC.Y,                      KC.F,    KC.G,    KC.C,    KC.R,    KC.L,    KC.DEL,
+        KC.LCTL, KC.A,    KC.O,    KC.E,    KC.U,    KC.I,                      KC.D,    KC.H,    KC.T,    KC.N,    KC.S,    KC.SLSH,
+        KC.LSFT, KC.SCLN, KC.Q,    KC.J,    KC.K,    KC.X,    KC.LBRC, KC.RBRC, KC.B,    KC.M,    KC.W,    KC.V,    KC.Z,    KC.ENT ,
+        ADJUST,  KC.ESC,  KC.LALT, KC.LGUI, XXXXXXX,   LOWER,   KC.SPC,  KC.SPC,  RAISE, XXXXXXX,  KC.LEFT, KC.DOWN, KC.UP,   KC.RGHT
+    ],
+    [  # LOWER
+        KC.TILD, KC.EXLM, KC.AT,   KC.HASH, KC.DLR,  KC.PERC,                   KC.CIRC, KC.AMPR, KC.ASTR, KC.LPRN, KC.RPRN, _______,
+        KC.TILD, KC.EXLM, KC.AT,   KC.HASH, KC.DLR,  KC.PERC,                   KC.CIRC, KC.AMPR, KC.ASTR, KC.LPRN, KC.RPRN, _______,
+        _______, KC.F1,   KC.F2,   KC.F3,   KC.F4,   KC.F5,                     KC.F6,   KC.UNDS, KC.PLUS, KC.LCBR, KC.RCBR, KC.PIPE,
+        KC.CAPS, KC.F7,   KC.F8,   KC.F9,   KC.F10,  KC.F11,  KC.LPRN, KC.RPRN, KC.F12,  _______, _______, KC.HOME, KC.END,  _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC.MNXT, KC.VOLD, KC.VOLU, KC.MPLY
+    ],
+    [  # RAISE
+        KC.GRV, KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,                     KC.N6,   KC.N7,   KC.N8,   KC.N9,   KC.N0,    KC.BSPC,
+        KC.GRV, KC.N1,   KC.N2,   KC.N3,   KC.N4,   KC.N5,                     KC.N6,   KC.N7,   KC.N8,   KC.N9,   KC.N0,    KC.DEL,
+        _______, KC.F1,   KC.F2,   KC.F3,   KC.F4,   KC.F5,                     KC.F6,   KC.MINS, KC.EQL,  KC.LBRC, KC.RBRC, KC.BSLS,
+        KC.CAPS, KC.F7,   KC.F8,   KC.F9,   KC.F10,  KC.F11,  _______, _______, KC.F12,  _______, _______, KC.PGDN, KC.PGUP, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC.MNXT, KC.VOLD, KC.VOLU, KC.MPLY
+    ],
+    [  # ADJUSTs
+        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.RESET, KC.DEBUG, _______, _______, _______,                   _______, _______, _______, _______, _______, KC.DEL,
+        _______, _______, _______, _______, _______, KC.CG_NORM,             KC.CG_SWAP, QWERTY,  COLEMAK, DVORAK,  _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, RGB_TOG, RGB_HUI, RGB_SAI, RGB_VAI,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, RGB_HUD, RGB_SAD, RGB_VAD
+    ]
+]
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/boards/jpconstantineau/Batreus44/README.md
+++ b/boards/jpconstantineau/Batreus44/README.md
@ -0,0 +1,13 @@
+# JPConstantineau's Batreus44: An Atreus44 clone with Low Profile Switches and Wireless Options!
+
+![Batreus44](https://preview.redd.it/yu090ikxiou71.jpg?width=4032&format=pjpg&auto=webp&s=6da758f1ca439ecee912b35a709eacef9b019cd8)
+
+44 Keys Low Profile Keyboard inspired from Keyboardio's Atreus with a socket for a NiceNano, BlueMicro840 or Pro Micro RP2040 and a place to solder in a Battery.
+
+kb_BlueMicro840.py is designed to work with the BlueMicro840
+
+Retailers (USA)  
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/Batreus44/kb_BlueMicro840.py
+++ b/boards/jpconstantineau/Batreus44/kb_BlueMicro840.py
@ -0,0 +1,23 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.P0_15,
+        board.P0_17,
+        board.P0_20,
+        board.P0_13,
+        board.P0_24,
+        board.P0_09,
+        board.P0_03,
+        board.P1_13,
+        board.P0_02,
+        board.P0_29,
+        board.P0_26,
+        board.P0_30,
+    )
+    row_pins = (board.P0_28, board.P1_11, board.P0_10, board.P1_06)
+    diode_orientation = DiodeOrientation.COL2ROW
--- a/boards/jpconstantineau/PyKey60/README.md
+++ b/boards/jpconstantineau/PyKey60/README.md
@ -0,0 +1,15 @@
+# JPConstantineau's PyKey60
+
+![PyKey60](https://cdn.tindiemedia.com/images/resize/JYsH3WYq6GZD4xnvByhHXzwLhPo=/p/full-fit-in/2400x1600/i/556481/products/2021-09-17T19%3A53%3A16.118Z-PXL_20210917_194653430.jpg?1631883222)
+
+A 60% RGB Keyboard PCB with Hot Swap Sockets, running CircuitPython on a RP2040 Soldered on board.
+
+kb.py is designed to work with the [PyKey60 CircuitPython UF2](https://circuitpython.org/board/jpconstantineau_pykey60/)
+
+Retailers (USA)  
+[BlueMicro Store on Tindie](https://www.tindie.com/products/jpconstantineau/pykey60-rgb-keyboard-pcb-with-a-rp2040/)  
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/PyKey60/kb.py
+++ b/boards/jpconstantineau/PyKey60/kb.py
@ -0,0 +1,27 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.COL1,
+        board.COL2,
+        board.COL3,
+        board.COL4,
+        board.COL5,
+        board.COL6,
+        board.COL7,
+        board.COL8,
+        board.COL9,
+        board.COL10,
+        board.COL11,
+        board.COL12,
+        board.COL13,
+        board.COL14,
+    )
+    row_pins = (board.ROW1, board.ROW2, board.ROW3, board.ROW4, board.ROW5)
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.NEOPIXEL
+    rgb_num_pixels = 61
--- a/boards/jpconstantineau/gridmx47/README.md
+++ b/boards/jpconstantineau/gridmx47/README.md
@ -0,0 +1,15 @@
+# JPConstantineau's GridMX47: A Planck clone
+
+![GridMX47](https://cdn.tindiemedia.com/images/resize/alLUevg6WzBFO9uqkOwd5Lw5tJY=/p/fit-in/1370x912/filters:fill(fff)/i/556481/products/2021-10-26T23%3A29%3A50.131Z-PXL_20211026_230848859.jpg?1635265805)
+
+47 Keys RGB Keyboard inspired from OLKB's Planck with a Raspberry Pi Pico
+
+kb.py is designed to work with the [Pico CircuitPython UF2](https://circuitpython.org/board/raspberry_pi_pico/)
+
+Retailers (USA)  
+[BlueMicro Store on Tindie](https://www.tindie.com/products/jpconstantineau/47-keys-rgb-keyboard-using-raspberry-pi-pico/)
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/gridmx47/kb.py
+++ b/boards/jpconstantineau/gridmx47/kb.py
@ -0,0 +1,25 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP11,
+        board.GP12,
+        board.GP13,
+        board.GP14,
+        board.GP15,
+        board.GP19,
+        board.GP20,
+        board.GP21,
+        board.GP22,
+        board.GP26,
+        board.GP27,
+        board.GP28,
+    )
+    row_pins = (board.GP7, board.GP8, board.GP9, board.GP10)
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.GP6
+    rgb_num_pixels = 47
--- a/boards/jpconstantineau/offsetmx43/README.md
+++ b/boards/jpconstantineau/offsetmx43/README.md
@ -0,0 +1,15 @@
+# JPConstantineau's OffsetMX43: A 40% Staggered keyboard
+
+![OffsetMX43](https://cdn.tindiemedia.com/images/resize/Y9o1UdtekCSE5Jp5FesV2Q3qvCE=/p/fit-in/653x435/filters:fill(fff)/i/556481/products/2021-10-26T23%3A40%3A53.317Z-PXL_20211026_234121626.jpg?1635266543)
+
+43 Keys RGB Keyboard the same size as the GridMX47 but with staggered keys instead of ortholinear (keys in a grid).  Uses a Raspberry Pi Pico as the controller.
+
+kb.py is designed to work with the [Pico CircuitPython UF2](https://circuitpython.org/board/raspberry_pi_pico/)
+
+Retailers (USA)  
+[BlueMicro Store on Tindie](https://www.tindie.com/products/jpconstantineau/43-keys-rgb-keyboard-using-raspberry-pi-pico/)
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/offsetmx43/kb.py
+++ b/boards/jpconstantineau/offsetmx43/kb.py
@ -0,0 +1,25 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP11,
+        board.GP12,
+        board.GP13,
+        board.GP14,
+        board.GP15,
+        board.GP19,
+        board.GP20,
+        board.GP21,
+        board.GP22,
+        board.GP26,
+        board.GP27,
+        board.GP28,
+    )
+    row_pins = (board.GP7, board.GP8, board.GP9, board.GP10)
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.GP6
+    rgb_num_pixels = 47
--- a/boards/jpconstantineau/vcolchoc44/README.md
+++ b/boards/jpconstantineau/vcolchoc44/README.md
@ -0,0 +1,15 @@
+# JPConstantineau's VColChoc44: A Low Profile Atreus44 clone
+
+![VColChoc44](https://cdn.tindiemedia.com/images/resize/tbqfM8nhMn0hoDM0ZkwYxM23mU0=/p/full-fit-in/2400x1600/i/556481/products/2021-10-15T15%3A33%3A13.288Z-qj04uaoo2ht71.jpg?1634287023)
+
+44 Keys Low Profile RGB Keyboard inspired from Keyboardio's Atreus with a RP2040 Soldered on board.
+
+kb.py is designed to work with the [PyKey60 CircuitPython UF2](https://circuitpython.org/board/jpconstantineau_pykey60/)
+
+Retailers (USA)  
+[BlueMicro Store on Tindie](https://www.tindie.com/products/jpconstantineau/low-profile-44-keys-rgb-keyboard-pcb-with-a-rp2040/)  
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/vcolchoc44/kb.py
+++ b/boards/jpconstantineau/vcolchoc44/kb.py
@ -0,0 +1,24 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.COL1,
+        board.COL2,
+        board.COL3,
+        board.COL4,
+        board.COL5,
+        board.COL6,
+        board.COL7,
+        board.COL8,
+        board.COL9,
+        board.COL10,
+        board.COL11,
+    )
+    row_pins = (board.ROW1, board.ROW2, board.ROW3, board.ROW4)
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.NEOPIXEL
+    rgb_num_pixels = 44
--- a/boards/jpconstantineau/vcolmx44/README.md
+++ b/boards/jpconstantineau/vcolmx44/README.md
@ -0,0 +1,16 @@
+# JPConstantineau's VColMX44: An Atreus44 clone
+
+![VColMX44](https://cdn.tindiemedia.com/images/resize/5oEyXgxteB6wYjXv8kFC1B3YqOk=/p/full-fit-in/2400x1600/i/556481/products/2021-10-20T05%3A14%3A24.776Z-PXL_20211016_060203733.jpg?1634681706v)
+
+
+44 Keys RGB Keyboard inspired from Keyboardio's Atreus with a Raspberry Pi Pico
+
+kb.py is designed to work with the [Pico CircuitPython UF2](https://circuitpython.org/board/raspberry_pi_pico/)
+
+Retailers (USA)  
+[BlueMicro Store on Tindie](https://www.tindie.com/products/jpconstantineau/44-keys-rgb-keyboard-using-raspberry-pi-pico/)
+
+Extensions enabled by default  
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [MediaKeys](/docs/en/media_keys.md) Control volume and other media functions
--- a/boards/jpconstantineau/vcolmx44/kb.py
+++ b/boards/jpconstantineau/vcolmx44/kb.py
@ -0,0 +1,24 @@
+import board
+
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.scanners import DiodeOrientation
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        board.GP20,
+        board.GP19,
+        board.GP18,
+        board.GP17,
+        board.GP16,
+        board.GP5,
+        board.GP4,
+        board.GP3,
+        board.GP2,
+        board.GP1,
+        board.GP0,
+    )
+    row_pins = (board.GP22, board.GP21, board.GP14, board.GP15)
+    diode_orientation = DiodeOrientation.COL2ROW
+    rgb_pixel_pin = board.GP28
+    rgb_num_pixels = 44
--- a/boards/keebio/iris/README.md
+++ b/boards/keebio/iris/README.md
@ -2,14 +2,20 @@

 A split keyboard with a 4x6 layout with additional 4 thumb buttons

-kb.py is designed to work with the nice!nano
-kb_converter.py is designed to work with an itsybitsy with converter board found [here](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)
+kb_converter.py is designed to work with an itsybitsy with converter board found [here](/hardware)

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) Light it up
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
--- a/boards/keebio/iris/kb.py
+++ b/boards/keebio/iris/kb.py
@ -1,45 +1,39 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P1_00, board.P0_11, board.P1_04, board.P0_08, board.P0_22)
+    row_pins = (
+        board.pins[8],
+        board.pins[9],
+        board.pins[10],
+        board.pins[1],
+        board.pins[6],
+    )
    col_pins = (
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
+        board.pins[13],
+        board.pins[12],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    led_pin = board.P1_06
-    rgb_pixel_pin = board.P0_06
+    led_pin = board.pins[11]
+    rgb_pixel_pin = pins[0]
    rgb_num_pixels = 12
    i2c = board.I2C
-    data_pin = board.P0_20
-    powersave_pin = board.P0_13
+    data_pin = board.pins[5]

-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(12))
-    coord_mapping.extend(ic(1, x) for x in range(12))
-    coord_mapping.extend(ic(2, x) for x in range(12))
-
-    # Buckle up friends, the bottom row of this keyboard is wild, and making
-    # our layouts match, visually, what the keyboard looks like, requires some
-    # surgery on the bottom two rows of coords
-
-    # Row index 3 is actually perfectly sane and we _could_ expose it
-    # just like the above three rows, however, visually speaking, the
-    # top-right thumb cluster button (when looking at the left-half PCB)
-    # is more inline with R3, so we'll jam that key (and its mirror) in here
-    coord_mapping.extend(ic(3, x) for x in range(6))
-    coord_mapping.append(ic(4, 2))
-    coord_mapping.append(ic(4, 9))
-    coord_mapping.extend(ic(3, x) for x in range(6, 12))  # Now, the rest of R3
-
-    # And now, to handle R4, which at this point is down to just six keys
-    coord_mapping.extend(ic(4, x) for x in range(3, 9))
+    # flake8: noqa
+    # fmt: off
+    coord_mapping = [
+     0,  1,  2,  3,  4,  5,          35, 34, 33, 32, 31, 30,
+     6,  7,  8,  9, 10, 11,          41, 40, 39, 38, 37, 36,
+    12, 13, 14, 15, 16, 17,          47, 46, 45, 44, 43, 42,
+    18, 19, 20, 21, 22, 23, 26,  56, 53, 52, 51, 50, 49, 48,
+                27, 28, 29,          59, 58, 57,
+    ]
--- a/boards/keebio/iris/kb_converter.py
+++ b/boards/keebio/iris/kb_converter.py
@ -1,8 +1,7 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
@ -14,7 +13,7 @@ class KMKKeyboard(_KMKKeyboard):
    diode_orientation = DiodeOrientation.COLUMNS

    split_flip = True
-    split_offsets = (6, 6, 6, 6, 6)
+    split_offset = (6, 6, 6, 6, 6)
    split_type = 'UART'
    data_pin = board.SCL
    data_pin2 = board.SDA
@ -23,11 +22,6 @@ class KMKKeyboard(_KMKKeyboard):
    rgb_pixel_pin = board.TX
    led_pin = board.D7

-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(12))
-    coord_mapping.extend(ic(1, x) for x in range(12))
-    coord_mapping.extend(ic(2, x) for x in range(12))
-
    # Buckle up friends, the bottom row of this keyboard is wild, and making
    # our layouts match, visually, what the keyboard looks like, requires some
    # surgery on the bottom two rows of coords
@ -36,10 +30,11 @@ class KMKKeyboard(_KMKKeyboard):
    # just like the above three rows, however, visually speaking, the
    # top-right thumb cluster button (when looking at the left-half PCB)
    # is more inline with R3, so we'll jam that key (and its mirror) in here
-    coord_mapping.extend(ic(3, x) for x in range(6))
-    coord_mapping.append(ic(4, 2))
-    coord_mapping.append(ic(4, 9))
-    coord_mapping.extend(ic(3, x) for x in range(6, 12))  # Now, the rest of R3
-
-    # And now, to handle R4, which at this point is down to just six keys
-    coord_mapping.extend(ic(4, x) for x in range(3, 9))
+    # flake8: noqa
+    coord_mapping = [
+     0,  1,  2,  3,  4,  5,          36, 35, 34, 33, 32, 31,
+     6,  7,  8,  9, 10, 11,          42, 41, 40, 39, 38, 37,
+    12, 13, 14, 15, 16, 17,          48, 47, 46, 45, 44, 43,
+    18, 19, 20, 21, 22, 23, 26,  57, 54, 53, 52, 51, 50, 49,
+                28, 29, 30,          60, 59, 58,
+    ]
--- a/boards/keebio/iris/main.py
+++ b/boards/keebio/iris/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.consts import UnicodeMode
 from kmk.extensions.rgb import RGB
 from kmk.handlers.sequences import compile_unicode_string_sequences as cuss
--- a/boards/keebio/levinson/README.md
+++ b/boards/keebio/levinson/README.md
@ -2,14 +2,21 @@

 A split keyboard with a 4x6 layout

-kb.py is designed to work with the nice!nano
-kb_converter.py is designed to work with an itsybitsy with converter board found [here](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)
+kb_converter.py is designed to work with an itsybitsy with converter board found [here](/hardware)

 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) Light it up
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/keebio/levinson/kb.py
+++ b/boards/keebio/levinson/kb.py
@ -1,23 +1,24 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P0_22, board.P1_00, board.P0_11, board.P1_04)
+    row_pins = (board.pins[6], board.pins[8], board.pins[9], board.pins[10])
    col_pins = (
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
-        board.P0_10,
-        board.P0_09,
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
+        board.pins[13],
+        board.pins[12],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    rgb_pixel_pin = board.P0_06
+    rgb_pixel_pin = pins[0]
    rgb_num_pixels = 12
-    led_pin = board.P1_06
-    data_pin = board.P0_08
+    led_pin = board.pins[11]
+    data_pin = board.pins[1]
    i2c = board.I2C
    powersave_pin = board.P0_13
--- a/boards/keebio/levinson/kb_converter.py
+++ b/boards/keebio/levinson/kb_converter.py
@ -1,7 +1,7 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
--- a/boards/keebio/levinson/main.py
+++ b/boards/keebio/levinson/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.rgb import RGB
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/keebio/nyquist/README.md
+++ b/boards/keebio/nyquist/README.md
@ -2,15 +2,21 @@

 A split keyboard with a 5x6 layout

-kb.py is designed to work with the nice!nano
-kb_converter.py is designed to work with an itsybitsy with converter board found [here](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)
+kb_converter.py is designed to work with an itsybitsy with converter board found [here](/hardware)


 Extensions enabled by default  
- [Layers](https://github.com/KMKfw/kmk_firmware/tree/master/docs/layers.md) Need more keys than switches? Use layers.
- [RGB](https://github.com/KMKfw/kmk_firmware/tree/master/docs/rgb.md) Light it up
- [BLE_Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves without wires
+- [Layers](/docs/en/layers.md) Need more keys than switches? Use layers.
+- [RGB](/docs/en/rgb.md) Light it up
+- [BLE_Split](/docs/en/split_keyboards.md) Connects halves without wires

 Common Extensions
- [Split](https://github.com/KMKfw/kmk_firmware/tree/master/docs/split.md) Connects halves using a wire
- [Power](https://github.com/KMKfw/kmk_firmware/tree/master/docs/power.md) Powersaving features for battery life
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Power](/docs/en/power.md) Powersaving features for battery life
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
--- a/boards/keebio/nyquist/kb.py
+++ b/boards/keebio/nyquist/kb.py
@ -1,23 +1,29 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
-    row_pins = (board.P0_22, board.P1_00, board.P0_11, board.P1_04, board.P1_06)
+    row_pins = (
+        board.pins[6],
+        board.pins[8],
+        board.pins[9],
+        board.pins[10],
+        board.pins[11],
+    )
    col_pins = (
-        board.P0_08,
-        board.P0_29,
-        board.P0_02,
-        board.P1_15,
-        board.P1_13,
-        board.P1_11,
+        board.pins[1],
+        board.pins[18],
+        board.pins[17],
+        board.pins[16],
+        board.pins[15],
+        board.pins[14],
    )
    diode_orientation = DiodeOrientation.COLUMNS
-    rgb_pixel_pin = board.P0_06
+    rgb_pixel_pin = pins[0]
    rgb_num_pixels = 12
-    data_pin = board.P0_08
-    led_pin = board.P0_09
+    data_pin = board.pins[1]
+    led_pin = board.pins[12]
    i2c = board.I2C
-    powersave_pin = board.P0_13
--- a/boards/keebio/nyquist/kb_converter.py
+++ b/boards/keebio/nyquist/kb_converter.py
@ -1,7 +1,7 @@
 import board

 from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
+from kmk.scanners import DiodeOrientation


 class KMKKeyboard(_KMKKeyboard):
--- a/boards/keebio/nyquist/main.py
+++ b/boards/keebio/nyquist/main.py
@ -1,4 +1,5 @@
 from kb import KMKKeyboard
+
 from kmk.extensions.rgb import RGB
 from kmk.keys import KC
 from kmk.modules.layers import Layers
--- a/boards/klarank.py
+++ b/boards/klarank.py
@ -1,46 +0,0 @@
-import board
-
-from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
-from kmk.matrix import DiodeOrientation
-from kmk.matrix import intify_coordinate as ic
-from kmk.modules.layers import Layers
-
-# Implements what used to be handled by KMKKeyboard.swap_indicies for this
-# board, by flipping various row3 (bottom physical row) keys so their
-# coord_mapping matches what the user pressed (even if the wiring
-# underneath is sending different coordinates)
-_r3_swap_conversions = {3: 9, 4: 10, 5: 11, 9: 3, 10: 4, 11: 5}
-
-
-def r3_swap(col):
-    try:
-        return _r3_swap_conversions[col]
-    except KeyError:
-        return col
-
-
-class KMKKeyboard(_KMKKeyboard):
-    # physical, visible cols (SCK, MO, MI, RX, TX, D4)
-    # physical, visible rows (10, 11, 12, 13) (9, 6, 5, SCL)
-    col_pins = (board.SCK, board.MOSI, board.MISO, board.RX, board.TX, board.D4)
-    row_pins = (
-        board.D10,
-        board.D11,
-        board.D12,
-        board.D13,
-        board.D9,
-        board.D6,
-        board.D5,
-        board.SCL,
-    )
-    rollover_cols_every_rows = 4
-    diode_orientation = DiodeOrientation.COLUMNS
-
-    coord_mapping = []
-    coord_mapping.extend(ic(0, x) for x in range(12))
-    coord_mapping.extend(ic(1, x) for x in range(12))
-    coord_mapping.extend(ic(2, x) for x in range(12))
-    coord_mapping.extend(ic(3, r3_swap(x)) for x in range(12))
-
-    layers_ext = Layers()
-    modules = [layers_ext]
--- a/boards/kyria/README.md
+++ b/boards/kyria/README.md
@ -0,0 +1,59 @@
+# Kyria Keyboard
+
+A split keyboard with a 3x6 columnar stagger and 7 thumb keys. One button on each side is usually replaced by an
+encoder.
+
+Official retailer of Kyria PCB: [splitkb.com](https://splitkb.com/collections/keyboard-kits/products/kyria-pcb-kit). PCB
+was designed with QMK in mind and KMK implementation is not officially supported by PCB designer and seller.
+
+Keyboard works with controllers having Pro Micro layout. Existing configurations:
+
+| PCB version | Board                               | Config file               |
+|:-----------:|-------------------------------------|---------------------------|
+|     1.*     | Any quickpin pro micro based board. | kb_v1_                    |
+|     2.*     | Any quickpin pro micro based board. | _waiting for pinout docs_ |
+
+## Compatibility issues
+
+- **TRRS connection** - KMK has no protocol for one-pin communication between two splits. So, if you are using TRRS wire
+  connection, only right side send matrix events to the left side. No issue when using BLE.
+- **Right side encoder** - right encoder currently doesn't send updates to left half and can even freeze right half
+- **OLED screens** - OLED screens are not required, but often element of Kyria keyboards. KMK have no official OLED
+  implementation, but as it's based on Circuit Python, adding one is very simple and there are many examples, also on
+  KMK forks
+
+## `main.py` example config
+
+Current layout is based on default [QMK Kyria layout](https://config.qmk.fm/#/splitkb/kyria/rev1/LAYOUT)
+
+It has the following modules/extensions enabled:
+
+- [Split](/docs/en/split_keyboards.md) Connects halves using a wire
+- [Layers](/docs/en/layers.md) Do you need more keys than switches? Use
+  layers.
+- [HoldTap](/docs/en/holdtap.md) Enable press/hold double binding of keys
+- [MediaKeys](/docs/en/media_keys.md) Common media controls
+
+Also uncomment right section to enable samples of following:
+
+- [RGB](/docs/en/rgb.md) Turn on the backlight (**requires neopixel.py
+  library to work**)
+- [Encoder](docs/encoder.md) Make the knobs do something
+
+## More steps required during install
+
+In order to mitigate lack of one-wire protocol, KMK use its UART implementation but with special low-level PIO
+subprogram available only on RP2040. It allows using other pins for UART than on-board RX and TX.
+
+Because of the above, besides of normal installation steps, you have to also:
+
+- install Circuit Python in 7.2+ version
+- add `adafruit_pioasm.mpy` library to lib or root folder of a board
+
+## Microcontroller support
+
+Update this line in `kb.py` to any supported microcontroller in `kmk/quickpin/pro_micro`:
+
+```python
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+```
--- a/boards/kyria/kb_v1.py
+++ b/boards/kyria/kb_v1.py
@ -0,0 +1,33 @@
+from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
+from kmk.quickpin.pro_micro.boardsource_blok import pinout as pins
+from kmk.scanners import DiodeOrientation
+from kmk.scanners import intify_coordinate as ic
+
+
+class KMKKeyboard(_KMKKeyboard):
+    col_pins = (
+        pins[19],
+        pins[18],
+        pins[17],
+        pins[16],
+        pins[15],
+        pins[14],
+        pins[13],
+        pins[12],
+    )
+    row_pins = (pins[10], pins[9], pins[8], pins[6])
+    diode_orientation = DiodeOrientation.COL2ROW
+    data_pin = pins[1]
+    rgb_pixel_pin = pins[0]
+    encoder_pin_0 = pins[11]
+    encoder_pin_1 = pins[7]
+
+    coord_mapping = []
+    coord_mapping.extend(ic(0, x, 8) for x in range(6))
+    coord_mapping.extend(ic(4, x, 8) for x in range(5, -1, -1))
+    coord_mapping.extend(ic(1, x, 8) for x in range(6))
+    coord_mapping.extend(ic(5, x, 8) for x in range(5, -1, -1))
+    coord_mapping.extend(ic(2, x, 8) for x in range(8))
+    coord_mapping.extend(ic(6, x, 8) for x in range(7, -1, -1))
+    coord_mapping.extend(ic(3, x, 8) for x in range(3, 8))
+    coord_mapping.extend(ic(7, x, 8) for x in range(7, 2, -1))
--- a/boards/kyria/main.py
+++ b/boards/kyria/main.py
@ -0,0 +1,99 @@
+from kyria_v1_rp2040 import KMKKeyboard
+
+from kmk.extensions.media_keys import MediaKeys
+from kmk.extensions.rgb import RGB, AnimationModes
+from kmk.keys import KC
+from kmk.modules.encoder import EncoderHandler
+from kmk.modules.holdtap import HoldTap
+from kmk.modules.layers import Layers
+from kmk.modules.split import Split, SplitType
+
+keyboard = KMKKeyboard()
+keyboard.debug_enabled = True
+
+keyboard.modules.append(Layers())
+keyboard.modules.append(HoldTap())
+keyboard.extensions.append(MediaKeys())
+
+# Using drive names (KYRIAL, KYRIAR) to recognize sides; use split_side arg if you're not doing it
+split = Split(split_type=SplitType.UART, use_pio=True)
+keyboard.modules.append(split)
+
+# Uncomment below if you're using encoder
+encoder_handler = EncoderHandler()
+encoder_handler.pins = ((keyboard.encoder_pin_0, keyboard.encoder_pin_1, None, False),)
+
+# Uncomment below if you're having RGB
+rgb_ext = RGB(
+    pixel_pin=keyboard.rgb_pixel_pin,
+    num_pixels=10,
+    animation_mode=AnimationModes.BREATHING_RAINBOW,
+)
+keyboard.extensions.append(rgb_ext)
+
+# Edit your layout below
+# Currently, that's a default QMK Kyria Layout - https://config.qmk.fm/#/splitkb/kyria/rev1/LAYOUT
+ESC_LCTL = KC.HT(KC.ESC, KC.LCTL)
+QUOTE_RCTL = KC.HT(KC.QUOTE, KC.RCTL)
+ENT_LALT = KC.HT(KC.ENT, KC.LALT)
+MINUS_RCTL = KC.HT(KC.MINUS, KC.RCTL)
+keyboard.keymap = [
+    [
+        KC.TAB,        KC.Q,          KC.W,          KC.E,          KC.R,          KC.T,                                                                      KC.Y,          KC.U,          KC.I,          KC.O,          KC.P,          KC.BSPC,
+        ESC_LCTL,      KC.A,          KC.S,          KC.D,          KC.F,          KC.G,                                                                      KC.H,          KC.J,          KC.K,          KC.L,          KC.SCLN,       QUOTE_RCTL,
+        KC.LSFT,       KC.Z,          KC.X,          KC.C,          KC.V,          KC.B,          KC.LBRC,       KC.CAPS,       KC.MO(5),      KC.RBRC,       KC.N,          KC.M,          KC.COMM,       KC.DOT,        KC.SLSH,       KC.RSFT,
+                                                     KC.MO(6),      KC.LGUI,       ENT_LALT,      KC.SPC,        KC.MO(3),      KC.MO(4),      KC.SPC,        KC.RALT,       KC.RGUI,       KC.APP,
+    ],
+    [
+        KC.TAB,        KC.QUOT,       KC.COMM,       KC.DOT,        KC.P,          KC.Y,                                                                      KC.F,          KC.G,          KC.C,          KC.R,          KC.L,          KC.BSPC,
+        ESC_LCTL,      KC.A,          KC.O,          KC.E,          KC.U,          KC.I,                                                                      KC.D,          KC.H,          KC.T,          KC.N,          KC.S,          MINUS_RCTL,
+        KC.LSFT,       KC.SCLN,       KC.Q,          KC.J,          KC.K,          KC.X,          KC.LBRC,       KC.CAPS,       KC.MO(5),      KC.RBRC,       KC.B,          KC.M,          KC.W,          KC.V,          KC.Z,          KC.RSFT,
+                                                     KC.MO(6),      KC.LGUI,       ENT_LALT,      KC.SPC,        KC.MO(3),      KC.MO(4),      KC.SPC,        KC.RALT,       KC.RGUI,       KC.APP,
+    ],
+    [
+        KC.TAB,        KC.Q,          KC.W,          KC.F,          KC.P,          KC.B,                                                                      KC.J,          KC.L,          KC.U,          KC.Y,          KC.SCLN,       KC.BSPC,
+        ESC_LCTL,      KC.A,          KC.R,          KC.S,          KC.T,          KC.G,                                                                      KC.M,          KC.N,          KC.E,          KC.I,          KC.O,          QUOTE_RCTL,
+        KC.LSFT,       KC.Z,          KC.X,          KC.C,          KC.D,          KC.V,          KC.LBRC,       KC.CAPS,       KC.MO(5),      KC.RBRC,       KC.K,          KC.H,          KC.COMM,       KC.DOT,        KC.SLSH,       KC.RSFT,
+                                                     KC.MO(6),      KC.LGUI,       ENT_LALT,      KC.SPC,        KC.MO(3),      KC.MO(4),      KC.SPC,        KC.RALT,       KC.RGUI,       KC.APP,
+    ],
+    [
+        KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,                                                    KC.PGUP,    KC.HOME,    KC.UP,      KC.END,     KC.VOLU,    KC.DEL,
+        KC.TRNS,    KC.LGUI,    KC.LALT,    KC.LCTL,    KC.LSFT,    KC.TRNS,                                                    KC.PGDN,    KC.LEFT,    KC.DOWN,    KC.RGHT,    KC.VOLD,    KC.INS,
+        KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.SLCK,    KC.TRNS,    KC.TRNS,    KC.PAUS,    KC.MPRV,    KC.MPLY,    KC.MNXT,    KC.MUTE,    KC.PSCR,
+                                            KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,
+    ],
+    [
+        KC.GRV,     KC.N1,      KC.N2,      KC.N3,      KC.N4,      KC.N5,                                                      KC.N6,      KC.N7,      KC.N8,      KC.N9,      KC.N0,      KC.EQL,
+        KC.TILD,    KC.EXLM,    KC.AT,      KC.HASH,    KC.DLR,     KC.PERC,                                                    KC.CIRC,    KC.AMPR,    KC.ASTR,    KC.LPRN,    KC.RPRN,    KC.PLUS,
+        KC.PIPE,    KC.BSLS,    KC.COLN,    KC.SCLN,    KC.MINS,    KC.LBRC,    KC.LCBR,    KC.TRNS,    KC.TRNS,    KC.RCBR,    KC.RBRC,    KC.UNDS,    KC.COMM,    KC.DOT,     KC.SLSH,    KC.QUES,
+                                            KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,
+    ],
+    [
+        KC.TRNS,    KC.F9,      KC.F10,     KC.F11,     KC.F12,     KC.TRNS,                                                    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,
+        KC.TRNS,    KC.F5,      KC.F6,      KC.F7,      KC.F8,      KC.TRNS,                                                    KC.TRNS,    KC.RSFT,    KC.RCTL,    KC.LALT,    KC.RGUI,    KC.TRNS,
+        KC.TRNS,    KC.F1,      KC.F2,      KC.F3,      KC.F4,      KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,
+                                            KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,    KC.TRNS,
+    ],
+    [
+        KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.DF(0),      KC.TRNS,       KC.TRNS,                                                                   KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,
+        KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.DF(1),      KC.TRNS,       KC.TRNS,                                                                   KC.RGB_TOG,    KC.RGB_SAI,    KC.RGB_HUI,    KC.RGB_VAI,    KC.RGB_M_P,    KC.TRNS,
+        KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.DF(2),      KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.RGB_SAD,    KC.RGB_HUD,    KC.RGB_VAD,    KC.RGB_M_P,    KC.TRNS,
+                                                     KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,       KC.TRNS,
+    ],
+]
+
+# Uncomment below if using an encoder
+# Edit your encoder layout below
+encoder_handler.map = (
+    ((KC.VOLD, KC.VOLU),),
+    ((KC.VOLD, KC.VOLU),),
+    ((KC.VOLD, KC.VOLU),),
+    ((KC.MPRV, KC.MNXT),),
+    ((KC.MPRV, KC.MNXT),),
+    ((KC.MPRV, KC.MNXT),),
+    ((KC.MPRV, KC.MNXT),),
+)
+keyboard.modules.append(encoder_handler)
+
+if __name__ == '__main__':
+    keyboard.go()
--- a/Show More
+++ b/Show More