Installation

How to install OpenLogi on macOS, Linux, or Windows via Homebrew, package manager, or direct download.

macOS, Linux, and Windows are supported.

Quit Logi Options+ before installing or launching OpenLogi

The two applications fight over HID++ access and only one can own a receiver at a time. On Linux, the same applies to Solaar.

macOS

Requires macOS 13 or later.

brew install --cask openlogi

The official cask is the default path. To track the latest GitHub release instead:

brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest

Install either openlogi or openlogi@latest, not both.

Download the release

Download the signed, notarized DMG installer for Apple silicon or Intel.

Install the app

Open the DMG installer and drag OpenLogi.app to /Applications.

On first launch, macOS may ask you to confirm the app and to grant Accessibility / Input Monitoring permission, required to remap buttons through the OS event tap. Webcam preview additionally needs Camera permission.

Linux

Download the package for your distribution. Every format is published for both x86_64/amd64 and arm64/aarch64:

# Debian / Ubuntu
sudo dpkg -i openlogi_*.deb

# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

# Arch Linux
sudo pacman -U openlogi-*.pkg.tar.zst

Direct links: .deb · .rpm · .pkg.tar.zst.

The package installs udev rules that grant your user access to /dev/hidraw* (HID++ commands), /dev/uinput (the virtual remapping device), and your Logitech mouse's /dev/input/event* node; no sudo needed. Then enable the background agent for your user:

systemctl --user enable --now openlogi-agent.service

If a device was already plugged in when the udev rules were installed, unplug and replug the receiver (or power-cycle the device) so the new rules apply. The GUI's Settings → Permissions page shows a live access indicator.

For manual / source installs and distros without systemd, see INSTALL-linux.md.

Windows

Download the signed .msi installer for x86_64 or arm64. Portable .zip builds are attached to each release too.

Both ship the GUI (OpenLogi.exe) alongside the background agent (openlogi-agent.exe), which owns all device I/O; keep the two files side by side when using the portable zip, or the GUI has nothing to connect to. The agent shows a notification-area icon (Show Main Window / Quit) so the app stays reachable after the main window is closed; to hide it, set show_in_menu_bar = false in the TOML [app_settings] block and restart the agent (the GUI toggle is macOS-only today).

Build from source

See DEVELOPMENT.md in the repository.