OpenLogi: Local Control for Your Logitech Gear

OpenLogi is a local-first replacement for Logitech Options+, engineered in Rust. It brings your Logitech mice, keyboards, and cameras back under your direct control, eliminating the need for cloud accounts and telemetry.

Not affiliated with Logitech. Licensed under MIT / Apache-2.0.

🛠 Core Functionality

The heart of OpenLogi is an intuitive interface featuring a mouse diagram with interactive hotspots. Users can simply click a button and select a corresponding action from a picker.

🖱 Hardware Capabilities

OpenLogi communicates directly via the HID++ protocol to manage your hardware:

• Button Remapping: Bind any physical button to one of $\approx 44$ built-in actions (e.g., MissionControl, BrowserBack, NextTab).
• DPI Management: Control pointer resolution by setting and cycling through custom presets (e.g., $200 \rightarrow 800 \rightarrow 1600$ DPI) written directly to the sensor.
• Wheel Control: Manage the scroll wheel via HID++ 0x2201, toggling between ratchet and free-spin modes or configuring the autoDisengage threshold for SmartShift.
• Device Monitoring: A live carousel displays paired devices with real-time battery percentages and charging states.

Note: Per-app profiles (using HID++ 0x2111) are coming soon, allowing overlays to switch automatically based on the active application (e.g., Chrome or Figma).

---

⚙️ Configuration & Privacy

Your settings are not stored in a proprietary cloud; they live in a plain-text config.toml file that you own and can edit manually.

Example Configuration

schema_version = 2
selected_device = "2b042"

[devices.2b042.bindings]
MiddleClick = "MissionControl"
DpiToggle = "CycleDpiPresets"
Thumbwheel = "VolumeUp"
Forward = "BrowserForward"
Back = "BrowserBack"
GestureButton = "AppExpose"

Data Flow Architecture

OpenLogi is designed so that your identity never leaves your machine.

Privacy Guardrails:

• No Identity: Update checks are $\text{OFF}$ by default and strictly opt-in.
• Local Storage: Bindings and profiles never leave your hardware.
• Physical Identity: Devices are keyed by serial numbers/slots, ensuring bindings persist across different machines.

---

🚀 Installation & Compatibility

OpenLogi supports a wide array of connectivity options: Bolt, Unifying, Lightspeed, Bluetooth, or USB.

[!WARNING] Crucial: You must quit Logi Options+ before starting OpenLogi. Because only one application can claim the HID++ receiver at a time, the two programs will conflict.

macOS Specifics

To remap side buttons (Back, Forward, Middle Click), OpenLogi utilizes a CGEventTap. Consequently, you must grant the app Accessibility permissions in System Settings. (Note: Thumb wheel and DPI controls do not require this).

---

🗺 Roadmap & Current Status

While highly functional, some features are still in development:

• Bolt pairing via GUI
• Unifying and Lightspeed pairing (Currently: use Solaar or official Logi tools)
• Easy-Switch host switching (HID++ 0x1814/0x1815)
• Cross-computer pointer/clipboard bridge (Long-term goal)
• Built-in sync (Difficult to implement without violating the "no-account" principle)