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

 

알리발 매크로 키보드

 

 

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

(키캡은 아래에 링크)

 

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초 앞으로를 버튼에

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

 

천원마트 링크: https://s.click.aliexpress.com/e/_okU0MGH

꽁돈 대첩 링크: https://s.click.aliexpress.com/e/_opeG82p

위클리특가: https://s.click.aliexpress.com/e/_olBNHhT

 

프로그래밍 가능한 미니 기계식 매크로 키보드, 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