🚀 [Mac] KaraBiner 설치 및 설정

🛣️ Mac 커스텀 키맵핑을 하자

Mac에서 커스텀 하게 단축키를 설정할 때 가장 많이 사용하는 프로그램이다.

시작해보자.

📦 설치 & 권한 부여

사이트: https://karabiner-elements.pqrs.org/

Karabiner-Elements

Karabiner 사이트, Download 를 진행한다

 

시스템설정 > 로그인 항목 및 확장 프로그램, 권한 허용 필요

설치하면 어차피 자동으로 권한 허용 안내가 친절하게 나온다. 다 허용해주면 된다.

 

---

⌨️ 키 맵핑

json 파일을 통해 단축키 설정을 다 할 수 있는데,

AI 를 통해 해당 설정 작성해달라고 요청을 하면 된다. (AI 만세 🙌)

파일 위치 경로는 아래와 같다

# ~: 사용자 홈 디렉토리
~/.config/karabiner/assets/complex_modifications

~/.config/karabiner/assets/complex_modifications/my_shortcut, 해당 경로에 설정 json 파일 위치시킨다

Add predefined rule 클릭

json에 등록된 rule 목록이 보인다. 해당 창에서 Enable 해주면 바로 적용

---

 

 

📄 my_shortcut.json

마지막으로 아래 키맵핑 테이블에 대한 json 파일이다.

분류	입력 키	변환 동작	적용 범위	비고
스크린샷	F1	Cmd + Ctrl + Shift + 4	전체	영역 캡처 후 클립보드 저장
스크린샷	F3	Shottr Delayed Capture	전체	Shottr 기능
단어 이동	Ctrl + ←	Option + ←	전체	이전 단어로 이동
단어 선택	Ctrl + Shift + ←	Option + Shift + ←	전체	이전 단어까지 선택
단어 이동	Ctrl + →	Option + →	전체	다음 단어로 이동
단어 선택	Ctrl + Shift + →	Option + Shift + →	전체	다음 단어까지 선택
노션 전용 서식	Ctrl + E	Cmd + E	Notion만	인라인 코드
노션 전용 서식	Ctrl + B	Cmd + B	Notion만	볼드
노션 전용 서식	Ctrl + I	Cmd + I	Notion만	이탤릭
노션 전용 서식	Ctrl + U	Cmd + U	Notion만	밑줄
노션 전용 서식	Ctrl + K	Cmd + K	Notion만	링크 삽입
편집	Ctrl + C	Cmd + C	Terminal, iTerm2 제외	복사
편집	Ctrl + V	Cmd + V	Terminal, iTerm2 제외	붙여넣기
편집	Ctrl + X	Cmd + X	Terminal, iTerm2 제외	잘라내기
편집	Ctrl + Z	Cmd + Z	Terminal, iTerm2 제외	실행 취소
편집	Ctrl + Shift + Z	Cmd + Shift + Z	Terminal, iTerm2 제외	다시 실행
편집	Ctrl + S	Cmd + S	Terminal, iTerm2 제외	저장
편집	Ctrl + A	Cmd + A	Terminal, iTerm2 제외	전체 선택
줄 이동	Home	Cmd + ←	전체	줄 시작으로 이동
줄 이동	End	Cmd + →	전체	줄 끝으로 이동
줄 선택	Shift + Home	Cmd + Shift + ←	전체	줄 시작까지 선택
줄 선택	Shift + End	Cmd + Shift + →	전체	줄 끝까지 선택
문서 이동	Ctrl + Home	Cmd + ↑	전체	문서 맨 위로 이동
문서 이동	Ctrl + End	Cmd + ↓	전체	문서 맨 아래로 이동
찾기	Ctrl + F	Cmd + F	전체	찾기
바꾸기	Ctrl + H	Cmd + Option + F	전체	찾기/바꾸기
검색 이동	Ctrl + G	Cmd + G	전체	다음 찾기 결과
검색 이동	Ctrl + Shift + G	Cmd + Shift + G	전체	이전 찾기 결과

 

