dakenの使い方 ― キーマップ読み込みからタイピング練習まで

ZMK の .keymap（DTS）または QMK の keymap.json をブラウザで開き、レイヤー切替やローマ字を意識的に練習するまでの 5 ステップを順に説明します。

ステップ1: キーマップファイルを用意する

自作キーボードのファームウェアリポジトリ（zmk-config / qmk_firmware）から、現在使っている設定ファイルを手元にダウンロードしてください。

  • ZMK: config/<board>.keymap（拡張子 .keymap、内容は DTS 構文）
  • QMK: keyboards/<board>/keymaps/<you>/keymap.json

ファイル形式の詳細は 対応キーボード・キーマップ形式 を参照してください。

ステップ2: キーマップを読み込む

トップページの「キーマップを読み込む（.keymap / .json）」ボタンを押し、ステップ1で用意したファイルを選びます。読み込みに成功すると、レイヤータブとキー一覧が画面に表示されます。

読み込んだファイルはブラウザの LocalStorage に保存され、次回アクセス時に自動で復元されます。サーバには一切送信されません。

ステップ3: 物理レイアウトを選ぶ

分割キーボードの物理配置を指定すると、キーマップが実物に近い見た目で表示されます。指定方法は2通りです:

  • プリセット: 既知のキーボード（例: Pyuron）はファイル名から自動判定。何もしなくて OK
  • JSON アップロード: ZMK / QMK の layout JSON を読み込めば任意のキーボードに対応

未指定の場合は grid 表示にフォールバックします（練習自体は問題なく行えます）。

ステップ4: 練習モードを選ぶ

用途に応じて 2 種類の練習が選べます:

  • 寿司打ライク: 制限時間内に日本語ローマ字 / 英文 / コードのお題を連続で打鍵します。日本語はヘボン式・訓令式どちらでも正答として扱われます（例: chi でも ti でも OK）
  • レイヤー切替練習: 「Layer 2 の % を打って」と出題されます。 mo キーや ホームロウモッド を体に覚え込ませるのに最適です

ステップ5: 結果を確認する

セッション終了後、解答数 / 合計 WPM / 平均正答率に加えて、押し間違えたキーの上位5件 が表示されます。苦手なキーを把握し、次の練習に活かしてください。