Miryoku ZMK

• Contents
• Miryoku Keymap
• Configuration Options
• Config File
• Example Config File
• Mapping
  • Layouts
    • 34-ferris
      • Combo TPS
    • 36-minidox
    • 42-corne
    • 44-jian
    • 48-planck
      • Default
      • Extended Thumbs
    • 50-kyria
      • Default
      • Extend Thumbs
    • 56-iris
    • 58-lily58
    • 60-sofle
    • 62-atreus62
    • 64-helix
• Keyboard Keymaps
• Prebuilt Firmware
• Contact

Miryoku is an ergonomic, minimal, orthogonal, and universal keyboard layout. This is the miryoku implementation for ZMK.

Contents   TOC_1

• Miryoku Keymap
• Configuration Options
• Config File
• Example Config File
• Mapping
• Keyboard Keymaps
• Prebuilt Firmware
• Contact

Miryoku Keymap

The miryoku keymap is a ZMK DT keymap file using C preprocessor macros for configuration options and to abstract the physical layout. The file is miryoku/miryoku.dtsi. The file is included into the keyboard's keymap with

#include "../miryoku/miryoku.dtsi"

Configuration Options

Keymap configuration options and mapping configuration options are given in the documentation in the form option=value. To use configuration options in Miryoku ZMK, convert to the form #define option_value. To apply the configuration options to all builds add them to the config file. To apply configuration options to a single keyboard, add them to the keyboard keymap file before any #include lines.

Config File

The config file can be used to provide configuration options for all keyboard builds. The file is miryoku/config.h. See the example config file.

Example Config File

Below is an example config file with the following keymap configuration options:

• MIRYOKU_ALPHAS=QWERTY
• MIRYOKU_NAV=VI
• MIRYOKU_CLIPBOARD=WIN

// https://github.com/manna-harbour/miryoku-zmk/

#define MIRYOKU_ALPHAS_QWERTY
#define MIRYOKU_NAV_VI
#define MIRYOKU_CLIPBOARD_WIN

Mapping

The keymap is mapped onto keyboards with different physical layouts. The keymap is specified in terms of the MIRYOKU_MAPPING macro. The macro is defined in a C header file for each physical layout. Unused keys are mapped to &none. The files are in miryoku/mapping/. The mapping file is included into the keyboard's keymap file before the miryoku keymap with e.g.

#include "../miryoku/mapping/36-minidox.h"

On each hand, only the main alpha block of 3 rows by 5 columns and the 3 most appropriate thumb keys are used. Notes or diagrams are included where the selection of keys is not obvious or where alternatives are provided via mapping configuration options.

Layouts

34-ferris

Combo TPS

MIRYOKU_COMBO_TPS=ENABLE

Combos of primary and secondary thumb keys emulate the missing tertiary thumb key. This configuration option is enabled automatically for this mapping and can be enabled on other mappings for compatibility

36-minidox

42-corne

44-jian

48-planck

Default

Extended Thumbs

MIRYOKU_MAPPING=EXTENDED_THUMBS

50-kyria

Default

Extend Thumbs

MIRYOKU_MAPPING=EXTENDED_THUMBS

56-iris

58-lily58

60-sofle

62-atreus62

64-helix

Keyboard Keymaps

Keymap files for many keyboards included in ZMK are provided in config/.

Prebuilt Firmware

Prebuilt firmware can be downloaded from the repo. Log in to GitHub, visit the Actions tab, select the appropriate workflow, select the latest successful workflow run, select the desired artifact, and unzip the downloaded zip file.

Contact

For issues with the code, including requests for any of the following, please create an issue. Pull requests are also welcome.

• Additional mapping and keyboard keymap files
• Additional mapping configuration options (see miryoku QMK for examples)
• Populating unused keys in MIRYOKU_MAPPING_TAP (currently skipped for some mapping files)