Razer Tilt Mapper

Razer Pro Click V2 (vendor 5426, product 209)의 휠 좌우 틸트를 각각 Command+[ / Command+]로 보냅니다. 제공한 HID 보고서의 첫 바이트와 비트 마스크를 그대로 사용합니다.

설치 / 업데이트

cd /Users/jsahn/Personal_works/Razer_Tilt_Mapper
zsh build.sh
zsh install.sh

설치된 앱: ~/Library/Application Support/RazerTilt/Razer Tilt Mapper.app

자동 실행 설정: ~/Library/LaunchAgents/local.razer-tilt.plist

Mac에 로그인할 때 실행되며, 종료되면 launchd가 다시 실행합니다. 마우스를 나중에 연결해도 감지합니다. /tmp나 Swift 인터프리터에 의존하지 않습니다.

최초 권한 설정

시스템 설정 → 개인정보 보호 및 보안에서 Razer Tilt Mapper의 입력 모니터링, 손쉬운 사용을 허용합니다. macOS가 종료 및 다시 열기를 요청하면 허용합니다. 자동 실행 서비스가 앱을 다시 실행합니다.

목록에 없으면 + 버튼으로 설치된 앱을 추가합니다. 파일 선택 창에서 Command+Shift+G를 눌러 위 앱 경로를 입력할 수 있습니다.

권한 상태와 장치 감지는 아래 로그에서 확인합니다. 실제 동작은 브라우저에서 페이지를 이동한 다음 휠 좌우 틸트로 확인합니다.

tail -n 30 ~/Library/Logs/RazerTiltMapper.log
launchctl print gui/$(id -u)/local.razer-tilt

자동 실행 끄기 / 다시 켜기

끄기:

launchctl disable gui/$(id -u)/local.razer-tilt
launchctl bootout gui/$(id -u)/local.razer-tilt

다시 켜기:

launchctl enable gui/$(id -u)/local.razer-tilt
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/local.razer-tilt.plist