README.ko.md

Warning

OpenLogi는 활발히 개발 중이며 아직 안정 단계가 아닙니다 — 기능과 설정이 변경될 수 있습니다. 저장소에 Star ⭐ 와 Watch 👀 를 눌러 두면 릴리스가 나오는 즉시 알림을 받을 수 있습니다.

English | 简体中文 | 日本語 | Deutsch | Français | 한국어

OpenLogi

⚡️ Rust로 작성된 네이티브 로컬 우선 Logitech Options+ 대안 🦀
HID++로 버튼·DPI·SmartShift를 리매핑하세요. 계정도, 텔레메트리도 없습니다.

Options+가 지긋지긋하다면? OpenLogi를 써 보세요.

Logitech 계정도, 텔레메트리도, 공식 Options+ 설치도 없이 버튼을 리매핑하고 DPI와 SmartShift를 제어하며 앱별 프로필을 전환할 수 있습니다. 클라우드 없이 순수 TOML 설정 파일만 사용합니다. 네트워크 요청은 기기 이미지 다운로드와 기본 비활성화된 옵트인 업데이트 확인뿐입니다.

---

소개

OpenLogi는 Logi Bolt 수신기 — 또는 Bluetooth 직접 연결 / 유선 연결 — 을 통해 Logitech HID++ 마우스와 통신하며, Logi Options+를 실행할 필요가 없습니다. 두 개의 실행 파일을 제공합니다:

• OpenLogi GUI — GPUI 데스크톱 앱: 클릭 가능한 핫스팟이 있는 인터랙티브 마우스 다이어그램, 버튼별 액션 선택기(내장 액션 41개 + TOML 설정에 직접 작성하는 사용자 지정 단축키), DPI 프리셋, SmartShift 패널(휠 모드·감도·영구 래칫), 앱별 프로필 오버레이, 페어링된 기기를 실시간 전환하는 기기 캐러셀, 그리고 20개 언어로 현지화된 설정 창.
• OpenLogi CLI — 헤드리스 기기 목록(list), 에셋 동기화, 기기 진단 하위 명령을 갖춘 CLI.

모든 것이 로컬에서 이루어집니다: 바인딩은 순수 TOML 파일에 저장되고, 버튼 입력은 OS 이벤트 훅으로 리매핑되며, DPI / SmartShift 변경은 HID++를 통해 기기에 직접 기록됩니다.

macOS와 Linux를 지원합니다. Windows는 검증되지 않은 초기 프리뷰로, 각 릴리스에 서명된 빌드가 포함됩니다 — 로드맵을 참고하세요.

Options+ 그 너머

OpenLogi는 되고 Options+는 안 되는 것들:

• Linux에서 실행. Options+는 macOS와 Windows 전용입니다. OpenLogi는 Linux를 일급 플랫폼으로 다룹니다: evdev/uinput 훅, udev 규칙, systemd 사용자 유닛, .deb / .rpm 패키지.
• 제스처 버튼 이동. 어떤 물리 버튼이 제스처 역할을 맡을지 — 썸 패드, 가운데, 뒤로, 앞으로 — 직접 고를 수 있고, 방향별 스와이프 바인딩을 설정하거나 제스처를 아예 끌 수도 있습니다. Options+는 제스처 역할을 전용 썸 패드에 고정합니다.
• 순수 텍스트 설정. 모든 설정이 TOML 파일 하나에 들어 있어 읽고, diff하고, 버전 관리하고, 다른 기기로 복사할 수 있습니다.
• 스크립트 가능. 진짜 CLI: 기기 목록, 에셋 프리페치, 기기 내 HID++ 진단(피처 덤프, DPI / SmartShift 왕복 검사).
• 가볍게 유지. 네이티브 Rust + GPUI 바이너리 — Electron 스위트도, 상주 업데이터도, 계정도, 텔레메트리도 없습니다.

로드맵

