What Logitech Devices Are Supported by OpenLogi?
OpenLogi supports Logitech mice and keyboards via the HID++ protocol (over Bolt, Unifying, Bluetooth, or wired connections) and Logitech UVC webcams such as the Brio, StreamCam, and C920 series.
OpenLogi (AprilNEA/OpenLogi) is an open-source Rust framework designed to unlock the full capabilities of Logitech peripherals. According to the project's README.md, the codebase explicitly targets hardware communicating over HID++ (for input devices) and UVC (for cameras), making it compatible with a wide range of modern Logitech products.
HID++ Mice Supported by OpenLogi
OpenLogi interoperates with any Logitech mouse that implements the HID++ 2.0 or later protocol. This includes the entire MX Master series (MX Master 3, 3S), the G Pro line, the G502 series, and other gaming and productivity mice.
The crates/openlogi-device-registry module maintains the internal mapping of device IDs to capabilities, while crates/openlogi-core/src/device.rs defines the DeviceKind enum that categorizes these units. Supported features include:
- DPI adjustment (high-resolution sensor control)
- SmartShift (adaptive scroll wheel technology)
- Button remapping and per-application profiles
These devices connect through multiple transports implemented in crates/openlogi-hidpp/src/receiver/, including the Bolt receiver (bolt.rs), Unifying receiver (unifying.rs), and direct USB.
HID++ Keyboards Supported by OpenLogi
Any Logitech keyboard utilizing the HID++ protocol is supported. This encompasses popular models such as the MX Keys family (including MX Keys Mini and MX Keys S), the G915 gaming keyboard, and other wireless or wired HID++ compatible boards.
As noted in AGENTS.md, the architecture handles communication regardless of whether the keyboard is paired via a Bolt/Unifying receiver, Bluetooth-direct, or wired USB connection. The library abstracts these transport layers, providing a unified interface for key remapping and backlight control where hardware permits.
UVC Webcams Supported by OpenLogi
For video devices, OpenLogi leverages the standard USB Video Class (UVC) protocol. The documentation explicitly lists support for "any Logitech UVC webcam (Brio, StreamCam, C920 series, …)" across multiple localized README files, including docs/README.zh-CN.md and docs/README.de.md.
This means plug-and-play compatibility with:
- Logitech Brio (4K Pro Webcam)
- Logitech StreamCam
- Logitech C920 series (C920, C920e, C922, C925e)
The UVC implementation allows OpenLogi to control exposure, white balance, and pan-tilt-zoom (PTZ) functions programmatically.
Verifying Device Compatibility
You can verify if your specific Logitech device is recognized by using the OpenLogi CLI or querying the device registry programmatically.
List Connected Devices via CLI
Run the following command from the repository root to enumerate all detected Logitech devices:
cargo run -p openlogi-cli -- list
This command queries the DeviceRegistry and outputs active routes for HID++ mice, keyboards, and UVC cameras accessible to the system.
Programmatic Device Check
To check for a specific device category in Rust, inspect the DeviceKind enum defined in crates/openlogi-core/src/device.rs:
use openlogi_core::DeviceKind;
fn check_device_support(kind: &DeviceKind) -> &'static str {
match kind {
DeviceKind::Mouse => "HID++ Mouse: Supported",
DeviceKind::Keyboard => "HID++ Keyboard: Supported",
DeviceKind::Light => "HID++ Light/Accessory: Supported",
}
}
For UVC webcams, the library uses standard V4L2 or platform-specific UVC APIs to detect compatible video devices without requiring device-specific drivers.
Summary
- Mice: All HID++ compatible Logitech mice (MX Master, G Pro, G502, etc.) are supported via Bolt, Unifying, Bluetooth, or wired connections.
- Keyboards: All HID++ compatible Logitech keyboards (MX Keys, G915, etc.) work across the same connection types.
- Webcams: Any Logitech UVC-compliant webcam, specifically cited models including Brio, StreamCam, and the C920 series.
- Transports: The stack supports Bolt receivers (
bolt.rs), Unifying receivers (unifying.rs), and Bluetooth direct (bt.rs) as documented inAGENTS.md.
Frequently Asked Questions
Does OpenLogi support the Logitech G502 X Plus gaming mouse?
Yes. The G502 X Plus communicates via the HID++ protocol, making it fully compatible with OpenLogi's mouse feature set, including DPI configuration and button remapping as handled in crates/openlogi-device-registry.
Can I use my Logitech C920e webcam with OpenLogi?
Yes. The C920e is a UVC-compliant device explicitly listed in the project's documentation (docs/README.zh-CN.md). It operates as a standard UVC webcam and requires no proprietary drivers.
Is a Logitech Unifying Receiver mandatory for OpenLogi to work?
No. While the Unifying Receiver is supported via crates/openlogi-hidpp/src/receiver/unifying.rs, OpenLogi also supports the newer Bolt receiver (bolt.rs), direct Bluetooth connections (bt.rs), and wired USB, as outlined in AGENTS.md.
Are legacy Logitech HID 1.0 devices supported by OpenLogi?
No. The architecture specifically targets HID++ 2.0 and later protocols. Legacy HID 1.0 devices that do not implement the HID++ feature set are not within the scope of the current openlogi-hidpp crate implementation.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →