11# My QMK keyboard layout
22
3- Based on Miryoku Layout
3+ This is a QWERTY Miryoku-inspired layout optimized for ergonomics.
4+
5+ It's a Split 3x6_3 with the outer columns dedicated to Window management shortcuts.
6+
7+ It features:
8+
9+ - Predictive Tap Hold: Faster tap/hold decisions
10+ - Home row mods
11+ - Layer-tap keys: Hold thumb keys to access layers, tap for the base key
12+ - Raw HID: Layer state communication to a companion app
13+
14+ Remember:
415
516- Don’t connect or disconnect the TRRS cable when the keyboard is powered. Always disconnect the USB cable first.
6- - Flash the firmware on both Raspberry Pi Picos.
7- - Enter the bootloader mode by holding down the BOOTSEL button while reconnecting the board into USB port.
17+ - Flash the firmware on both sides.
818
9- https://github.com/beekeeb/piantor
19+ ![ Base Layout ] ( ./data/layers/miryoku-kle-base.png )
1020
11- https://github.com/qmk/qmk_firmware/tree/master/keyboards/beekeeb/piantor
21+ ## Keyboards
22+
23+ - [ Piantor ] ( ./keyboards/beekeeb/piantor/readme.md )
24+ - [ Corne ] ( ./keyboards/crkbd/rev1/readme.md )
1225
1326## Keyboard Layers App companion
1427
1528Display the selected keyboard layer layout on screen to assist your to memorize the key's locations.
1629
1730It allows you to display the layout in a remote screen, so you can use a tablet or similar to save space on your main screen.
1831
19- Details here: https://github.com/maatthc/miryoku_qmk_app
32+ Details here: https://github.com/maatthc/keyboard_layers_app_companion
2033
2134## Compile and Flash
2235
2336### Install and setup
2437- Install QMK:
25- ` python3 -m pip install qmk `
38+ ```
39+ python3 -m pip install qmk
40+ ```
2641
2742- Initialize the sub-modules:
28- ` git submodule update --init --recursive `
43+ ```
44+ git submodule update --init --recursive
45+ ```
2946
3047- Set this folder as an userspace:
31- ` qmk config user.overlay_dir="$(realpath qmk_userspace)" `
48+ ```
49+ qmk config user.overlay_dir="$(realpath qmk_userspace)"
50+ ```
3251
3352- Set up QMK:
34- ` cd ..; qmk setup `
53+ ```
54+ cd ..; qmk setup
55+ ```
56+
57+ #### Piantor
58+ ```
59+ export KEYBOARD="beekeeb/piantor"
60+ ```
61+ #### Corne
3562
36- ### Install old GCC 8.3.0
37- Reduces size considerably (~ 1.5k):
63+ ```
64+ export KEYBOARD="crkbd/rev1"
65+ ```
3866
39- ` ./install_avr_8.3.0.sh `
40- export PATH=${HOME}/avr_toolchain/bin:$PATH
67+ ##### Compile with GCC v8.3.0
68+ Generates a firmware considerably smaller (~ 1.5k):
69+
70+ ```
71+ ./install_avr_8.3.0.sh
72+ export PATH=${PWD}/avr_toolchain/bin:$PATH
73+ ```
4174
4275### Compile
43- ` qmk compile -kb beekeeb/piantor -km maat `
76+ ```
77+ qmk compile -kb $KEYBOARD -km maat
78+ ```
4479
4580### Flash
46- ` qmk flash -kb beekeeb/piantor -km maat `
81+ ```
82+ qmk flash -kb $KEYBOARD -km maat
83+ ```
4784
48- ### Generates the clang compile_commands.json
49- ` qmk compile --compiledb -kb crkbd/rev1 -km maat `
85+ ### Generates the Clang compile_commands.json
86+ ```
87+ qmk compile --compiledb -kb $KEYBOARD -km maat
88+ ```
5089
5190### Check debug logs
52- ` qmk console `
91+ ```
92+ qmk console
93+ ```
5394
5495### info
5596
56- ` qmk info -kb beekeeb/piantor -km maat `
97+ ```
98+ qmk info -kb $KEYBOARD -km maat
99+ ```
57100
58101## Configuration
59102
60- - users/maat/
61- - keyboards/beekeeb/piantor/keymaps/maat/
103+ - ./users/maat/
104+ - ./keyboards/beekeeb/piantor/keymaps/maat/
105+ - ./keyboards/crkbd/rev1/keymaps/maat/
62106
63107### Typing Test
64108
@@ -67,21 +111,23 @@ https://config.qmk.fm/#/test
67111### Symbols that correspond to keycodes available in QMK.
68112https://docs.qmk.fm/keycodes
69113
70- ## Generated Layout/Layers images
114+ ## All Layers
115+
116+ Definitions (.json) files at: ./data/layers/
71117
72- Json files and images at: ./data/layers/
118+ Images generated with [ KLE NG ] ( https://editor.keyboard-tools.xyz/ )
73119
74- - ![ Base] ( ./data/layers/miryoku-kle-base.png )
120+ ![ Base] ( ./data/layers/miryoku-kle-base.png )
75121
76- - ![ Media] ( ./data/layers/miryoku-kle-media.png )
122+ ![ Media] ( ./data/layers/miryoku-kle-media.png )
77123
78- - ![ Nav] ( ./data/layers/miryoku-kle-nav.png )
124+ ![ Nav] ( ./data/layers/miryoku-kle-nav.png )
79125
80- - ![ Mouse] ( ./data/layers/miryoku-kle-mouse.png )
126+ ![ Mouse] ( ./data/layers/miryoku-kle-mouse.png )
81127
82- - ![ Symbols] ( ./data/layers/miryoku-kle-sym.png )
128+ ![ Symbols] ( ./data/layers/miryoku-kle-sym.png )
83129
84- - ![ Numbers] ( ./data/layers/miryoku-kle-num.png )
130+ ![ Numbers] ( ./data/layers/miryoku-kle-num.png )
85131
86- - ![ Fun ] ( ./data/layers/miryoku-kle-fun.png )
132+ ![ Functions ] ( ./data/layers/miryoku-kle-fun.png )
87133
0 commit comments