문서

설정 윈도우가 어떻게 구성되어 있는지, 그리고 문서 전반에서 쓰는 용어입니다.

시작하기

MouseTuner는 메뉴 막대 앱입니다. Dock 아이콘도 없고 메인 윈도우도 없습니다. 전체 인터페이스는 설정 윈도우 하나뿐이고, 메뉴 막대 아이콘에서 엽니다.

권한

부드러운 스크롤, Button Mapping, Domain Rule(활성 브라우저 탭의 URL 읽기)에는 손쉬운 사용 권한이 필요합니다. 권한이 없으면 해당 패널이 무엇이 빠졌는지 설명하고 시스템 설정으로 연결합니다.

입력 모니터링 권한은 필요하지 않습니다. HID++는 제조사 전용 인터페이스와 Bluetooth GATT를 거치는데, 둘 다 이 권한의 관할이 아닙니다. Bluetooth로 직접 연결한 Logitech 마우스는 Bluetooth 페어링 요청이 한 번 더 뜨고, 승인한 뒤에는 재시동해야 적용됩니다.

설정 패널

Scroll — Scroll Curve 편집기와 실시간 미리보기.
Buttons — Trigger에서 Action으로 이어지는 매핑.
App Overrides — Scroll Curve와 Button Mapping을 함께 재정의하는 앱 목록 하나.
Devices — Recognized Device의 DPI, SmartShift, 배터리, 컨트롤 테이블.
Input Source — 앱이나 브라우저 도메인에 따른 입력 소스 자동 전환.
General — 업데이트, iCloud 동기화, 크래시 리포트(기본으로 꺼져 있습니다).
Permissions — 무엇이 허용되었고 무엇이 빠졌는지, 그리고 그것이 왜 중요한지.

용어

이 용어들은 MouseTuner가 지원하는 모든 언어에서 영어 그대로 유지되며, 이 문서도 예외가 아닙니다.

Trigger: 매핑을 발동시키는 조건입니다. 클릭, 더블 클릭, 길게 누르기, 네 방향 중 하나로 끌기, Chord, Hold + Scroll이 있습니다.
Chord: 두 개의 버튼을 동시에 누르고 있는 상태입니다.
Action: 매핑이 실제로 하는 일입니다. 키보드 단축키, 시스템 동작, 미디어 키, 앱이나 URL 열기, AppleScript, 셸 명령, Modifier Hold 중 하나입니다.
Modifier Hold: 버튼을 누를 때 수식어 키를 누르고 뗄 때 놓는 Action입니다. 눌러서 말하는 방식의 받아쓰기를 위해 존재합니다.
Trajectory Gesture: 버튼을 누른 채 방향을 순서대로 그려서 동작을 발동시킵니다. 계획 단계이며 아직 구현되지 않았습니다.
App Override: 특정 앱이 앞에 있는 동안 전역 설정을 대신하는 Scroll Curve 또는 Button Mapping입니다.
Scroll Curve: 부드러운 스크롤을 결정하는 매개변수 묶음입니다. 최소 단계, 속도 게인, 지속 시간, 감쇠로 이루어집니다.
SmartShift: 래칫 휠과 자유 회전 휠을 자동으로 전환하는 Logitech의 기능이며, HID++로 제어합니다.
Device Profile: 인식된 모델이 무엇을 할 수 있는지를 담은 정보입니다. 버튼 구성, DPI 범위, SmartShift 지원 여부, 배터리를 읽는 방법이 들어 있습니다.
Recognized Device: Device Profile이 있는 마우스입니다. 이 경우 추가 하드웨어 제어 기능이 열립니다.
Generic Device: 그 밖의 모든 마우스이며, Universal HID Layer를 통해 처리합니다. 부드러운 스크롤과 기본적인 Button Mapping은 그대로 동작합니다.
HID++: Logitech의 독자 기기 프로토콜입니다. DPI, SmartShift, 배터리 정보가 모두 이 경로를 지나갑니다.
License Key: 구매 후 받는 문자열입니다. 구매 한 건당 하나가 발급됩니다.
Seat: 하나의 License Key를 묶어 둘 수 있는 기기입니다. 키 하나에 3대까지입니다.
Credential: 활성화 시점에 발급되어 해당 기기에 묶입니다. 한 번 구매하면 끝나는 방식이므로 만료일이 없습니다.
Machine Fingerprint: 잘 바뀌지 않는 로컬 식별자의 해시입니다. 그 원본 값은 사용자의 Mac을 벗어나지 않습니다.
Trial: 계정도 결제 수단도 없이 30일 동안 앱의 모든 기능을 쓸 수 있는 기간입니다.
Grace: Credential 확인이 실패해도 앱이 계속 동작하는 기간입니다. 14일입니다.
Revocation: 환불이나 지급 거절 이후 키를 무효로 표시하는 것입니다. 앱은 다음 일일 확인 시점에 기능을 낮춥니다.
Blind Test: 릴리스 전 관문입니다. 5~10명이 어느 빌드인지 모르는 상태에서 스크롤 감각을 비교합니다.
Command: macOS의 Command 키입니다. 키 이름은 매핑과 단축키 전반에서 영어 그대로 유지합니다.
Option: macOS의 Option 키이며, 위와 같은 규칙을 따릅니다.