Mouser: MX Master 3S용 Logitech Options+ 오픈소스 대안

Mouser의 기능

Mouser는 Logitech MX Master 3S 마우스의 모든 프로그래밍 가능 버튼을 재매핑하기 위한 Logitech Options+의 경량 오픈소스 대안입니다. 완전히 로컬에서 실행되며 원격 측정 기능, 클라우드 서비스, Logitech 계정이 필요하지 않습니다.

주요 기능

• macOS 지원 — CGEventTap를 사용한 마우스 후킹, Quartz CGEvent를 사용한 키 시뮬레이션, NSWorkspace를 사용한 앱 감지로 완전한 호환성 제공
• 6개의 모든 프로그래밍 가능 버튼 재매핑 — 중간 클릭, 제스처 버튼, 뒤로, 앞으로, 수평 스크롤 좌/우
• 애플리케이션별 프로필 — 앱을 전환할 때 버튼 매핑을 자동으로 전환 (예: Chrome과 VS Code에 대한 다른 바인딩)
• 22개의 내장 작업 — 탐색, 브라우저, 편집, 미디어 카테고리 포함
• DPI/포인터 속도 제어 — 200–8000 DPI의 슬라이더와 빠른 프리셋, HID++를 통해 장치에 동기화
• 스크롤 방향 반전 — 수직 및 수평 스크롤에 대한 독립적인 토글
• 제스처 버튼 지원 — Bluetooth에서 완전한 HID++ 2.0 전환 (Logitech 소프트웨어 필요 없음)
• 배터리 모니터 — 연결 시 HID++를 통해 배터리 수준을 읽고 5분마다 새로 고침; 색상 코드 배지로 표시 (70% 이상 녹색, 20–69% 노란색, 20% 미만 빨간색)
• 자동 재연결 — 마우스가 꺼지거나 켜지거나 연결이 끊어지거나 다시 연결될 때 자동으로 감지
• 실시간 연결 상태 — UI에 실시간 "연결됨" / "연결 안 됨" 배지 표시
• 현대적인 Qt Quick UI — 어두운 Material 테마와 대화형 마우스 다이어그램 및 버튼별 작업 선택기
• 시스템 트레이 — 백그라운드에서 실행, 닫을 때 트레이로 숨김
• 포그라운드 앱 자동 감지 — 활성 창을 폴링하고 프로필을 즉시 전환
• 외부 서비스 없음 — 구성은 로컬 JSON 파일, 모든 처리는 사용자 기기에서 발생

지원 장치

장치: Logitech MX Master 3S
제품 ID: 0xB034
프로토콜: HID++ 4.5 (Bluetooth)
연결: Bluetooth (USB 수신기도 기본 버튼에 작동)

아키텍처는 다른 Logitech HID++ 마우스로 확장 가능하도록 설계되었지만, MX Master 3S만 테스트되었습니다.

기본 매핑

• 뒤로 버튼: Alt + Tab (창 전환)
• 앞으로 버튼: Alt + Tab (창 전환)
• 중간 클릭: 패스스루
• 제스처 버튼: 패스스루
• 수평 스크롤 왼쪽: 브라우저 뒤로
• 수평 스크롤 오른쪽: 브라우저 앞으로

사용 가능한 작업

• 탐색: Alt+Tab, Alt+Shift+Tab, 바탕 화면 표시 (Win+D), 작업 보기 (Win+Tab)
• 브라우저: 뒤로, 앞으로, 탭 닫기 (Ctrl+W), 새 탭 (Ctrl+T)
• 편집: 복사, 붙여넣기, 잘라내기, 실행 취소, 모두 선택, 저장, 찾기
• 미디어: 볼륨 높이기, 볼륨 낮추기, 볼륨 음소거, 재생/일시 정지, 다음 트랙, 이전 트랙
• 기타: 아무 작업 안 함 (패스스루)

다운로드 및 실행

설치가 필요하지 않습니다. 다운로드, 압축 해제, 더블클릭만 하면 됩니다.

1. Mouser.zip (45 MB) 다운로드
2. zip을 원하는 폴더로 압축 해제 (바탕 화면, 문서 등)
3. Mouser.exe 실행

앱이 열리고 즉시 마우스 버튼 재매핑을 시작합니다. 설정 창이 열려 마우스 다이어그램을 표시하고, 시스템 트레이 아이콘이 시계 근처에 나타납니다. 버튼 재매핑은 즉시 활성화됩니다. 창을 닫아도 앱이 종료되지 않습니다 — 트레이에서 계속 실행됩니다. 완전히 종료하려면: 트레이 아이콘 우클릭 → Mouser 종료.

첫 실행 시 참고 사항

• Windows SmartScreen이 처음 실행 시 경고를 표시할 수 있음 → 추가 정보 클릭 → 어쨌든 실행
• Logitech Options+가 실행 중이면 안 됨 (HID++ 액세스와 충돌)
• 구성은 자동으로 %APPDATA%\Mouser에 저장됨

소스에서 설치

필수 조건:

• Windows 10/11 또는 macOS 12+ (Monterey)
• Python 3.10+ (3.14로 테스트됨)
• Bluetooth 또는 USB 수신기를 통해 페어링된 Logitech MX Master 3S