README.ko.md

Warning

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

OpenLogi

⚡️ Rust로 작성된 네이티브 로컬 우선 Logitech Options+ 대안 🦀
HID++와 UVC로 Logitech 마우스·키보드·웹캠의 모든 기능을 끌어냅니다

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

macOS, Linux, Windows를 지원합니다.

---

Options+ 그 너머

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

• 가볍게 유지. 네이티브 Rust + GPUI.
• Linux 지원. Linux는 OpenLogi의 일급 플랫폼입니다.
• 지원되는 버튼에서 제스처 사용. 지원되는 컨트롤에 제스처 동작을 지정하거나, 제스처를 아예 끌 수 있습니다.
• 순수 텍스트 설정. 모든 설정이 TOML 파일 하나에 담겨 원하는 방법으로 기기 간 동기화할 수 있습니다.
• 스크립트 가능. GUI 외에 진짜 CLI도 제공합니다. DPI, SmartShift, Fn Lock, 보고율을 다루는 JSON 자동화 API와 하드웨어 진단 기능을 갖추고 있습니다.

기능 목록

기기

• Logi Bolt 수신기, Unifying 수신기, Bluetooth, 유선 연결을 지원하며 배터리 잔량과 충전 상태 표시
• 배터리 부족 알림을 화면 하단에 방전당 한 번만 표시하며, OS 알림 권한은 필요 없음
• 키보드에서 Caps Lock을 켜거나 끄면 화면에 표시기를 띄움. Windows와 Linux에서는 Num Lock과 Scroll Lock도 지원

Easy-Switch 채널마다 페어링된 컴퓨터를 OS, 연결 방식과 함께 확인 지원 기기에서는 채널 이름 변경 가능

버튼과 액션

	모든 버튼 리매핑 내장 액션 카탈로그, 사용자 지정 단축키, 텍스트 입력, 다단계 워크플로 탭과 길게 누르기에 각각 다른 액션, 버튼을 놓으면 해제되는 누르고 말하기용 키 조합 가운데 클릭, 뒤로/앞으로, DPI/모드 시프트, 제스처 버튼, 햅틱 패널에서 제스처 사용
	Actions Ring 커서 주위에 링 형태로 배치되는 액션 8개 앱마다 별도 레이아웃
	키보드 키 미디어, 이모지, 스크린샷 등 전용 키를 마우스 버튼처럼 지정 키 하나만 기기 기본값으로 되돌리거나 행 전체를 재설정

앱별 프로필은 포커스된 앱에 따라 전환됩니다. [apps] 별칭을 쓰면 프로필 하나가 여러 플랫폼에서 같은 앱을 따라갑니다.

포인터와 스크롤

	포인터 DPI 프리셋과 사이클 / 프리셋 지정 액션 포인터 속도와 보고율 정밀 모드: 버튼 하나로 마우스를 가장 느린 속도로 바꾸고 다시 원래대로 복귀
	SmartShift 휠 모드와 민감도 SmartShift Enhanced 마우스의 스크롤 압력 래칫 고정 스위치
스크롤 기기별 스크롤 반전(네이티브 또는 소프트웨어) 휠 해상도와 부드러운 휠 스크롤 썸휠이 없는 마우스에서도 뒤로 또는 앞으로 버튼을 누른 채 휠을 굴리면 가로 스크롤

키보드와 조명

	키보드 Fn Lock, 그리고 호스트 OS 레이아웃을 유지하는 멀티 플랫폼 키보드 백라이트 밝기, 자동 밝기, 배터리 절약, 키 조명 유지 시간 백라이트 밝기를 바꿀 때 화면에 표시 지원 키보드의 정적 RGB
	Litra 조명 전원, 밝기, 색온도 원하면 카메라 사용에 맞춰 자동으로 켜기 조명 본체에서 바꾼 설정을 유지

웹캠

