OpenLogi README

The project's README from github.com/AprilNEA/OpenLogi. As one markdown file: README.md.

[!WARNING] OpenLogi is under active development and not yet stable — features and config may still change. Give the repo a Star ⭐ and Watch 👀 it to get notified when a new release lands.

OpenLogi

OpenLogi

⚡️ A native, local-first alternative to Logitech Options+, written in Rust 🦀
Unlock the full capabilities of Logitech mice, keyboards, and webcams over HID++ and UVC

GitHub release GitHub downloads GitHub commit License Hits
X telegram
English 简体中文 日本語 Deutsch Français 한국어 Русский Español Português Türkçe

AprilNEA%2FOpenLogi | Trendshift OpenLogi - A local-first alternative to Logitech Options+ | Product Hunt

Fed up with Options+? Try OpenLogi.

Runs on macOS, Linux, and Windows.


Beyond Options+

Things OpenLogi does that Options+ won't:

Features

OpenLogi device list with six Logitech devices: mice, a keyboard, and a Litra light

Devices

Easy-Switch card listing three paired computers Easy-Switch
  • See which computer is paired on each channel, with its OS and connection
  • Rename a channel on devices that allow it
  • Bind a button or Actions Ring slot to move the device to another channel

Buttons and actions

Button mapping for an MX Master 4, with the gesture button inspector open Remap any button
  • A built-in action catalog, custom shortcuts, typed text, or multi-step workflows
  • Separate tap and hold actions, and hold-to-talk chords that release with the button
  • Gestures on Middle Click, Back/Forward, DPI/ModeShift, the gesture button, and the haptic panel
Actions Ring editor with eight slots around the cursor Actions Ring
  • Eight actions in a ring around the cursor
  • Its own layout per application
MX Keys S with three keys bound to Launchpad, Lock Screen, and Screenshot Keyboard keys
  • Bind media, emoji, screenshot, and other dedicated keys like mouse buttons
  • Restore one key to its device default, or reset the whole row

Per-application profiles switch with the focused app. An [apps] alias lets one profile follow an application across platforms.

Pointer and scrolling

Pointer tuning card with a DPI slider Pointer
  • DPI presets with cycle and set-preset actions
  • Pointer speed and report rate
  • Precision Mode: one button switches the mouse to its slowest speed and back
SmartShift card with wheel mode, sensitivity, and scrolling force SmartShift
  • Wheel mode and sensitivity
  • Scrolling force on SmartShift Enhanced mice
  • A permanent-ratchet switch
Scrolling card with inversion, wheel resolution, and smooth wheel
Scrolling
  • Scroll inversion per device, natively or in software
  • Wheel resolution and smooth wheel scrolling
  • Hold Back or Forward and roll the wheel to scroll sideways on mice without a thumb wheel

Keyboard and lighting

Keys and Backlight cards for an MX Keys S Keyboard
  • Fn Lock, and multi-platform keyboards that stay on the host OS layout
  • Backlight level, automatic brightness, battery saving, and how long the keys stay lit
  • The backlight level shown on screen as it changes
  • Static RGB on supported keyboards
Litra Glow lighting panel with brightness and color temperature Litra lights
  • Power, brightness, and color temperature
  • Turns on with the camera if you want
  • Keeps a change made on the light itself

Webcams

Feature coverage depends on what each device reports; the app shows only the controls a device supports.

Platform support

Feature macOS Windows Linux
Mouse button remapping and gestures ✓ ✓ ✓
Keyboard F-key remapping ✓ ✓ —
Per-application profiles ✓ ✓ X11, wlroots (sway, Hyprland), GNOME with the companion extension
Mouse profile follows the window under the pointer ✓ ✓ X11 only
Media keys Native Native D-Bus MPRIS
Window-manager actions (desktops, Mission Control, …) Native Native equivalents GNOME, KDE (KWin), Hyprland; some macOS-only actions do nothing
Menu-bar / tray icon ✓ ✓ —
Device controls in the menu-bar / tray menu ✓ — —
In-app updates Sparkle Built-in Built-in

Install

[!IMPORTANT] Quit Logi Options+ (and Solaar on Linux) first. Only one application can own a receiver at a time. On macOS, Karabiner-Elements also locks a Bluetooth keyboard that it modifies. Turn off Modify events for that keyboard in Karabiner-Elements → Settings → Devices.

Platform System Architecture
macOS macOS 13 or later Apple silicon, Intel
Linux GLIBC 2.35 or newer x86_64, arm64
Windows Tested on Windows 11 x86_64, arm64

