#+SETUPFILE: 
#+TITLE: Keyboard Config README

* Keyboard Config

[[https://shop.keyboard.io/collections/keyboardio-atreus/products/keyboardio-atreus][Keyboardio Atreus]] with Alpha Layer based on Colemak, more specifically the [[https://colemakmods.github.io/mod-dh/keyboards.html#matrix-keyboards][mod-DH for Matrix]] keyboard variant.

This is modified for my personal environment with i3wm + Spacemacs!

** The Layout

[[./keyboard-layout-colemak-DHm.png]]

- alpha and shift layers work normally
- SYMBOLS and numbers are activated with right thumb (blue)
- NAV layer (orange) activated by holding Backspace key
- TAB and Enter keys work as extra Ctrl keys when hold for more than 250ms
- mouse movement with WASD (QWERTY) keys when holding M
- some additional utility keys are activated on hold (german umlaute, Ctrl+C,V,X,Z)
  
- [[https://kaleidoscope.readthedocs.io/en/latest/quick_start.html][Kaleidoscope Quick Start]] 
- blog article on customizing the Atreus for developers: https://www.gettommy.com/posts/my-ergonomic-40-percent-keyboard-layout-for-german-developers/#where-to-go-from-here
- typing practise: https://www.keybr.com/
- typing speedtest with layout emulator: https://monkeytype.com/
- [[http://www.keyboard-layout-editor.com/][Keyboard Layout Editor]] 

** Build and run

- git clone Kaleidoscope
- export KALEIDOSCOPE
- make flash
  
** TODO

- fully implement a sane extended layer like[[https://dreymar.colemak.org/layers-extend.html][ this]]
- add mouse warping: https://kaleidoscope.readthedocs.io/en/latest/plugins/Kaleidoscope-MouseKeys.html#warping
- maybe completely remove the NAV and TAB keys

** Adjusted  QWERTY Layer for gaming

[[./keyboard-layout-GW-gaming_draft.png]]