• 모든 Logitech UVC 웹캠(Brio, StreamCam, C920 시리즈 등) 플러그 앤 플레이 지원
• 실시간 미리보기는 보고 있는 동안에만 카메라를 사용하며, 벗어나면 LED도 꺼집니다
• 줌, 팬, 틸트, 초점, 노출, 화이트 밸런스 등 모든 UVC 컨트롤을 하드웨어에 기록하므로 Meet, Zoom, OBS에도 변경 사항이 적용됩니다
• 기본값 / 스트리밍 / 영상 통화 내장 프로필과 사용자 스냅숏을 카메라별로 저장

지원 기능은 각 기기가 보고하는 내용에 따라 다르며, 앱은 기기가 지원하는 컨트롤만 표시합니다.

플랫폼 지원

기능	macOS	Windows	Linux
마우스 버튼 리매핑과 제스처	✓	✓	✓
키보드 F 키 리매핑	✓	✓	—
앱별 프로필	✓	✓	X11, wlroots(sway, Hyprland), GNOME(동반 확장 필요)
포인터 아래 창을 따라가는 마우스 프로필	✓	✓	X11 전용
미디어 키	네이티브	네이티브	D-Bus MPRIS
창 관리자 액션(데스크톱, Mission Control 등)	네이티브	네이티브 대응 기능	GNOME, KDE (KWin), Hyprland; 일부 macOS 전용 액션은 동작하지 않음
메뉴 막대 / 트레이 아이콘	✓	✓	—
앱 내 업데이트	Sparkle	내장	내장

설치

Important

먼저 Logi Options+(Linux에서는 Solaar도)를 종료하세요. 하나의 수신기는 한 번에 하나의 애플리케이션만 소유할 수 있습니다.

플랫폼	시스템	아키텍처
macOS	macOS 13 이상	Apple 실리콘, Intel
Linux	GLIBC 2.35 이상	x86_64, arm64
Windows	Windows 11에서 테스트됨	x86_64, arm64

모든 다운로드에는 minisign 서명과 SHA256SUMS 항목이 함께 제공됩니다. 소스에서 빌드하려면 DEVELOPMENT.md를 참고하세요.

macOS

 

또는 Homebrew로 설치:

brew install --cask openlogi

OpenLogi를 열고 macOS가 요청하면 손쉬운 사용과 입력 모니터링 권한을 허용하세요. 이후 OpenLogi는 Sparkle로 스스로 업데이트합니다.

Linux

   

또는 명령 하나로 배포판에 맞는 패키지를 설치할 수 있습니다. 스크립트는 minisign 서명을 검증하고 agent를 시작합니다. 먼저 minisign을 설치하세요:

curl -fsSL https://github.com/AprilNEA/OpenLogi/releases/latest/download/install.sh | sh

실행 전에 스크립트를 확인하는 방법과 Flatpak, NixOS, systemd가 없는 배포판에 대해서는 INSTALL-linux.md를 참고하세요.

Windows

 

사용법 (CLI)

USAGE.md 참고

설정

설정은 순수 TOML을 사용하며, 저장할 때 심볼릭 링크된 설정 파일을 그대로 유지합니다. CONFIGURATION.md 참고.

개발

macOS 입력 훅 안전성을 포함해 DEVELOPMENT.md 참고.

감사의 말

• Windows·카메라·i18n — @davidbudnick: 키보드 RGB 지원, Windows 지원, Logitech 웹캠 지원
• Linux 포팅 — @cserby: Linux 지원
• Solaar — @pwr: 오픈소스 HID++ 구현
• Mouser — @TomBadash: 로컬에서 동작하는 계정 없는 Options+ 대체제

라이선스

이 저장소의 코드는 다음 중 하나를 선택해 사용할 수 있습니다:

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

서드파티 코드

crates/openlogi-hidpp는 hidpp(@lus 제작)의 vendored fork이며, 0BSD 라이선스를 따릅니다.

로고 및 브랜드 자산

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

---

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

저장소 활동