diff options
author | Mike Tsao <mike@sowbug.com> | 2021-02-09 20:45:42 -0800 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-02-09 20:45:42 -0800 |
commit | 872f656c3b3d94067315029c3996a1f268ff9cd3 (patch) | |
tree | 55421755883f6c5adb26523e7ca4d8320b174b5c /keyboards/sowbug/68keys/readme.md | |
parent | fb9f619d8950812a6c5b5c6826891fcefb8eb677 (diff) | |
download | qmk_firmware-872f656c3b3d94067315029c3996a1f268ff9cd3.tar.gz qmk_firmware-872f656c3b3d94067315029c3996a1f268ff9cd3.zip |
[Keyboard] Add sowbug/68keys and sowbug/ansi_tkl (#11589)
Diffstat (limited to 'keyboards/sowbug/68keys/readme.md')
-rw-r--r-- | keyboards/sowbug/68keys/readme.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/keyboards/sowbug/68keys/readme.md b/keyboards/sowbug/68keys/readme.md new file mode 100644 index 0000000000..2ac5e73c4f --- /dev/null +++ b/keyboards/sowbug/68keys/readme.md @@ -0,0 +1,33 @@ +# 68keys + +A 68-key keyboard with per-key RGB, Kailh hotswap sockets, and USB-C. Uses Blue Pill. + +## History + +This keyboard was inspired by the [68keys.io](https://68keys.io/) keyboard. The +68keys keyboard has a similar layout to the +[MagicForce 68](https://www.amazon.com/Qisan-Mechanical-Keyboard-68-Keys-Magicforce/dp/B01E8KO2B0). +[di0ib](https://github.com/di0ib) did a +[replacement PCB](https://github.com/di0ib/tmk_keyboard/tree/master/keyboard/mf68) +for the Magicforce 68. + +I love the Magicforce 68, but wanted a few changes. As a colossally +disproportionate response to this challenge, I created +[a utility](https://github.com/sowbug/keycad/) that generates PCBs from +arbitrary KLE JSON files, and used it to create this keyboard. + +## A note about backlighting + +I wanted my per-key RGB keyboard to have a dim backlight on all keys, but didn't +want to sacrifice cool RGB matrix effects to have it. So I wrote up +[a QMK patch](https://github.com/sowbug/qmk_firmware/commit/f7f859ceeefde40e639cfc75044af477504d30f8) +that treats RGB(0, 0, 0) as eligible for backlighting. Unfortunately the QMK +maintainers weren't interested (actually, now that I look back, I didn't submit +a pull request, but rather discussed it in a chat room), so it's not upstreamed. +Thus you'll have to add that patch (and +[this](https://github.com/sowbug/qmk_firmware/commit/ff17800ef4a9cba59d754c72720d6877edb8fbb9)) +to your copy of QMK and then enable it in config.h and rules.mk. + +## Building and flashing + +`qmk flash -kb sowbug/68keys -km default` |