Installation

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

Direct download

Download the release

Grab the signed, notarized .dmg from the latest release .

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 from the latest release — 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)

Signed .exe and per-user .msi installers (x86_64 and arm64) are 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.