기능	상태
Bolt 수신기 탐색 + 페어링된 기기 목록(CLI + GUI)	✅
Unifying 수신기(Bolt로 대체된 구형 프로토콜)	✅
Bluetooth 직접 연결 / 유선 기기(수신기 없음)	✅
배터리 잔량 / 충전 상태	✅ (온라인 기기)
인터랙티브 GUI: 캐러셀, 마우스 다이어그램, 액션 선택기	✅ macOS + Linux
OS 이벤트 훅 / evdev를 통한 버튼 리매핑	✅ macOS + Linux
41개 액션 카탈로그 + 사용자 지정 키보드 단축키(TOML 직접 작성)	✅ macOS + Linux¹
DPI 제어 + 프리셋 + 사이클 / 프리셋 지정 액션(HID++ 0x2201)	✅
SmartShift 휠: 모드 전환 + 감도 + 영구 래칫 패널(HID++ 0x2111)	✅
앱별 프로필 오버레이(앱 포커스 시 자동 전환)	✅ macOS, 🟡 Linux (X11 전용)
설정 창: 로그인 시 실행, 업데이트 확인, 메뉴 막대, 권한, 언어	✅ macOS + Linux
인터페이스 현지화(20개 언어: da, de, el, en, es, fi, fr, it, ja, ko, nb, nl, pl, pt-BR, pt-PT, ru, sv, zh-CN, zh-HK, zh-TW)	✅
Linux 패키징: udev 규칙, systemd 유닛, .deb / .rpm	✅ Linux
제스처 버튼 방향별 바인딩	🟡 설정 가능; 하드웨어 캡처는 개발 중
가운데 / 모드 시프트 / 썸휠 버튼 캡처	🟡 설정 가능; 훅은 현재 사이드 버튼만 담당
Windows(에이전트, GUI, 이벤트 훅)	🟡 미검증 프리뷰 — 각 릴리스에 서명된 .exe / .msi 포함

¹ Linux의 미디어 키 액션은 D-Bus MPRIS를 사용합니다. 일부 macOS 전용 액션(예: Launchpad)은 Linux에 대응 기능이 없어 아무 동작도 하지 않습니다.

설치

Important

먼저 Logi Options+ 를 종료하세요 — 두 애플리케이션은 HID++ 접근을 두고 경합하며, 하나의 수신기는 한쪽만 소유할 수 있습니다.

macOS

최신 릴리스에서 서명·공증된 .dmg를 내려받아 OpenLogi.app을 /Applications로 드래그하세요.

또는 Homebrew로 설치:

brew install --cask openlogi

공식 Homebrew cask가 기본 설치 경로입니다. 대신 aprilnea/tap으로 GitHub 최신 릴리스를 명시적으로 따라가려면:

brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest

openlogi@latest는 OpenLogi 릴리스 워크플로가 관리하며 공식 cask의 autobump보다 먼저 갱신될 수 있습니다. openlogi와 openlogi@latest 중 하나만 설치하세요.

Linux

최신 릴리스에서 .deb 또는 .rpm을 내려받으세요:

# Debian / Ubuntu
sudo dpkg -i openlogi_*.deb

# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

패키지는 x86_64/amd64와 arm64/aarch64 두 아키텍처로 제공됩니다.

패키지는 sudo 없이 /dev/hidraw*와 /dev/uinput에 접근할 수 있게 해 주는 udev 규칙을 설치합니다. 설치 후 사용자용 백그라운드 에이전트를 활성화하세요:

systemctl --user enable --now openlogi-agent.service

수동 / 소스 설치와 systemd가 없는 배포판은 INSTALL-linux.md를 참고하세요.

Windows (프리뷰)

각 릴리스에 서명된 .exe와 사용자별 .msi 설치 파일(x86_64 및 arm64)이 포함됩니다. Windows 지원은 실제 하드웨어에서 충분히 검증되지 않은 초기 프리뷰입니다 — 다듬어지지 않은 부분이 있을 수 있으니 이슈로 제보해 주세요.

소스에서 빌드하려면 DEVELOPMENT.md를 참고하세요.

사용법 (CLI)

USAGE.md 참고

설정

CONFIGURATION.md 참고

개발

DEVELOPMENT.md 참고

감사의 말

• hidpp — @lus
• Solaar
• Mouser — Tom Badash

라이선스

다음 중 하나를 선택해 사용할 수 있습니다:

• Apache License 2.0 (LICENSE-APACHE)
• MIT 라이선스 (LICENSE-MIT)

로고 및 브랜드 자산

OpenLogi 로고와 앱 아이콘 — design/ 아래의 브랜드 자산 — 은 © 2026 AprilNEA가 모든 권리를 보유하며, 위 MIT/Apache 라이선스의 적용을 받지 않습니다. design/LICENSE를 참고하세요. 코드를 포크해도 OpenLogi 이름·로고·아이콘에 대한 권리는 부여되지 않습니다. 사전 서면 허가 없이 자신의 프로젝트, 포크, 배포판을 나타내는 데 사용하지 마세요.

---

Logitech과 무관합니다. "Logitech", "MX Master", "Options+"는 Logitech International S.A.의 상표입니다.

저장소 활동