# OpenLogi

Local-first, open-source customization for supported Logitech mice, keyboards, webcams and Litra lights.

> This is the Markdown version of the OpenLogi page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/openlogi>

- **Latest version**: `0.9.0`
- **Developer**: AprilNEA and OpenLogi contributors
- **Homepage**: <https://openlogi.org/>
- **Categories**: [Utilities](https://opennavo.com/categories/utilities)
- **Install**: `brew install --cask openlogi`
- **30-day installs**: 3,256
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://updates.openlogi.org/releases/v0.9.0/OpenLogi-v0.9.0-macos-arm64.dmg>
- **SHA-256**: `308b676d94be48c8a55f4953cd81699945d0d8740da06881d986a9f289837012`
- **Commands**: openlogi

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "launchctl": "org.openlogi.agent.service",
          "quit": [
            "org.openlogi.agent",
            "org.openlogi.openlogi",
            "org.openlogi.overlay"
          ]
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "OpenLogi.app"
      ],
      "target": "/Applications/OpenLogi.app"
    },
    "phase": "install",
    "sources": [
      "OpenLogi.app"
    ],
    "target": "/Applications/OpenLogi.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/OpenLogi.app/Contents/MacOS/openlogi"
      ],
      "target": "$HOMEBREW_PREFIX/bin/openlogi"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/OpenLogi.app/Contents/MacOS/openlogi"
    ],
    "target": "$HOMEBREW_PREFIX/bin/openlogi",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.config/openlogi",
            "~/.local/share/openlogi",
            "~/Library/Caches/org.openlogi.openlogi",
            "~/Library/Preferences/org.openlogi.openlogi.plist",
            "~/Library/Preferences/org.openlogi.overlay.plist",
            "~/Library/Saved Application State/org.openlogi.openlogi.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

OpenLogi is a native, local-first alternative to Logitech Options+ for supported Logitech mice, keyboards, webcams and Litra lights. It is intended for people who want device customization through an open-source desktop interface and command-line tools. The project is actively developed and not yet stable; features and configuration can change.

### Main features
- Customize supported mouse buttons, short/long presses, keyboard shortcuts and directional gestures.
- Configure DPI presets, SmartShift wheel behavior and native scroll inversion on devices exposing the required HID++ features.
- Open an eight-slot Actions Ring and use per-application profiles where the platform supports focus detection.
- Remap supported keyboard F-keys and configure static RGB lighting on compatible keyboards.
- Preview supported Logitech UVC webcams and adjust hardware image controls and camera profiles.
- Control supported Litra lights, including brightness, color temperature and optional power following camera activity.

Device support is capability-dependent: a listed feature is not a promise that every Logitech product supports it. Connections can use Logi Bolt or Unifying receivers, Bluetooth or a wired link. The GUI is accompanied by a CLI and a plain-text TOML configuration.

### Install and use on macOS
Install with `brew install --cask openlogi`, or download the official signed and notarized DMG, then drag OpenLogi.app into Applications. Quit Logi Options+ before using OpenLogi: the applications compete for HID++ access and only one can own a given receiver at a time. Connect a supported device, open OpenLogi and configure its available controls. Enable macOS Accessibility access when prompted for input remapping. Review the official usage and configuration guides for CLI commands and TOML settings.

The alternative upstream `openlogi@latest` cask tracks GitHub releases; install either it or the official `openlogi` cask, not both.

### Requirements and platform support
The Mac application requires macOS 13 or later and has separate Apple Silicon and Intel downloads. The current Homebrew cask declares the macOS requirement but no additional formula dependency or explicit cask conflict; this does not remove the documented Options+ receiver contention.

The project also provides Linux x86-64/ARM64 packages and Windows x86-64/ARM64 portable ZIPs and MSI installers. Linux prebuilt packages require GLIBC 2.35 or newer and device-access permissions; the official installation guide covers udev rules and the agent service. Linux application profiles are limited to X11/XWayland. Windows has been tested on Windows 11, but the upstream README does not establish a universal minimum for all Windows releases. Features and platform actions differ by operating system. Exact RAM and installed-space requirements were not established.

The official 0.8.11 Apple Silicon DMG is 19,305,422 bytes; this is download size rather than installed disk use.

### Accounts, cost and license
OpenLogi is a local-first, free open-source project; normal local device customization does not require an OpenLogi cloud account or subscription. Source code is dual-licensed under MIT or Apache 2.0 at your option. Logo and brand assets have separate rights and are not covered by those source-code licenses. OpenLogi is not affiliated with Logitech.

The accompanying official website image shows the macOS-style MX Master 4 button configuration interface and visibly identifies version 0.7.1; it is a historical example, not a screenshot of 0.8.11.