Every download carries a minisign signature and an entry in SHA256SUMS. To build from source, see DEVELOPMENT.md.

macOS

Download for Mac: Apple silicon (.dmg)   Download for Mac: Intel (.dmg)

Or with Homebrew:

brew install --cask openlogi

Open OpenLogi and grant Accessibility and Input Monitoring when macOS asks. OpenLogi then updates itself through Sparkle.

Linux

Download for Linux: Debian, Ubuntu (.deb)   Download for Linux: Fedora, SUSE (.rpm)   Download for Linux: Arch (.pkg.tar.zst)

Or install the right package for your distribution with one command. It verifies the minisign signature and starts the agent; install minisign first:

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

On Arch Linux, the openlogi AUR package builds the release from source:

yay -S openlogi

To read the script before running it, and for the AUR package, Flatpak, NixOS, and distributions without systemd, see INSTALL-linux.md.

Windows

Download for Windows: installer (.msi)   Download for Windows: portable (.zip)

Usage (CLI)

See USAGE.md

Configuration

Settings use plain TOML; saves preserve symlinked config files. See CONFIGURATION.md.

Developing

See DEVELOPMENT.md, including macOS input-hook safety.

Acknowledgments

Contributors

Contributors

Logo and app icon by @kubai087.

Credits

Infrastructure

CI powered by Namespace

License

The code in this repository is dual-licensed under either of

at your option.

Logo & brand assets

The OpenLogi logo and app icon (the brand assets under design/) are © 2026 AprilNEA, all rights reserved, and are not covered by the MIT/Apache licenses above; see design/LICENSE. Forking the code grants no right to the OpenLogi name, logo, or icon; please don't use them to represent your own projects, forks, or distributions without prior written permission.


Not affiliated with Logitech. "Logitech", "MX Master", and "Options+" are trademarks of Logitech International S.A.

Repo activity

Repobeats analytics image

OpenLogi (AprilNEA/OpenLogi)

logitech
Searching Database…

25.9K ·GitHub
What is this?OpenLogi is a native, local-first alternative to Logitech Options+ written in Rust: it unlocks Logitech mice, keyboards, and webcams over HID++ and UVC, with no account and no telemetry.
How is it different from just using Logitech Options+?It stays light (native Rust + GPUI), treats Linux as a first-class platform, puts gestures on any button, keeps all settings in one plain-text TOML file, and ships a real CLI alongside the GUI.
Can I keep Logitech Options+ installed alongside it?No — quit Options+ first: the two apps fight over HID++ access and only one can own a given receiver at a time. Devices connect via Logi Bolt, Unifying receivers, Bluetooth, or wired.
Is it stable enough to replace Options+ today?Not quite yet — it's under active development and not stable, so features and config may change. Windows is the newest port, validated end-to-end on Windows 11, but rough edges are expected.
Does it work on Linux, or is it macOS-only like the official app?It runs natively on macOS 13+, Linux, and Windows. Linux is first-class: x86_64 and arm64 packages (GLIBC 2.35+), a NixOS module, and udev rules that grant access to /dev/hidraw and /dev/uinput without sudo.
Does it need an account or send telemetry anywhere?No account, no telemetry — it's local-first. All settings live in one TOML file that you sync between machines yourself.
What can it do with an MX Master-class mouse?DPI presets with Cycle and Set actions, full SmartShift control (mode, sensitivity, a permanent-ratchet panel), remapping of the middle, mode-shift, and thumbwheel buttons, per-direction gestures with live capture, and the Actions Ring — a cursor-centred eight-slot action overlay.
Does it handle keyboards and webcams too?Yes: global F-key remapping with typed text, key combos, and multi-step workflows (macOS + Windows), plus static RGB lighting. Any Logitech UVC webcam (Brio, StreamCam, C920 series) is plug and play — image controls are written to the camera hardware, so they apply in Zoom, Meet, OBS, and every other app.
How do per-application profiles work?Profile overlays auto-switch when an app gains focus — on macOS and Windows, and on Linux only under X11 or XWayland. Media-key actions go through D-Bus MPRIS on Linux, where a few macOS-specific actions are no-ops.
Can I script it without opening the GUI?Yes — a real CLI ships alongside the GUI (documented in USAGE.md), and the whole configuration is one TOML file you can edit and sync by hand.
Creator
AprilNEA
Size
28.7 MB
Stars
25.9K
Age
5mo
Commits · 90 Days