Installation

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

macOS, Linux, and Windows are supported. Windows is the newest port — validated end-to-end on Windows 11 hardware, with more rough edges than the other two (see the roadmap).

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.

Homebrew

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 for Apple silicon or Intel.

Install the app

Open the .dmg 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.