@ -39,6 +39,7 @@ Merging branches can be performed automatically at build time for [[#workflow-bu
Any local changes to existing workflow files should be made independently in commits with messages starting ~[miryoku-github]~ so that they can also be automatically excluded in workflow builds.
** Building
@ -171,7 +172,9 @@ The ~merge~ option can be used to merge branches at build time. Branches are spe
The Build Inputs workflow can be used without editing workflow files. Select Run workflow, select the Branch and fill out the form as desired, and activate Run workflow.
Options are specified by entering values directly in the corresponding field. Multiple comma separated values can be entered per option and a matrix build will be performed for each combination of values across all options.
Most options are specified by entering values directly in the corresponding field. Multiple comma separated values can be entered per option and a matrix build will be performed for each combination of values across all options.
Values for Miryoku alternative layout options are selected from a list. As multiple selection is not supported, matrix builds across multiple values are not possible for these options, and the Test Inputs or [[#build-examples][Build Example]] workflows should be used instead.
The ~Keyboard~ option specifies the keyboard and is required. All other options are optional.
@ -416,6 +419,21 @@ make planck/rev6:manna-harbour_miryoku:flash FORCE_LAYOUT=planck_mit # planck re
#+END_SRC
**** split_3x5_2
[[#thumb-combos][Thumb combos]] are enabled automatically for this layout.
@ -521,18 +539,6 @@ make ergotravel:manna-harbour_miryoku:flash
#+END_SRC
**** ferris
[[#thumb-combos][Thumb combos]] are enabled automatically for this keyboard.
To build for this keyboard,
#+BEGIN_SRC sh :tangle no
make ferris/0_2:manna-harbour_miryoku:flash # 0_2
make ferris/sweep:manna-harbour_miryoku:flash # sweep
#+END_SRC
**** for_science
The top row is unused.
@ -724,23 +730,36 @@ make splitkb/kyria:manna-harbour_miryoku:flash MIRYOKU_MAPPING=EXTENDED_THUMBS #
#+END_SRC
**** torn
**** takashicompany/minizone
The bottom row middle two keys are mapped to left and right mouse buttons.
An alternative subset mapping is also provided with the thumb keys shifted one
position in the direction of thumb extension. To select this mapping, append
~MIRYOKU_MAPPING=EXTENDED_THUMBS~ to the ~make~ command line when building.
To build for this keyboard,
#+BEGIN_SRC sh :tangle no
make torn:manna-harbour_miryoku:flash
make takashicompany/minizone:manna-harbour_miryoku:flash # make
make takashicompany/minizone:manna-harbour_miryoku:flash MIRYOKU_MAPPING=EXTENDED_THUMBS # make, extended thumb position
make takashicompany/minizone:manna-harbour_miryoku:flash POINTING_DEVICE_ENABLE=yes POINTING_DEVICE_DRIVER=pimoroni_trackball OLED_ENABLE=no # make, with pimoroni trackball
Combo the primary and secondary thumb keys to emulate the tertiary thumb key. Can be used on keyboards with missing or hard to reach tertiary thumb keys or for compatibility with same. Requires suitable keycaps to enable the thumb to press both keys simultaneously.
** Additional and Experimental Features
*** Bilateral Combinations
@ -748,11 +767,24 @@ Combo the primary and secondary thumb keys to emulate the tertiary thumb key. C
[[https://github.com/qmk/qmk_firmware/blob/master/docs/feature_caps_word.md][Caps Word]] is used in place of ~Caps Lock~. Combine with ~Shift~ for ~Caps Lock~.
Combo the primary and secondary thumb keys to emulate the tertiary thumb key. Can be used on keyboards with missing or hard to reach tertiary thumb keys or for compatibility with same. Requires suitable keycaps to enable the thumb to press both keys simultaneously.
*** 𝑥MK
Use Miryoku QMK with any keyboard with [[https://github.com/manna-harbour/xmk][𝑥MK]].
@ -763,6 +795,7 @@ For [[#workflow-builds][workflow builds]], use the Build Inputs workflow and bui
Also see [[https://github.com/manna-harbour/miryoku_kmonad][Miryoku KMonad]].