Sources: [Official README](https://github.com/AprilNEA/OpenLogi), [Usage guide](https://github.com/AprilNEA/OpenLogi/blob/master/docs/USAGE.md), [Configuration guide](https://github.com/AprilNEA/OpenLogi/blob/master/docs/CONFIGURATION.md), [Official 0.8.11 release](https://github.com/AprilNEA/OpenLogi/releases/tag/v0.8.11), [Website](https://openlogi.org/).

## System requirements

- macOS 13 or later · Version: 0.9.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · Checked 2026-11-21
  - <https://updates.openlogi.org/releases/v0.9.0/OpenLogi-v0.9.0-macos-x86_64.dmg>
  - SHA-256: `49b5e36e1d3c6887f2b9568646714fc5a64d99adf4ae370e734ad6880eb3ec19`
- macOS 13 or later · Version: 0.9.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · Checked 2026-11-21
  - <https://updates.openlogi.org/releases/v0.9.0/OpenLogi-v0.9.0-macos-arm64.dmg>
  - SHA-256: `308b676d94be48c8a55f4953cd81699945d0d8740da06881d986a9f289837012`

## OpenLogi security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/AprilNEA/OpenLogi> · Open source: Yes — <https://github.com/AprilNEA/OpenLogi> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask openlogi`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Background services (launchctl): `org.openlogi.agent.service` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask openlogi`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.config/openlogi` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/.local/share/openlogi` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/org.openlogi.openlogi` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/org.openlogi.openlogi.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/org.openlogi.overlay.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/org.openlogi.openlogi.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.9.1-beta.144 (2026-11-13)

#### What's Changed
* refactor(gui): migrate to upstream gpui-kit by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2229
* ci(release): approve a release once, before it builds by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2329
* fix(device): report a 0x1000 battery without mileage as a level by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2333
* fix(overlay): let go of the display on windows while nothing shows by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2339
* fix(inject): keep quotes in Windows Run Command by @amys94fr in https://github.com/AprilNEA/OpenLogi/pull/2337
* fix(desktop): name OpenLogi Agent in the Input Monitoring row while it is denied by @semmelrinde in https://github.com/AprilNEA/OpenLogi/pull/2113
* fix(gui): name every window before its first wayland commit by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2344
* fix(device): hear host keys from the moment they are armed by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2348
* fix(gui): consume the settings view on the macOS permissions page by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2354
* fix(device): switch hosts when a diverted Easy-Switch key is released by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2355
* fix(inject): post windows modifiers and fixed keys with their scan code by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2350
* fix(permissions): skip event nodes udev does not classify as a mouse by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2368
* docs(core): document schema v11 and the flow section by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2370
* feat(core): add the G903 LIGHTSPEED gaming layout by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2186
* feat(keyboard): bind G-series G-keys and M profiles over 0x8010 by @jiliu88 in https://github.com/AprilNEA/OpenLogi/pull/1239
* feat(gui): name G-key profiles from the M-key cards by @jiliu88 in https://github.com/AprilNEA/OpenLogi/pull/1240
* fix(core): match the purple g502 lightspeed to its gaming layout by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2373
* fix(fixture,hid): drop unsolicited hid++ input from cassette captures by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2377
* fix(core): match the pink g502 lightspeed to its gaming layout by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2378
* fix(gui): draw the base model for a colour variant whose renders are not images by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2379
* fix(hid): keep the linux kernel's hid++ software id out of the lease pool by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2380
* fix(device): resend 0x8081 requests a keyboard answers Busy by @capelo0 in https://github.com/AprilNEA/OpenLogi/pull/2382
* feat(cli): add diag zones to map a keyboard's per-key zones by @capelo0 in https://github.com/AprilNEA/OpenLogi/pull/2384
* fix(inject): post wheel events as zooms while the macOS zoom modifier is held by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2385
* fix(agent): keep another mouse's click native once the selected one diverts it by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2387
* fix(gui): keep scrollbars drawn when the platform asks for them by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2389
* fix(device): treat a dpi read rejected with invalid argument as unsupported by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2391
* fix(gui): name a g512 that shares the g513 asset depot by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2403
* test(fixtures): add wired G512 capture and corpus expectations by @mynameistito in https://github.com/AprilNEA/OpenLogi/pull/2404
* feat(gui): edit linked Easy-Switch devices from the Device tab by @Logiquo in https://github.com/AprilNEA/OpenLogi/pull/2043
* fix(cli): say the input monitoring note only on macos by @Jiibben in https://github.com/AprilNEA/OpenLogi/pull/2406
* fix(gui): select the G512 photo and matching key metadata by @mynameistito in https://github.com/AprilNEA/OpenLogi/pull/2405
* test(device): widen the receiver budget in the bolt codename tests by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2415
* fix(inject): leave modifiers already down out of tapped chords by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2416
* fix(inject): leave modifiers already down out of windows held chords by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2418
* fix(hidpp): decode chunked device names as a whole by @Zekuath in https://github.com/AprilNEA/OpenLogi/pull/2184
* fix(flow): name the clippy lints the generated proto code needs by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2424
* ci: move pull request workflows to namespace runners by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2419
* feat(cli): call a HID++ 2.0 feature with raw parameters by @capelo0 in https://github.com/AprilNEA/OpenLogi/pull/2426
* fix(agent): announce dpi button writes so the gui re-reads the dpi by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2427
* fix(hid): recognise the mx revolution's nano receiver 046d:c51a by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2431
* fix(device): settle a direct hid++ 1.0 answer instead of retiring its channel by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2433
* fix(agent): scroll a push right after a momentum catch instead of swallowing it by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2437
* fix(inject): post the phased thumb-wheel gesture as pixels on macos by @0xMarcio in https://github.com/AprilNEA/OpenLogi/pull/2440
* docs: restructure README acknowledgments and add Namespace CI badge by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2441
* fix(device): give a slow unifying device's first-sight walk time to finish by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2445
* fix(device): look up litra route locks under a std mutex by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2447
* fix(gui): apply the ui audit fixes to controls, toggles, and the overlay by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2448
* fix(gui): read webp render sizes for the side and main views by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2463
* fix(linux): run the nix package tests in the dev profile by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2462
* ci: keep the linux compile jobs' cargo state on namespace cache volumes by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2428
* fix(gui): decode a keyboard render by its bytes for the computed glow by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2467
* ci: build the aarch64 nix package on apple silicon by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2458
* refactor(device): fold channel eviction and replacement into one node state by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2472
* refactor(agent): derive the published pairing phase from the session owner by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2475
* refactor(hook): give the macos tap lifecycle one owner by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2476
* refactor(hid): type the native recorder lifecycle as one state enum by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2468
* refactor(device): type the G-key row's ownership as one state by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2469
* refactor(agent): re-type the forced re-apply latch as one enum by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2470
* refactor(agent): track each hook button's press as one explicit phase by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2471
* refactor(hidpp): give each correlation key one lifecycle owner by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2473
* refactor(gui): type the standalone light write lifecycle as one enum by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2474
* refactor(gui): type the mouse binding editor's mode as one enum by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2477
* refactor(flow): type the pairing attempt as an explicit stage by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2478
* refactor(gui): type the disable keys write lifecycle by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2479
* feat(device): divert the Gestures2 thumb wheel without 0x2150 by @mateuszkulapl in https://github.com/AprilNEA/OpenLogi/pull/2038
* refactor(device): type the lock-key read state as one enum by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2480
* refactor(hook): type the linux frontmost observer lifecycle as explicit state by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2481
* refactor(gui): type device liveness and the miss grace as one presence by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2482
* fix(hid): recognise the g613's lightspeed receiver 046d:c53d by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2485
* fix(linux): switch workspaces with cosmic's super+ctrl chord by @raulpineda in https://github.com/AprilNEA/OpenLogi/pull/2486
* fix(linux): press kwin's ctrl+meta chord when the desktop-switch call fails by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2488
* feat(gui): guide the agent's macOS grants with a drag panel by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2492
* fix(gui): forget a dropped device's disable-keys snapshot with its card by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2491
* feat(binding): add HoldModifier for bare-modifier holds by @liuslouis in https://github.com/AprilNEA/OpenLogi/pull/1363
* feat(core): accept keypad keys in custom shortcuts by @4ni1ak in https://github.com/AprilNEA/OpenLogi/pull/1963
* docs(macos): point the permission guidance at the drag guide by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2493
* test(hidpp): wait for the message listener before asserting on it by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2503
* test(gui): keep the Buttons inspector inside a window with a long profile strip by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2507
* ci: build the installers on namespace runners by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2504
* feat(tray): turn the macOS menu-bar menu into a control center by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2455
* ci: run the release workflows on namespace runners by @AprilNEA in https://github.com/AprilNEA/OpenLogi/pull/2510
* feat: software-initiated easy-switch host switching by @BrianGilbert in https://github.com/AprilNEA/OpenLogi/pull/2068

#### New Contributors
* @amys94fr made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2337
* @jiliu88 made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/1239
* @capelo0 made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2382
* @mynameistito made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2404
* @Logiquo made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2043
* @Jiibben made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2406
* @Zekuath made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2184
* @0xMarcio made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2440
* @mateuszkulapl made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2038
* @raulpineda made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2486
* @liuslouis made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/1363
* @BrianGilbert made their first contribution in https://github.com/AprilNEA/OpenLogi/pull/2068

**Full Changelog**: https://github.com/AprilNEA/OpenLogi/compare/v0.9.0...v0.9.1-beta.144

## Facts and sources

- <https://opennavo.com/apps/openlogi>
- <https://opennavo.com/apps/openlogi/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openlogi.rb> · Checked 2026-11-21
- <https://formulae.brew.sh/cask/openlogi>
- <https://github.com/AprilNEA/OpenLogi> · Checked 2026-11-13
