OpenLogi desktop application
Local-first GUI for configuring supported Logitech mice, keyboards, webcams, and Litra lights over HID++ and UVC.
README.mdStandalone desktop peripheral-management application · Actively developed and explicitly not yet stable
Dual-licensed Rust desktop application, background agent, and CLI that provide local-first configuration and control for Logitech mice, keyboards, webcams, receivers, and Litra lights across macOS, Linux, and Windows; it is a standalone peripheral utility, not a Claude Code extension.
Selection
Boundaries
Strengths
Risk profile
The application owns peripheral I/O and uses operating-system input hooks, so compromise or misconfiguration could affect input behavior and device settings. Linux packaging installs udev rules granting user access to hidraw, uinput, and relevant input-event nodes. The GNOME extension exposes focused-window WM_CLASS over the user D-Bus and states that it reads no titles, contents, input, or UI. The macOS packaging documentation separates development and production bundle identities to avoid inheriting production TCC grants and describes signing controls; the README describes signed/notarized macOS packages and signed Windows packages. Uncertainty: implementations and audits were not supplied.
Component inventory
Local-first GUI for configuring supported Logitech mice, keyboards, webcams, and Litra lights over HID++ and UVC.
README.mdLists paired devices with slot, codename, kind, online state, and battery information; it is the default command.
docs/USAGE.mdPre-fetches device renders from the fastest valid asset mirror or a specified base URL.
docs/USAGE.mdDumps every HID++ feature reported by the active device.
docs/USAGE.mdDumps reprogrammable controls and their capability flags.
docs/USAGE.mdPerforms a DPI read, write, read-back, and restore smoke test.
docs/USAGE.mdToggles SmartShift and restores its previous state as a smoke test.
docs/USAGE.mdSets a solid hexadecimal color on a supported wired RGB keyboard.
docs/USAGE.mdOwns device I/O and serves the desktop application; Linux packages provide a systemd user service and Windows provides a tray process.
README.mdBundled helper used for OpenLogi overlays, including the desktop bundle's overlay component.
xtask/README.mdCursor-centered eight-slot action overlay with per-application layouts.
README.mdPlain-text configuration for device mappings, custom shortcuts, profiles, workflows, and application settings.
README.mdExports focused-window WM_CLASS changes over D-Bus so OpenLogi can switch per-app profiles on GNOME Wayland.
crates/openlogi-hook/gnome-shell-extension/README.mdOpenLogi-oriented HID layer for discovery, receiver routing, pairing, typed device operations, and diagnostics.
crates/openlogi-hid/README.mdVendored HID++ implementation with typed wrappers for device, power, host, pointer, wheel, remapping, keyboard, lighting, audio, and other features.
crates/openlogi-hidpp/README.mdInstalls four OpenLogi executables, udev rules, a systemd user unit, desktop launcher, and icons from release build output.
packaging/linux/install.shInstalls OpenLogi, configures udev access, and starts the agent with the graphical session.
README.mdReproduces host-compatible jobs from ci.yml, with listing and dry-run support.
xtask/README.mdBuilds icons, development or production app bundles, DMGs, and complete macOS packages.
xtask/README.mdGenerates changelog and updater metadata, checks publishability, and locates the version-bump commit.
xtask/README.mdTechnical profile
Classification
Evidence: OpenLogi installs as its own GUI, background agent, overlay, and CLI and operates independently of Claude Code. Evidence: platform packages require ordinary application installation plus device permissions or agent setup on some systems. No Claude-specific extension mechanism is documented.
Standalone · medium setup effort · high confidence · automatedEvidence and risk
Routing context
No catalog relationships have been documented yet.