알리발 매크로 키보드에 바이러스 걱정 없이 키 매핑하기

 

알리발 매크로 키보드

 

 

알리에서 저렴한 가격에 구매한 매크로 키보드이다.

(키캡은 아래에 링크)

 

10.6US $ 23% OFF|Mini Programmable Mechanical Keyboard Usb Bluetooth Rgb Gaming Macro Custom Keyboard Hotswap Shortcut Keypad Fo

 

알리에서 판매되고 있는 유사한 매크로 키보드들 대부분

mini-keyboard라는 알리 판매자가 제공하는 앱을 설치해야 키 매핑이 가능하다. 

 

PC에 정확히 알 수 없는 exe 파일을 실행시키고 싶지 않기에 

다른 매핑 툴을 찾아보니,

 

깃허브에 오픈소스로 해당 키보드들을 매핑할 수 있는 툴을 배포하고 있었다.

 

ch57x-keyboard-tool

https://github.com/kriomant/ch57x-keyboard-tool

 

소스를 빌드해야하는줄 알고 빌드를 했는데.. 그냥 빌드해 둔 릴리즈 파일(https://ch57x-keyboard-tool-x86_64-pc-windows-msvc.zip/)을 받아서 압축 풀고 실행하면 되는 거였다.

 

윈도우 이외의 운영체제는 아래 링크 참고

https://github.com/kriomant/ch57x-keyboard-tool/releases

 

윈도우에서는 UsbDk_1.0.22_x64.msi 다운 받아 설치

https://github.com/daynix/UsbDk/releases

설치가 끝나면 재부팅을 해야한다. (런타임 라이브러리에.. 재부팅이라니..)

 

ch57x-keyboard-tool 릴리즈 파일을 압축 풀면

ch57x-keyboard-tool.exe 파일과 example-mapping.yaml 파일 두 개가 존재한다.

 

example-mapping.yaml은 키보드 매핑 정의 문서 파일이다.

해당 파일이 유효한 키보드 세팅인지 확인하려면 cmd(명령 프롬프트)에서

ch57x-keyboard-tool validate < example-mapping.yaml

 

 

ch57x 툴로 매핑파일을 키보드에 적용 시켜보면

ch57x-keyboard-tool upload < example-mapping.yaml

 

위와 같이 에러 없이 완료가 되어야 한다.

 

키보드의 노브를 돌리면 윈도우 화면 아래로 팝업이 떠서 음량이 조절되는 걸 볼 수 있다.

 

아래 명령어를 실행하면 누르는 키보드 하나의 led가 켜진다.

ch57x-keyboard-tool led 1

 

led 2는 led가 오른쪽으로 순차적으로 켜진다.

ch57x-keyboard-tool led 2

 

led 0은 led가 꺼진다.

ch57x-keyboard-tool led 0

 

show-keys 커맨드로 지원하는 키들을 확인할 수 있다.

ch57x-keyboard-tool show-keys

 

아래 example-mapping.yaml 파일을 메모장으로 열어서 원하는 키를 매핑해 줄 수 있다.

멀티미디어 재생 시 왼쪽 키부터 play, next, prev, mute(노브 클릭)

# Normal keyboard orienation is when buttons are on the left
# side and knobs are on the right. However, you may want to use
# the keyboard in another orienation. To avoid remapping button
# positions in your head, just set it here.
# Possible values are:
#   (horizontal)
#   - 'normal': buttons on the left, knobs on the right
#   - 'upsidedown': buttons on the right, knobs on the left
#   (vertical)
#   - 'clockwise': buttons on the top, knobs on the bottom
#   - 'counterclockwise': buttons on the bottom, knobs on the top
orientation: normal

# There are different models of keyboard with different numbers
# of buttons and knobs. Set it here for proper handling.
# Count rows and columns with the keyboard in normal orienation,
# with knobs on the right side.
rows: 3
columns: 4
knobs: 2

# Layers are sets of alternative key mappings.
# The current layer is changed using a button on the side of the keyboard
# and displayed with LEDs on top (only for the moment of changing).
# All keyboards I saw had three layers, but I suppose other variants
# exist.
layers:
  - buttons:
      # Array of buttons. In horizontal orienations it's `rows` rows
      # `columns` buttons each. In vertical: `columns` rows
      # `rows` buttons each.
      # Each entry is either a sequence of 'chords' or a mouse event.
      # A chord is a combination of one key with optional modifiers,
      # like 'b', 'ctrl-alt-a' or 'win-rctrl-backspace'. It can also
      # be just modifiers without a key: 'ctrl-alt'.
      # You may combine up to 5 chords into a sequence using commas: 'ctrl-v,ctrl-c'.
      # Arbitrary scan codes (decimal) may be given like this: '<101>'.
      - ["a", "ctrl-a", "alt-shift", "alt-ctrl,ctrl-b"]
      - ["e", "f", "g", "h"]
      - ["<100>", "j", "k", "l"]
    knobs:
      # Knobs are listed from left to right if horizontal
      # and from top to bottom if vertical.
      # Knobs can be rotated counter-clockwise (ccw) or clockwise (cw)
      # and pressed down.
      - ccw: 'wheelup'
        press: 'click'
        cw: 'wheeldown'
      - ccw: 'shift-wheelup'
        press: 'shift-click'
        cw: 'shift-wheeldown'

  - buttons:
      # Mouse events are clicks ('click/lclick', 'rclick', 'mclick') or
      # wheel events ('wheelup', 'wheeldown') with one optional modifier,
      # only 'ctrl', 'shift' and 'alt' are supported ('ctrl-wheeldown').
      # Clicks may combine several buttons, like this: 'click+rclick'.
      - ["click", "lclick", "rclick", "mclick"]
      - ["click+rclick", "wheeldown", "shift-wheelup", "ctrl-wheelup"]
      - ["alt-wheelup", "ctrl-click", "wheelup", "wheelup"]
    knobs:
      - ccw: 'left'
        press: 'enter'
        cw: 'right'
      - ccw: 'ctrl-left'
        press: 'ctrl-enter'
        cw: 'ctrl-right'

  - buttons:
      # Multimedia commands are also supported. They cannot be mixed with
      # normal keys and modifiers.
      - ["play", "prev", "next", "mute"]
      - ["2", "3", "4", "5"]
      - ["6", "7", "8", "9"]
    knobs:
      - ccw: 'volumedown'
        press: 'mute'
        cw: 'volumeup'
      - ccw: 'd'
        press: 'e'
        cw: 'f'

 

기본 예제 키보드 정의 파일은 4 x 3 버튼에 노브 2개짜리이다.

내 건 3 x 1 노브 1개이므로

아래와 같이 수정

orientation: normal

rows: 1
columns: 3
knobs: 1

layers:
  - buttons:
      # Multimedia commands are also supported. They cannot be mixed with
      # normal keys and modifiers.
      - ["left", "play", "right"]
    knobs:
      - ccw: 'volumedown'
        press: 'mute'
        cw: 'volumeup'

 

knobs는 노브를 의미하며

ccw는 시계 반대 방향으로 돌림

cw는 시계 방향

 

미디에 재생 컨트롤로 사용할 것이기에 5초 뒤로, 재생, 5초 앞으로를 버튼에

볼륨 컨트롤을 노브에 할당해 주었다.

 

프로그래밍 가능한 미니 기계식 매크로 키보드, USB 블루투스, RGB 게이밍, 커스텀 핫스왑 키보드, 포토샵 CAD용 단축키 키패드

https://s.click.aliexpress.com/e/_DEcPEvH

10.6US $ 23% OFF|Mini Programmable Mechanical Keyboard Usb Bluetooth Rgb Gaming Macro Custom Keyboard Hotswap Shortcut Keypad Fo

프로그래밍 매크로 커스텀 블루투스 키보드, RGB 12 키 복사 붙여넣기, 미니 단추 게이밍 키패드, 기계식 핫스왑 매크로패드, 2 노브

https://s.click.aliexpress.com/e/_DdgA2Hd

14.88US $ 66% OFF|Macro Type|mechanical Macro Keyboard 12-key Rgb Bluetooth With Hot-swap Switches

 

Wob Rainy 75 기계식 키보드, 블루투스 무선 키보드, 게이머 CNC 알루미늄 키보드 개스킷, 핫 스왑, RGB 백라이트 선물

https://s.click.aliexpress.com/e/_DkotXGx

145.65US $ 39% OFF|Wob Rainy 75 Mechanical Keyboard Bluetooth Wireless Keyboards Gamer Cnc Aluminum Keyboard Gasket Hot Swap Rgb

 

PBT 체리 프로파일 키캡 화살표 키, 체리 게이트론 MX 스위치 기계식 키보드용 5 면 염료 승화, 4 개

https://s.click.aliexpress.com/e/_DmCF88j

0.98US $ 85% OFF|4pc PBT Cherry Profile Keycaps Arrow Keys 5 Sided Dye Sublimation For Cherry Gateron MX Switches Mechanical Key

 

PBT 염료 서브 키캡 OEM 체리 프로파일 화살표 ECS 키캡, 게이밍 기계식 키보드 체리 Mx 스위치 커스텀 키캡, 5 개

https://s.click.aliexpress.com/e/_DDtwXmR

5.39US $ 30% OFF|Pbt Dye-subbed Keycap Oem Profile Arrow Ecs Key Caps For Gaming Mechanical Keyboard Cherry Mx Switch Custom Key