対応している分割キーボード・キーマップ形式

daken は ZMK と QMK の主要なキーマップ形式を、ブラウザ上で取り込んで可視化・練習できるようにしています。本ページでは対応している形式と、自分のキーボードでの使い方を解説します。

ZMK と QMK の違い(簡略表)

項目ZMKQMK
主な対象無線(nRF52 系)中心有線中心(一部無線対応)
キーマップ記法DTS(Devicetree)C ヘッダー / JSON
設定ファイル.keymapkeymap.c / keymap.json
レイヤー
コンボ○(標準)○(要 define)

ZMK .keymap の取り込み

ZMK の .keymap ファイルは DTS(Devicetree Source)形式で書かれています。daken は内部で軽量な DTS パーサを使って keymap ノードと layers を読み取り、レイヤー単位の bindings を内部スキーマに変換します。

典型的なファイルパス:

config/<board>.keymap   # 例: config/corne.keymap

ファイル名から既知のプリセット(例: pyuron.keymap → Pyuron レイアウト)を自動判別します。判別できない場合は grid 表示にフォールバックします。

QMK keymap.json の取り込み

QMK Configurator や qmk json2c で出力した keymap.json をそのまま読み込めます。daken は layers 配列のキーコードを内部スキーマに正規化し、ZMK と同じ表示・練習ロジックで扱います。

keyboards/<board>/keymaps/<you>/keymap.json

物理レイアウトのプリセットと JSON

実物に近い表示にするための物理レイアウト(キー位置の座標)を、以下のいずれかで指定します:

  • プリセット: 現在は Pyuron(MeowCatpawkittie 製、40 キー分割)に対応。他のキーボードは順次拡充予定
  • JSON アップロード: ZMK の matrix_transform JSON や QMK の info.json から抽出した layout JSON を読み込むと、任意のキーボードに対応できます

キーマップを取り出す方法

  • ZMK: GitHub の zmk-config-<your-name> リポジトリの config/ 配下から .keymap をダウンロード
  • QMK: QMK Configurator の Export ボタンで keymap.json を取得、または qmk_firmware/keyboards/ 配下の自分の keymap.json を直接利用