【徹底解説】Karabiner-ElementsでERGO M575Sを制御してみた

こんにちは、ハル( @hal_virgiL)です。

新しく購入したトラックボールマウスLogicool ERGO M575SをKarabiner-Elementsで制御できたので、その方法の備忘録です。

本来M575SはLogicoolの公式サイトから「Logicool Options」というアプリをダウンロードすることで各種ボタンの設定ができるようになるんですけども。

ひねくれ者の僕はPCに新しいアプリを入れたくなかったので。
普段から愛用しているKarabiner-Elementsを使ってM575Sのボタンを設定することにしました。

Karabiner-Elementsとは

Macに接続したデバイス(マウスやキーボードなど)の各ボタンに、特定のキーを割り当てることができるツールになります。

僕の人生の効率化を加速させた最強アプリのひとつです。

必要な方はKarabiner-Elementsの公式サイトから最新版をダウンロードしましょう。

Karabiner-ElementsでLogicool ERGO M575Sを動かす方法

Karabiner-Elementsで任意のデバイスを動かすときには

という5つの手順が必要になります。

1. 設定用ファイルを作成する

まずは、下記のコードをコピーしてテキストエディタに貼り付けてください。
これがKarabiner用の設定テンプレートになります。

{
    "title":"【1】Karabinerで表示されるフォルダ名",
    "rules":[
        {
            "description":"【2】Karabinerで表示される設定名",
            "manipulators":[

{
                    "conditions":[{"type":"device_if","identifiers":[{"product_id":【3】デバイスのproduct ID,"vendor_id":【4】デバイスのvendor ID}]}],
                    "type":"basic",
                    "from":{"【5】マウスかキーボードかの指定":"【6】もとは何のボタンかを指定"},
                    "to":{"key_code":"【7】何のボタンとして操作したいかを指定","modifiers":[“【8】ShiftやCommand、Optionの同時押しはココで指定"]}
                },
{
                    "conditions":[{"type":"device_if","identifiers":[{"product_id":【3】デバイスのproduct ID,"vendor_id":【4】デバイスのvendor ID}]}],
                    "type":"basic",
                    "from":{“【5】マウスかキーボードかの指定":"【6】もとは何のボタンかを指定"},
                    "to":{"key_code":"【7】何のボタンとして操作したいかを指定"}
                }

            ]
        }
    ]
}

// High Tone
// https://highxtone.com

一見難しそうなんですけど、全然簡単です。
わかりやすいように色をつけて分解してみると、こんな感じの構造になっています。

まずは【1】と【2】に好きな名前を入力してみましょう。

テキストファイル自体の名前は半角英数で保存します。
また、作ったテキストファイルの拡張子は「.json」に変更しておきましょう。

2.デバイスのproduct_idとvendor_idを探す

テキストファイルが作成できたら、次に【3】と【4】の項目を埋めるためにデバイスのproduct_idとvendor_idを特定します。

デバイスの各IDの特定にはKarabiner-EventViewerを使用しましょう。

Karabiner-EventViewerの「Devices」のタブを開くと、現在Macに接続されているデバイスの一覧が表示されます。

"manufacturer(メーカー)"や"product(製品名)"の項目から、M575Sを特定してみましょう。

今回は、Logicoolの本社のメーカー名「Logitech」と表記されている部分を探します。

Logitechの塊をよく読んでみると、Logicool ERGO M575Sの場合は

• 【3】"product_id": 45095
• 【4】"vendor_id": 1133

であることが分かりました。

3.指定したいデバイスの種類とキーを特定する

デバイスのproduct_idとvendor_idが分かったら、今度はデバイスのボタンの名前を特定します。

M575Sには、右クリックボタン・左クリックボタンの他に

上記の3つのボタンがついています。

この各ボタンの名前を特定していきます。

この作業もKarabiner-EventViewerで行うことができます。

EventViewerの「Main」タブを開いた状態でデバイスのボタンを押すと、画面の中に
【5】デバイスの種類と【6】もとのボタンの名前が表示されます。

【5】デバイスの種類について

【5】に入力するデバイスの種類について。
Nameの欄の左側に表示されます。

今回はマウスに関する設定なのでpointing_buttonになります。

ボタンの名前について

【6】に入力するボタンの名前です。
Nameの欄の右側に表示されます。

M575Sの場合は、

であることがわかりました。

[quads id=1]

4.割り当てたいキーを設定する

【7】【8】の設定です。

例えば――

Wを割り当てたい場合。

"to":{"key_code":"W"}

⌘Command+Vを割り当てたい場合。

"to":{"key_code":"v","modifiers":["left_command"]}

⌘Command+⇧shift+⌥Option+Pを割り当てたい場合。

"to":{"key_code":"p","modifiers":["left_command","left_shift","left_option"]}

最終的なコード

最終的に僕が書いたコードがこちら。

上ボタンにはブラウザの進む、下ボタンはブラウザの戻る、ホイールボタンにはタブを閉じるショートカットを登録しました。

捗る…！！

M575Sで同じ設定で使用したい方は、このコードをそのままコピーして使用していただけます。

5. 作った設定ファイルをkarabiner-Elementsに反映させる

Karabiner-ElementsのMiscタブを開いて、右下のExport & Importの項目にある「Open config folder (~/.config/karabiner)」のボタンをクリックします。

開いたフォルダからassets＞complex_modificationsの順に進み、中に作成した.jsonファイルを移動させます。

指定のフォルダに.jsonファイルを移したらKarabiner-Elementsの「Complex modifications」のタブを開き、左下にあるAdd ruleのボタンをクリックします。

【1】【2】で設定した名前を見つけて、Enableをクリック。

これで設定通りに機能すれば成功です。