|
@@ -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
|