# What Are the System Requirements for OpenLogi? A Complete Platform Guide

> Discover OpenLogi system requirements. Ensure compatibility with macOS 13+, Windows 11, or Linux (glibc 2.35+). Supports Logitech HID++ devices seamlessly.

- Repository: [Xuan Zhang/OpenLogi](https://github.com/AprilNEA/OpenLogi)
- Tags: getting-started
- Published: 2026-08-29

---

**OpenLogi requires macOS 13 Ventura or later, Windows 11, or Linux with glibc 2.35+, and supports Logitech HID++ devices without additional runtime dependencies on macOS or Windows.**

OpenLogi is a native, local-first alternative to Logitech Options+ that runs entirely on your machine without cloud dependencies. Understanding the system requirements for OpenLogi ensures compatibility with your Logitech peripherals across macOS, Linux, and Windows environments. The application is distributed as signed binaries for all three platforms, with specific minimum OS versions and hardware support tiers defined in the project repository.

## macOS System Requirements

OpenLogi supports **macOS 13 (Ventura) or later** according to [`README.md`](https://github.com/AprilNEA/OpenLogi/blob/main/README.md). The application is fully signed and notarized by Apple, meaning no additional runtime libraries or dependencies are required beyond the standard macOS environment.

Any Logitech HID++ mouse, keyboard, or webcam that macOS can enumerate through standard HID interfaces will work with OpenLogi. The macOS agent implementation uses `CGEventTap` for input capture and `CoreGraphics` for injection, as implemented in the platform-specific agent code.

## Linux System Requirements

Linux systems must run **glibc 2.35** or later, which corresponds to the Ubuntu 22.04 baseline. The project provides packages for both **x86_64/amd64** and **arm64/aarch64** architectures.

### Runtime Dependencies and Permissions

The Linux installation requires specific device access permissions handled through udev rules. According to [`docs/INSTALL-linux.md`](https://github.com/AprilNEA/OpenLogi/blob/main/docs/INSTALL-linux.md), the installer configures access to `/dev/hidraw*`, `/dev/uinput`, and `/dev/input/event*` without requiring `sudo` privileges. The agent uses **evdev** and **uinput** for capture and injection, while media key actions rely on D-Bus MPRIS.

A systemd user service (`openlogi-agent.service`) starts automatically after installation, as documented in [`README.md`](https://github.com/AprilNEA/OpenLogi/blob/main/README.md). The [`crates/openlogi-permissions/src/linux.rs`](https://github.com/AprilNEA/OpenLogi/blob/main/crates/openlogi-permissions/src/linux.rs) file contains the permission probing logic for these device nodes.

### Graphics Library Requirements

The `packaging/linux/package.nix` file declares additional dependencies including the Vulkan loader required for GPUI, the framework used for the cross-platform GUI.

## Windows System Requirements

OpenLogi requires **Windows 11** validated on the latest builds. The installer ships both a signed portable `.zip` archive and a per-user `.msi` package containing the GUI (`OpenLogi.exe`) and the background agent (`openlogi-agent.exe`).

No extra runtime dependencies are needed on Windows. The agent creates a system tray icon and uses `WH_MOUSE_LL` for low-level mouse hooking and `SendInput` for injection. Users can hide the GUI from the menu bar by setting `show_in_menu_bar = false` in the configuration file.

## Hardware Compatibility

OpenLogi supports any Logitech HID++ device including those connected via Logi Bolt, Unifying receiver, Bluetooth, or wired connections. The background agent handles all HID++ communication independently of the GUI, ensuring consistent device support across all three platforms.

Some macOS-specific actions become no-ops on Linux due to platform limitations, while media keys on Linux use the D-Bus MPRIS standard instead of proprietary APIs.

## Verifying Your System Meets Requirements

Use the following commands to confirm your system satisfies the prerequisites before installing OpenLogi.

### Check macOS Version

```bash
sw_vers -productVersion

```

The output must show `13.x` or newer.

### Check Linux glibc Version

```bash
ldd --version

```

Look for glibc 2.35 or later in the output.

### Check Windows Version

```powershell
[System.Environment]::OSVersion.Version

```

The major version should be 10 with build number greater than or equal to 22000.

### Verify Binary Compatibility

```bash
openlogi --version

```

If this command prints the version string without errors, the binary was compiled for your platform and all runtime libraries are present.

## Development Dependencies

Building OpenLogi from source requires additional system libraries beyond the runtime requirements. The [`docs/DEVELOPMENT.md`](https://github.com/AprilNEA/OpenLogi/blob/main/docs/DEVELOPMENT.md) file lists development-time dependencies including `libudev`, `x11`, and `wayland` libraries for Linux. These are only necessary when compiling the Rust source code, not when running the pre-built releases.

## Summary

- **macOS**: Requires version 13 (Ventura) or later; signed and notarized with no additional runtime dependencies
- **Linux**: Requires glibc 2.35+ (Ubuntu 22.04+ baseline), supports x86_64 and arm64, requires udev rules for `/dev/hidraw*` and `/dev/uinput` access
- **Windows**: Requires Windows 11 (build 22000+), ships as signed portable `.zip` or per-user `.msi` installer
- **Hardware**: Compatible with all Logitech HID++ devices (Bolt, Unifying, Bluetooth, wired)
- **Architecture**: Agent-based design with platform-specific low-level libraries (`CGEventTap`, `evdev`/`uinput`, `WH_MOUSE_LL`)

## Frequently Asked Questions

### Does OpenLogi work on macOS 12 Monterey?

No. According to the repository [`README.md`](https://github.com/AprilNEA/OpenLogi/blob/main/README.md), OpenLogi requires macOS 13 Ventura or later. The application relies on modern APIs for proper HID++ device communication and input injection that are only available in Ventura and subsequent releases.

### Can I run OpenLogi on Linux distributions older than Ubuntu 22.04?

Only if your distribution provides glibc 2.35 or newer. Run `ldd --version` to check your current glibc version. Older distributions may require upgrading or building from source with modified dependencies, though the `packaging/linux/package.nix` file specifically targets the 2.35 baseline for binary compatibility.

### Why does the Linux version need udev rules?

The OpenLogi agent requires direct access to raw HID devices (`/dev/hidraw*`), virtual input devices (`/dev/uinput`), and event interfaces (`/dev/input/event*`) to capture and inject input events. The [`crates/openlogi-permissions/src/linux.rs`](https://github.com/AprilNEA/OpenLogi/blob/main/crates/openlogi-permissions/src/linux.rs) source file implements the permission probing that allows the agent to function without root privileges once the udev rules are installed by the package manager.

### Is Windows 10 supported?

No. OpenLogi is validated only on Windows 11 with the latest builds. While some functionality might work on Windows 10, the [`README.md`](https://github.com/AprilNEA/OpenLogi/blob/main/README.md) specifically lists Windows 11 as the minimum supported version, and certain input hooking mechanisms may behave differently on older Windows releases.