Installation

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

macOS and Linux are supported. Windows is an early, untested preview — signed builds ship with each release (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

Homebrew

brew install --cask openlogi

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.

Launch and grant permissions

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.

Linux

Download the .deb or .rpm — packages are published for both x86_64/amd64 and arm64/aarch64:

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

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

The package installs udev rules that grant your user access to /dev/hidraw* (HID++ commands) and /dev/uinput (the virtual remapping device) without sudo. 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 (preview)

Download the signed .msi installer for x86_64 or arm64. Portable .zip builds are also attached to each release. Windows support is an early preview that hasn't been broadly tested on real hardware yet — expect rough edges, and please report issues.

Build from source

See DEVELOPMENT.md in the repository.