A minimal, ergonomic, and hardware-agnostic 31-key layered keyboard layout.
Kenkyo (謙虚) is the Japanese term for humility or modesty. True to its name, Kenkyo stays completely out of your way: your standard keyboard layout remains fully functional while providing access to 100% of standard keyboard capabilities using only 31 keys.
- Key Benefits
- Repository Structure
- Getting Started & Installation
- Layout Overview & Learning Path
- Design Philosophy
- Contributing
- License
- ⌨️ Hardware Agnostic: Runs purely in software via Kanata, Keyd, or Keydo. Works on standard laptop keyboards and full-size layouts.
- 🎯 Minimalist: Requires only 31 keys to access 100% of full-sized keyboard functionality.
- 🖐️ Ergonomic: Eliminates wrist reaching and finger stretching by keeping navigation, symbols, and modifiers directly under your home row.
- 🪜 Progressive Learning: Adopt features gradually at your own pace without disrupting your existing typing habits.
.
├── kanata/
│ └── kanata.kbd # Configuration file for Kanata (Windows, macOS, Linux)
├── keyd/
│ └── default.conf # Configuration file for Keyd (Linux)
├── images/ # Visual layer maps and graphic assets
├── LICENSE # MIT License
└── README.md
Choose your preferred keyboard remapping engine below to install and load Kenkyo.
| Engine | Platform Support | Config File | Project Repository |
|---|---|---|---|
| Kanata | Windows, macOS, Linux | kanata/kanata.kbd |
jtroo/kanata |
| Keyd | Linux | keyd/default.conf |
rvaiya/keyd |
| Keydo | Windows, macOS, Linux | keyd/default.conf |
argenkiwi/keydo |
- Install Kanata for your operating system.
- Run Kanata pointing to the configuration file in this repository:
kanata -c kanata/kanata.kbd
- Install Keyd.
- Copy the configuration file to
/etc/keyd/default.conf:sudo cp keyd/default.conf /etc/keyd/default.conf sudo keyd reload
Follow installation instructions on the Keydo repository and load the Kenkyo configuration.
Kenkyo uses a layered approach where the Main layer handles standard typing, and additional layers are activated via modifiers or specific key combinations. The layout is designed to be learned step-by-step in the following sequence:
Start with the essentials. These chords are available on most layers for quick access to keys that are otherwise far from your home row:
W+E→ EscI+O→ BackspaceX+C→ Tab,+.→ Enter
Hold Space to enter the Extend layer, placing navigation and editing tools directly under your fingers.
- Navigation: Arrow keys, Home/End, Page Up/Page Down.
- Editing: Backspace, Delete, Enter, Tab.
- Media: Volume controls and Play/Pause on the left hand.
Hold keys on the home row or bottom row to activate standard system modifiers:
- Home Row (Left Hand):
A(Meta/Super),S(Alt),D(Shift),F(Ctrl) - Home Row (Right Hand):
J(Ctrl),K(Shift),L(Alt),;(Meta/Super) - Bottom Row (Left Hand):
Z(Ctrl),X(AltGr / Right Alt) - Bottom Row (Right Hand):
.(AltGr / Right Alt),/(Ctrl)
Access numbers, function keys, and math symbols via the Fumbol layer:
- Activation: Hold
V(left) orM(right).
- Numbers: Distributed along the home row.
- Function Keys:
F1–F10on the top row,F11–F12on the bottom row. - Math Chords: Quick access to
-,+,=,/,*via home row combinations.
While hold-based modifiers and layers are great for navigation or standard shortcuts, typing at high speed benefits from momentary, low-latency modifier mechanics. Kenkyo provides a rich suite of one-shot modifier options:
Tap a modifier key together with Space to trigger a one-shot modifier for just the next keypress:
D+Space(orK+Space) → One-shot ShiftX+Space(or.+Space) → One-shot AltGrV+Space(orM+Space) → One-shot Fumbol
Extend one-shot behavior by anchoring with Space: tap a modifier key together with Space, then keep holding Space after releasing the modifier key to keep that modifier active for multiple keypresses without needing to hold down the modifier key itself (e.g., typing an acronym in all capitals).
Combine multiple modifier keys in a single chord together with Space for one-shot access to several modifiers at once:
- Left Hand:
X+D(AltGr + Shift),X+V(AltGr + Fumbol),D+V(Shift + Fumbol),X+D+V(all three) - Right Hand:
K+.(AltGr + Shift),M+.(AltGr + Fumbol),M+K(Shift + Fumbol),M+K+.(all three)
Kenkyo is built on four core principles:
- Seamlessness: The layout is invisible until you choose to use its features.
- Progressiveness: Adopt patterns at your own pace without breaking your existing workflow.
- Composability: Integrates standard ergonomic concepts such as Home Row Modifiers and SpaceFN.
- Efficiency: Strikes a balance between minimal hand motion and ease of learning.
Note
This layout assumes a physical QWERTY keyboard layout but is independent of your operating system's software language settings.
Contributions, issues, and feature requests are welcome! Feel free to check the issues or submit a pull request if you have ideas for layout enhancements or support for additional remapping software.
Distributed under the MIT License. See LICENSE for more details.