{
  "title": "My Shortcut",
  "rules": [
    {
      "description": "F1 → screenshot to clipboard",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "f1"
          },
          "to": [
            {
              "key_code": "4",
              "modifiers": ["left_command", "left_control", "left_shift"]
            }
          ]
        }
      ]
    },
    {
      "description": "F3 → Shottr delayed area capture",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "f3"
          },
          "to": [
            {
              "shell_command": "open 'shottr://grab/delayed=2'"
            }
          ]
        }
      ]
    },
    {
      "description": "F5 → App Expose",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "f5"
          },
          "to": [
            {
              "apple_vendor_keyboard_key_code": "mission_control",
              "modifiers": ["left_control"]
            }
          ]
        }
      ]
    },
    {
      "description": "Ctrl → Option (word navigation fixed)",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "left_arrow",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "left_arrow",
              "modifiers": ["option"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "left_arrow",
            "modifiers": {
              "mandatory": ["control", "shift"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "left_arrow",
              "modifiers": ["option", "shift"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "right_arrow",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "right_arrow",
              "modifiers": ["option"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "right_arrow",
            "modifiers": {
              "mandatory": ["control", "shift"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "right_arrow",
              "modifiers": ["option", "shift"]
            }
          ]
        }
      ]
    },
    {
      "description": "Notion only - Ctrl shortcuts to Command shortcuts",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "e",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "e",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_if",
              "bundle_identifiers": ["^notion\\.id$"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "b",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "b",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_if",
              "bundle_identifiers": ["^notion\\.id$"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "i",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "i",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_if",
              "bundle_identifiers": ["^notion\\.id$"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "u",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "u",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_if",
              "bundle_identifiers": ["^notion\\.id$"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "k",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "k",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_if",
              "bundle_identifiers": ["^notion\\.id$"]
            }
          ]
        }
      ]
    },
    {
      "description": "Ctrl + C/V → Cmd + C/V",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "c",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "c",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "v",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "v",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        }
      ]
    },
    {
      "description": "Ctrl X/Z/S → Cmd equivalents",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "x",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "x", "modifiers": ["command"] }],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "z",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "z", "modifiers": ["command"] }],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "z",
            "modifiers": { "mandatory": ["control", "shift"], "optional": [] }
          },
          "to": [{ "key_code": "z", "modifiers": ["command", "shift"] }],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "s",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "s", "modifiers": ["command"] }],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        }
      ]
    },
    {
      "description": "Ctrl A → Cmd A",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "a",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "a",
              "modifiers": ["command"]
            }
          ],
          "conditions": [
            {
              "type": "frontmost_application_unless",
              "bundle_identifiers": [
                "^com\\.apple\\.Terminal$",
                "^com\\.googlecode\\.iterm2$"
              ]
            }
          ]
        }
      ]
    },
    {
      "description": "Home/End → Cmd + Arrow (Windows style)",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "home",
            "modifiers": {
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "left_arrow",
              "modifiers": ["command"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "end",
            "modifiers": {
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "right_arrow",
              "modifiers": ["command"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "home",
            "modifiers": {
              "mandatory": ["shift"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "left_arrow",
              "modifiers": ["command", "shift"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "end",
            "modifiers": {
              "mandatory": ["shift"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "right_arrow",
              "modifiers": ["command", "shift"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "home",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "up_arrow",
              "modifiers": ["command"]
            }
          ]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "end",
            "modifiers": {
              "mandatory": ["control"],
              "optional": []
            }
          },
          "to": [
            {
              "key_code": "down_arrow",
              "modifiers": ["command"]
            }
          ]
        }
      ]
    },
    {
      "description": "Ctrl Find/Replace → Cmd equivalents",
      "manipulators": [
        {
          "type": "basic",
          "from": {
            "key_code": "f",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "f", "modifiers": ["command"] }]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "h",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "f", "modifiers": ["command", "option"] }]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "g",
            "modifiers": { "mandatory": ["control"], "optional": [] }
          },
          "to": [{ "key_code": "g", "modifiers": ["command"] }]
        },
        {
          "type": "basic",
          "from": {
            "key_code": "g",
            "modifiers": { "mandatory": ["control", "shift"], "optional": [] }
          },
          "to": [{ "key_code": "g", "modifiers": ["command", "shift"] }]
        }
      ]
    }
  ]
}

끝! 🤘