Karabiner-ElementsはMacのキーカスタマイズを行うソフトです。キーボードだけでなくマウスのボタンなどに対しても設定が可能です。

具体的な設定方法等はこちらや公式ドキュメントで確認できます。

基本的なキーマッピングであれば、GUIからの設定が可能ですが、細かい設定を行いたい場合はJson形式のファイルに記述していく必要があります。デフォルトでは、~/.config/karabiner/karabiner.jsonの設定ファイルを読み込んでいるようで、このファイルを修正するとすぐに設定が反映されます。

実際に設定ファイルをいじってみるとわかるのですが、同一の条件でキー設定をいくつかしたい場合も、１つのキー設定に対して、毎回同じ条件を記入しないといけなかったり、かなり冗長な記述になりとても読み書きしにくいという問題があります。

設定ファイルをもっと簡単に作成するためのツールはいくつかありますが、今回はGokuRakuJoudoというツールを使ってKarabiner-Elementsの設定ファイルを作る方法について書いてみます。

GokuRakuJoudoは、.edn形式のキーカスタマイズ設定ファイルをKarabiner.jsonファイルに適用してくれるコマンドラインツールです。Karabiner.jsonから.edn形式に変換できたらもっと良かったのですが、その機能はなさそうです。

GokuRakuJoudoをインストールしたら、以下の手順でKarabinerにキーカスタマイズを設定することができます。

Karabinerアプリの設定ウィンドウでprofileを作成し、そのprofileを利用する設定にする（Default Profileが選択されていると思うので、作成したprofileを選択する）
~/.config/karabiner.ednファイルを作成する
gokuコマンドでkarabiner.ednファイルの内容をKarabiner.jsonに適用する

基本的な記述ルールについては、公式のここやここをみるとだいたいわかります。カンマ(,)は空白扱いとみなされるようです。また、注意点として、複数の矛盾したルールが当てはまる場合は、先に書いてあるルールが適用されるようです。

必要な項目としては、手順1で作成したprofile名を記述しておく必要があります。具体的には以下のような感じです。

Category