Karabiner Element Config(中文)

之前，一直在用 Keyboard Maestro，好用强大，甚至可以直接 map copy 在 clipboard 上面，trigger 的话，只需要再 map 成不同的 key，而不用再开一个专门记录 copy 的工具，甚至可以 ignore applications，例如，某 keybinding 只在某个 app 里面使用时有效。还可以 input 一个 preference file，以便后续使用。此工具可以说是面面俱到，功能强大。然而，it comes with a price, annually, not a fan. ¯_(ツ)_/¯

我在之前的 blog 里面有提到 Karabiner，此神器是位日本大神 Takayama Fumihiko 开源的 project:pray:，2016 年因为 macOS Sierra 的升级，internal keybindings TN2450 有改，导致当时非常好用的 Karabiner 不再兼容。

后来，大神根据 Sierra 的情况，再次开发了 Karabiner Element，并开源。相比于自带 GUI 的 Keyboard Maestro 来说，虽然 Karabiner Element 需要更加繁琐的配置，但是其性价比则令对手毫无招架之力。所以，不夸张得说，Karabiner Element 可以说是市面上能找到的最好的免费快捷键工具，没有之一 。

此 Post 的目的是一个 walk through，用 Karabiner Element 实现 Keyboard Maestro 的所有功能：

需求类目 A：

1. Modifier Flags + key to key

   Use Case: control + h/j/k/l: left/up/down/right arrow.

   Objective: Vi mode-ish navigation.

2. Modifier Flags + key to Modifier Flags + keys

   Use Case: control + command + h/j/k/l: command + left/up/down/right arrow

   Objective 1: Navigating through beginning and end of a line.

   Objective 2: Navigating top to bottom of a doc.

3. Modifier Flags + Modifier Flags + key to Modifier Flags + Modifier Flags + keys

   Use Case: control + command + shift + h/j/k/l: command + shift + left/up/down/right arrow

   Objective 1: Hightlighting through beginning and end of a line.

   Objective 2: Navigating top to bottom of a doc.

需求类目 B：

1. Modifier Flags + key to System key

   Use Case: command + shift + v: clipboard

   Objective: Tool like Flycut

   Use Case: command + shift + f: fullscreen

   Objecrive: Make current app fullscreen with Menu Bar.

需求类目 C:

1. Modifier Flags + key to Linxu styled micro

   Use Case: ctrl + w: delete back to the last whitespace AKA option + delete in MacOS

   Objective: Achive Linux styled micro in Karabiner Element

   Walkaround: I could get this working by creating a .baschrc.

---

好，需求明确了，行动ing。

Karabiner Element 有个 GUI 界面(如下图)，在 Complex Modifications 里面可以 import 现有的 rules .

如此看来，A1 实现起来就 piece of cake 了。那么问题来了，对于在下这种非一般的玩家来说，A2 和 A3 该如何实现呢？:thinking:

先打开已经配置了 A1 的 .json 看看：

{
  "title": "Vi Style Arrows",
  "rules": [
      {
          "description": "Change Control + h/j/k/l to Arrows",
          "manipulators": [
              {
                  "type": "basic",
                  "from": <%= from("h", ['control'], ['caps_lock']) %>,
                  "to": <%= to([["left_arrow"]]) %>
              },
              {
                  "type": "basic",
                  "from": <%= from("j", ['control'], ['caps_lock']) %>,
                  "to": <%= to([["down_arrow"]]) %>
              },
              {
                  "type": "basic",
                  "from": <%= from("k", ['control'], ['caps_lock']) %>,
                  "to": <%= to([["up_arrow"]]) %>
              },
              {
                  "type": "basic",
                  "from": <%= from("l", ['control'], ['caps_lock']) %>,
                  "to": <%= to([["right_arrow"]]) %>
              }
          ]
      }
}

一目了然，加入对应的 keycode 就好，开始ing:

<%# -------------------------------------------------- %>
<%# Change Control + Option + h/l to Option + Left/Right Arrows %>
<%# -------------------------------------------------- %>
{
    "type": "basic",
    "from": < %= from("h", ['control'], ['option']) % > ,
    "to": < %= to([
        [
            ['option'], "left_arrow"
        ]
    ]) % >
},
{
    "type": "basic",
    "from": < %= from("l", ['control'], ['option']) % > ,
    "to": < %= to([
        [
            ['option'], "right_arrow"
        ]
    ]) % >
},

<%# -------------------------------------------------- %>
<%# Change Control + Cammand + Shift + h/l to Command + Shift + Left/Right Arrows %>
<%# -------------------------------------------------- %>
{
    "type": "basic",
    "from": < %= from("h", ['control'], ['shift'], ['command']) % > ,
    "to": < %= to([
        [
            ['option'], ['shift'], "left_arrow"
        ]
    ]) % >
},
{
    "type": "basic",
    "from": < %= from("l", ['control'], ['shfit'], ['command']) % > ,
    "to": < %= to([
        [
            ['option'], [''], "right_arrow"
        ]
    ]) % >
}

上面的 Cope Snippet 理论上应工作， 然而， 不工作。:sweat:，好吧，大概是 syntax 的问题，得重新去翻翻看 doc . Regarding the doc，A2 里面在左右两边都需要 Modifier Flags 的情况并没有被列出来，难道不兼容吗？ :thinking: 这就尴尬了， 我果断决定换下思维模式。

我感觉两边都需要 Modifiers Flags 的需求不应该小众到没有，所以，再去看看别人的配置吧，果然有所发现：

"manipulators": [
    {
        "from": {
            "key_code": "h",
            "modifiers": {
                "mandatory": [
                    "control"
                ],
                "optional": [
                    "caps_lock",
                    "command",
                    "option",
                    "shift",
                    "fn"
                ]
            }
        },
        "to": [
            {
                "key_code": "left_arrow"
            }
        ],
        "type": "basic"
    }
]

上面的 snippet 就是 A2 和 A3 的实现方式。import 之后，和预期一模一样，完美。

现在来实现，B1, 行动ing. 然而， B1 貌似不是很容易实现，需要再进一步的调研，所以果断决定暂时 postpone B。

先来实现 C1，下面是我大概要实现的内容：

{
  "type": "basic",
  "from": {
    "key_code": "w",
    "modifiers": {
      "mandatory": ["control"],
      "optional": ["caps_lock", "option"]
    }
  },
  "to": [
    {
      "key_code": "delete_or_backspace"
    }
  ]
}

实现完成，完美。