対応している分割キーボード・キーマップ形式
daken は ZMK と QMK の主要なキーマップ形式を、ブラウザ上で取り込んで可視化・練習できるようにしています。本ページでは対応している形式と、自分のキーボードでの使い方を解説します。
ZMK と QMK の違い(簡略表)
| 項目 | ZMK | QMK |
|---|---|---|
| 主な対象 | 無線(nRF52 系)中心 | 有線中心(一部無線対応) |
| キーマップ記法 | DTS(Devicetree) | C ヘッダー / JSON |
| 設定ファイル | .keymap | keymap.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_transformJSON や QMK のinfo.jsonから抽出した layout JSON を読み込むと、任意のキーボードに対応できます
キーマップを取り出す方法
- ZMK: GitHub の
zmk-config-<your-name>リポジトリのconfig/配下から.keymapをダウンロード - QMK: QMK Configurator の Export ボタンで
keymap.jsonを取得、またはqmk_firmware/keyboards/配下の自分のkeymap.jsonを直接利用