Hady's QMK userspace

This is a QMK "userspace" for my Kinesis Advantage keyboard firmware -- my very first ergo keyboard.

Local Development

1. Setup qmk development environment: https://docs.qmk.fm/#/newbs_getting_started
2. Link this repository to the qmk directory a keycap folder

# Create a symlink of the `keymap_kinesis` folder into `kinesis` keyboard folder inside qmk directory
ln -s $PWD/keymap_kinesis ../qmk_firmware/keyboards/kinesis/keymaps/hadynz
ln -s $PWD/keymap_keychron_q2 ../qmk_firmware/keyboards/keychron/q2/ansi_encoder/keymaps/hadynz

# Compile
qmk compile -kb kinesis/stapelberg -km hadynz
qmk compile -kb keychron/q2/ansi_encoder -km hadynz

# Create (QMK Configurator) JSON file from keymap
qmk c2json -kb kinesis/stapelberg -km hadynz ./keymap_kinesis/keymap.c > keymap_kinesis.json
qmk c2json -kb keychron/q2/ansi_encoder -km hadynz ./keymap_keychron_q2/keymap.c > keymap_keychron_q2.json

# Render keyma to SVG
keymap parse -c 10 -q keymap.json > kinesis_keymap.yaml
keymap draw kinesis_keymap.yaml > kinesis_keymap.svg

Background

The Keyboard

A Kinesis Advantage 1 keyboard with Cherry MX Brown switches. The keyboard has been modified with the "stapelberg" mod. In other words, the keyboard's original controller has been gutted and replaced with a Teensy 2.0++ that runs the feature-rich QMK firmware.

Building and flashing the firmware

The firmware is automatically built using the QMK CLI that runs on GitHub Actions.

Once built, the firmware is flashed onto the Teensy 2.0++ using the Teensy Loader.

Layout

I bought my keyboard second hand and have built on top of the previous owner (Uric Marker)'s layout which was largely inspired by the Miryoku layout.

It currently has the following features:

• Layer 0 -- Colemak DH layout with mirrored home row mods
• Layer 1 -- Windows layer
• Layer 2 -- Numbers layer
• Layer 3 -- Shift symbols layer
• Layer 4 -- Mouse layer

References:

• https://github.com/caksoylar/qmk_userspace
• https://github.com/filterpaper/qmk_userspace