Files
Razer_Tilt_Mapper/README.md
T
jsahnandClaude Opus 5.5 70a1c17e03 마우스 휠 세로 스크롤 방향 반전 추가
스크롤 이벤트를 가로채 제스처 phase가 없는 휠 이벤트만 세로 방향을 뒤집은
새 이벤트로 바꿔 보낸다. 원래 이벤트의 delta 필드만 수정하면 앱에 반영되지
않아 대체 이벤트 방식을 사용한다. 트랙패드와 가로 스크롤은 그대로 둔다.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 16:52:18 +09:00

2.6 KiB

Razer Tilt Mapper

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

마우스 휠의 세로 스크롤 방향도 반전합니다. 트랙패드와 Magic Mouse처럼 제스처로 스크롤하는 장치와 가로 스크롤은 바꾸지 않습니다.

설치 / 업데이트

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가 종료 및 다시 열기를 요청하면 허용합니다. 자동 실행 서비스가 앱을 다시 실행합니다. 권한이 없는 동안 앱은 약 30초마다 스스로 재시작하며 권한을 다시 확인하므로, 허용한 뒤 직접 재시작할 필요가 없습니다.

install.sh가 끝나면 Finder에서 설치된 앱이 선택된 채로 열리고, 입력 모니터링 설정 화면도 함께 열립니다. 목록에 없으면 Finder에 선택된 Razer Tilt Mapper를 목록으로 끌어다 놓습니다. + 버튼을 쓸 때는 파일 선택 창에서 Command+Shift+G를 누르고 위 앱 경로를 입력합니다. 손쉬운 사용도 같은 방법으로 추가합니다.

install.sh는 설치할 때마다 기존 입력 모니터링·손쉬운 사용 등록을 자동으로 지웁니다. 빌드할 때마다 서명이 바뀌어 이전 허용이 더 이상 적용되지 않기 때문입니다. 설치 후에는 두 권한을 다시 허용합니다.

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

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