|  | @@ -1,19 +1,23 @@
 | 
	
		
			
				|  |  |  Arsenik
 | 
	
		
			
				|  |  |  ================================================================================
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -A beginner-friendly, [Miryoku][1]-like approach to minimize finger movements:
 | 
	
		
			
				|  |  | +Configure your keyboard (even if it is not programmable) with a
 | 
	
		
			
				|  |  | +beginner-friendly, [Miryoku][1]-like approach to minimize finger movements!
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -- 3 home-row mods per hand for <kbd>Ctrl</kbd>, <kbd>Alt</kbd>, <kbd>Super</kbd>
 | 
	
		
			
				|  |  | -- 3 layer-tap keys under the thumbs: <kbd>Shift</kbd>/<kbd>Backspace</kbd>,
 | 
	
		
			
				|  |  | -<kbd>Navigation</kbd>/<kbd>Space</kbd>, <kbd>Symbol</kbd>/<kbd>Return</kbd>
 | 
	
		
			
				|  |  | +You can choose your options:
 | 
	
		
			
				|  |  | +- [angle-mod](https://colemakmods.github.io/ergonomic-mods/angle.html) (by
 | 
	
		
			
				|  |  | +default the only option activated)
 | 
	
		
			
				|  |  | +- 3 home-row mods (HRM) per hand for <kbd>Ctrl</kbd>, <kbd>Alt</kbd>, <kbd>Super</kbd>
 | 
	
		
			
				|  |  | +- 3 layer-tap keys under the thumbs: <kbd>Alt</kbd> (or <kbd>Shift</kbd> in 
 | 
	
		
			
				|  |  | +HRM)/<kbd>Backspace</kbd>, <kbd>Navigation</kbd>/<kbd>Space</kbd>,
 | 
	
		
			
				|  |  | +<kbd>Symbol</kbd>/<kbd>Return</kbd>
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  **Bring the keys to your fingers, rather than moving your fingers to the keys!**
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  - A long press on the <kbd>Return</kbd> key brings up the <kbd>Symbol</kbd>
 | 
	
		
			
				|  |  | -layer, where all programming symbols are arranged for comfort and efficiency,
 | 
	
		
			
				|  |  | -Dvorak-like.
 | 
	
		
			
				|  |  | +layer, where all programming symbols are arranged for comfort and efficiency.
 | 
	
		
			
				|  |  |  - A long press on the <kbd>Space</kbd> bar brings up the <kbd>Navigation</kbd>
 | 
	
		
			
				|  |  |  layer, with a numpad, cursor navigation (<kbd>ESDF</kbd>) and one-hand shortcuts.
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -49,14 +53,14 @@ a step-by-step approach.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  ### 1. Supercharge Your Thumbs
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -If you’re new to mod-taps, we suggest to start with the “easy” variants where
 | 
	
		
			
				|  |  | -only the thumbs are affected:
 | 
	
		
			
				|  |  | +If you’re new to mod-taps, we suggest to start by adding the “layer-tap” option
 | 
	
		
			
				|  |  | +where only the thumbs are affected:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -- the left thumb key remains a <kbd>Cmd</kbd> or <kbd>Alt</kbd> key when hold,
 | 
	
		
			
				|  |  | +- the left thumb key remains a <kbd>Cmd</kbd> or <kbd>Alt</kbd> key when held,
 | 
	
		
			
				|  |  |  but emits a <kbd>Backspace</kbd> when tapped;
 | 
	
		
			
				|  |  | -- the right thumb key brings the <kbd>Symbols</kbd> layer when hold (similar to
 | 
	
		
			
				|  |  | +- the right thumb key brings the <kbd>Symbols</kbd> layer when held (similar to
 | 
	
		
			
				|  |  |  an <kbd>AltGr</kbd> key), and emits <kbd>Return</kbd> when tapped;
 | 
	
		
			
				|  |  | -- the spacebar brings the <kbd>Navigation</kbd> layer when hold.
 | 
	
		
			
				|  |  | +- the spacebar brings the <kbd>Navigation</kbd> layer when held.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -70,9 +74,9 @@ When you are familiar with mod-taps, it’s time to enable them on the homerow
 | 
	
		
			
				|  |  |  with the “hrm” variants:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  - <kbd>FDS</kbd> and <kbd>JKL</kbd> become <kbd>Ctrl</kbd>, <kbd>Alt</kbd>,
 | 
	
		
			
				|  |  | -<kbd>Super</kbd> when hold long enough;
 | 
	
		
			
				|  |  | +<kbd>Super</kbd> when held long enough;
 | 
	
		
			
				|  |  |  - the left thumb key can now emit a <kbd>Shift</kbd> rather than <kbd>Alt</kbd>
 | 
	
		
			
				|  |  | -wen hold.
 | 
	
		
			
				|  |  | +when held.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -84,15 +88,73 @@ thumb key, and symmetrical modifiers on the homerow.
 | 
	
		
			
				|  |  |  - the 300 ms delay before a key becomes a modifier has been chosen to be easy
 | 
	
		
			
				|  |  |  for beginners. Once used to mod-taps, you may want to reduce it so keyboard
 | 
	
		
			
				|  |  |  shortcuts can be done more quickly;
 | 
	
		
			
				|  |  | -- adding new layers should be easy, even without additional thumb keys — check
 | 
	
		
			
				|  |  | -[the Selenium33 mod][11] to get some ideas.
 | 
	
		
			
				|  |  | +- more layers available to enable (Vim-navigation, num-row, etc).
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +#### A Vim-friendly mod:
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +- 3 home-row mods per hand for <kbd>Ctrl</kbd>, <kbd>Alt</kbd>, <kbd>Super</kbd>
 | 
	
		
			
				|  |  | +- 3 layer-tap keys under the thumbs: <kbd>Shift</kbd>/<kbd>Backspace</kbd>,
 | 
	
		
			
				|  |  | +<kbd>Navigation</kbd>/<kbd>Space</kbd>, <kbd>Symbol</kbd>/<kbd>Return</kbd>
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +It uses 4 layers (instead of 3 for Arsenik), which makes it a natural fit
 | 
	
		
			
				|  |  | +for 34-key keyboards like the [Ferris][34].
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +- Vim-like navigation in all apps, with any OS layout
 | 
	
		
			
				|  |  | +- super-comfortable <kbd>Tab</kbd> and <kbd>Shift</kbd>-<kbd>Tab</kbd>
 | 
	
		
			
				|  |  | +- mouse emulation: previous / next and mouse scroll
 | 
	
		
			
				|  |  | +- easy left-hand shortcuts
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +This <kbd>Navigation</kbd> layer has a few empty slots on purpose, so you can
 | 
	
		
			
				|  |  | +add our own keys or layers.
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +#### NumRow >> NumPad
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +In <kbd>Symbol</kbd> mode, pressing the left thumb key brings up the
 | 
	
		
			
				|  |  | +<kbd>NumRow</kbd> layer:
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +- all digits are on the home row, in the order you already know
 | 
	
		
			
				|  |  | +- the upper row helps with <kbd>Shift</kbd>-digit shortcuts
 | 
	
		
			
				|  |  | +- the lower row has dash, comma, dot and slash signs to help with number / date
 | 
	
		
			
				|  |  | +inputs
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +Even on keyboards that *do* have a physical number row, this <kbd>NumRow</kbd>
 | 
	
		
			
				|  |  | +layer can be interesting to use in order to minimize finger movements further
 | 
	
		
			
				|  |  | +more. And it makes it easier to mix symbols with numbers (e.g. `[0]`).
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Downloads
 | 
	
		
			
				|  |  |  --------------------------------------------------------------------------------
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | +### kanata
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  |  [Non-programmable keyboards are supported through kanata.](kanata)
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | +### QMK
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +The QMK implementation is a bit different:
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +- it takes advantage of the 4 thumb keys
 | 
	
		
			
				|  |  | +- the Navigation layer uses a mouse emulation on the left hand
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +In fact, this is what I ended up with for my beloved Ferris in the first place,
 | 
	
		
			
				|  |  | +and Arsenik/Selenium is an attempt to fit most of this magic into my laptop keyboard.
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +```bash
 | 
	
		
			
				|  |  | +# from the `qmk_firmware` root:
 | 
	
		
			
				|  |  | +make ferris/0_2/bling:1dk:flash
 | 
	
		
			
				|  |  | +```
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### Others
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  |  Other desktop implementations (kmonad, keyd…) would be nice to see as well.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Programmable keyboards should be trivial to configure with QMK, ZMK,
 | 
	
	
		
			
				|  | @@ -128,7 +190,6 @@ AltGr layer at all (e.g. QWERTY, Colemak, Workman…), or an optimized AltGr lay
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  - [Miryoku][1]: 36 keys, 6 layers
 | 
	
		
			
				|  |  |  - [Seniply][7]: 34 keys, 6 layers, no layer-taps (“Callum-style”)
 | 
	
		
			
				|  |  | -- [Selenium33][11]: 33 keys, 4 layers — a Vim-friendly Arsenik mod
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  <!-- https://jasoncarloscox.com/writing/combo-mods/ -->
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -140,13 +201,10 @@ AltGr layer at all (e.g. QWERTY, Colemak, Workman…), or an optimized AltGr lay
 | 
	
		
			
				|  |  |  [6]: https://github.com/lobre/shaka34
 | 
	
		
			
				|  |  |  [7]: https://stevep99.github.io/seniply/
 | 
	
		
			
				|  |  |  [8]: https://getreuer.info/posts/keyboards/symbol-layer/#my-symbol-layer
 | 
	
		
			
				|  |  | -[11]: mods/selenium33
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  TODO
 | 
	
		
			
				|  |  |  --------------------------------------------------------------------------------
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -- angle mods!
 | 
	
		
			
				|  |  |  - KMonad / Karabiner support
 | 
	
		
			
				|  |  |  - sample QMK / ZMK implementations for common keyboards
 | 
	
		
			
				|  |  | -- variants for specific OS layouts
 |