# Razer Tilt Mapper

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

## 설치 / 업데이트

```sh
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`를 눌러 위 앱 경로를 입력할 수 있습니다.

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

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

## 자동 실행 끄기 / 다시 켜기

끄기:

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

다시 켜기:

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