Assembly instructions

AprilNEA/OpenLogi

⚡️A native, local-first alternative to Logitech Options+, written in Rust 🦀 — remap buttons, DPI, and SmartShift over HID++. No account, no telemetry.

Rust#dpi#gpui#hid#hidpp

Difficulty: Easy
Time: about 5 min
Stars: ★ 25,259
Activity: Updated this month
License: Apache-2.0
Open issues: 627
Got it running: Be the first
Looked up: 3 h ago

Saved setup from 3 h ago

Start here

Website ↗openlogi.orgThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Supported devices from the README: Devices

Logi Bolt and Unifying receivers, Bluetooth, and wired connections, with battery level and charge state
Low-battery notices at the bottom of the screen, once per discharge, with no OS notification permission
An on-screen indicator when a keyboard turns Caps Lock on or off, plus Num Lock and Scroll Lock on Windows and Linux

<table> <tr> <td width="50%"><img src="https://assets.openlogi.org/screenshots/macos/light/cards/easy-switch.png" width="400" alt="Easy-Switch card listing three paired computers"></td> <td width="50%"><b>Easy-Switch</b><ul><li>See which computer is paired on each channel, with its OS and connection</li><li>Rename a channel on devices that allow it</li></ul></td> </tr> </table>

Checking for

Download for macOS

v0.9.0 · 11/3/2026 ↗

OpenLogi-v0.9.0-macos-arm64.dmg

dmg · Apple Silicon · 24.3 MB · 1,177 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/AprilNEA/OpenLogi/releases/download/v0.9.0/OpenLogi-v0.9.0-macos-arm64.dmg"
open "OpenLogi-v0.9.0-macos-arm64.dmg"

Other macOS downloads (1)

OpenLogi-v0.9.0-macos-x86_64.dmg

dmg · Intel · 28.2 MB · 116 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/AprilNEA/OpenLogi/releases/download/v0.9.0/OpenLogi-v0.9.0-macos-x86_64.dmg"
open "OpenLogi-v0.9.0-macos-x86_64.dmg"

Install with a package manager

Homebrew

brew install --cask openlogi

install script

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

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 10 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Rust stableruntime

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/AprilNEA/OpenLogi/badge.svg)](https://gitmanual.com/AprilNEA/OpenLogi)

Good to know

Cargo workspace — pick a crate with cargo run -p <name>.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: crates/openlogi-agent-core/Cargo.toml, crates/openlogi-agent/Cargo.toml, crates/openlogi-assets/Cargo.toml, crates/openlogi-camera/Cargo.toml and 11 more

Files we read (10)

.github/workflows/build.yml

.github/workflows/ci.yml

.github/workflows/crowdin.yml

.github/workflows/devenv.yml

.github/workflows/nix.yml

.github/workflows/prerelease.yml

Cargo.toml

README.md

docs/DEVELOPMENT.md

rust-toolchain.toml

Branch master · 1,492 files in the repo

Reading the repo

Opening the box…

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Supported devices from the README: Devices

Logi Bolt and Unifying receivers, Bluetooth, and wired connections, with battery level and charge state
Low-battery notices at the bottom of the screen, once per discharge, with no OS notification permission
An on-screen indicator when a keyboard turns Caps Lock on or off, plus Num Lock and Scroll Lock on Windows and Linux