キーマップの編集

Mokulate（ZMK）では、キーマップを変更する方法が大きく分けて 3 種類 あります。
それぞれ使い勝手や必要な作業が異なるため、目的に合わせて選んでください。

方法	再書込み	カスタマイズ性	備考
ZMK Studio	不要	△	最も簡単
Keymap Editor	必要	○	GitHub が必要
ファーム書換	必要	◎	全機能にアクセス可能

ZMK Studio

最も簡単で、初心者におすすめの方法です。

ZMK Studio はブラウザ上で動作する ZMK の公式ツールで、キーボードのレイアウトを見ながら直感的にキーマップを変更できます。

特徴

• ブラウザだけで完結するのでファームウェアの書き換えは不要
• キーをクリックするだけで割り当て変更
• レイアウト表示で編集しやすい

簡易手順

1. ZMK Studio をブラウザで開く
2. Mokulate の右側を USB で接続する
3. 編集したいキーをクリック
4. 割り当てたいキーを選択

ZMK Studio が使える環境であれば、この方法が最も手軽です。

---

Keymap Editor

Keymap Editor は ZMK Config を ブラウザ上で視覚的に編集するツール です。
GitHub Actions と連携し、自動ビルドされたファームウェアが生成されます。

GitHub リポジトリを作る必要がありますが、プログラミングなしで ZMK Studio よりも複雑なカスタマイズができます。

特徴

• 自分の zmk-config-Mokulate レポジトリ が必要
• キー配置やレイヤーを GUI で編集できる
• ZMK Studio より高機能（COMBO、Macroなど）
• GitHub Actions によりファームウェアを自動生成
• プログラミング不要だが、環境整備と GitHub 操作は必要

簡易手順

1. Githubアカウントを作成（既にお持ちの方は不要です）して、ログイン
2. zmk-config-Mokulate をフォーク
3. フォークしたリポジトリの Github Actions を有効化
4. Keymap Editor で編集
5. GitHub Actions によりファームウェアが生成される
6. ファームウェアの書き込み手順 に従い、書き込む

詳細な操作方法は 自分で調べて頑張ってください。

---

ファームウェアを書き換える

ZMK Config リポジトリ内の .keymap / .overlay ファイルを 直接テキスト編集してビルドする方法 です。

特徴

• 最も柔軟で細かいカスタマイズが可能
  • 長押し判定の速さ（例：Z をどれくらい長押しすると Shift になるか）は変えたい
  • Hold-Tap の挙動カスタム（タップ優先／ホールド優先／クイックタップ時間など）
  • 「B と N を20ms以内に同時押ししたら Esc」「Ctrl を押してる時だけ無視」「優先順位は他より高め」みたいな細かい条件つきコンボ

備考

構文や設定など覚えることが多く、高度なカスタマイズ向けです。
詳細は自分で調べてください。