OpenLogi

DPI presets

Set pointer resolution and manage an ordered DPI preset list for a supported mouse.

Set the active DPI and maintain an ordered preset list in the Pointer tab. OpenLogi reads HID++ 0x2201 adjustableDpi or 0x2202 extendedAdjustableDpi.

From the GUI

Select a mouse, then open Pointer. The DPI controls use values reported by the selected device:

MX Master 4 Pointer tab with DPI and SmartShift cards

Pointer tab: DPI on the left, SmartShift on the right.
  • DPI shows the current value. When the device reports several values, the slider spans its lowest and highest values. Its displayed step is the smallest gap between adjacent values. Dragging previews a value. Releasing the slider writes the nearest supported value.
  • A mouse with one supported value shows Fixed DPI instead of a slider.
  • Presets contains clickable DPI values. Clicking a value normalizes it to the device grid, then writes it. The first value matching the current DPI is active.
  • Add appends the current DPI. The remove button deletes its preset by position. Duplicate values remain valid because each position can be a separate cycle stop.

While the capability read is pending, the panel shows reading states. An offline mouse reports that DPI is unavailable. A failed read provides Couldn't read DPI. Click to retry. A mouse without adjustable DPI reports This device does not report adjustable DPI support.

Since v0.8.12, the editor seeds its value from saved dpi while its live read is pending. The device's live value replaces that seed when the read completes. Other Pointer controls use their own capability checks, so Report rate can appear without adjustable DPI.

Sensor echo validation

Since v0.8.14, OpenLogi rejects a 0x2201 supported-DPI reply when its sensor echo differs from the requested sensor. This prevents another sensor's list from becoming the selected list.

Preset actions

A hardware button can use either action:

  • CycleDpiPresets advances through dpi_presets in order and wraps after the last entry.
  • SetDpiPreset selects a zero-based preset position. It has an argument, so it is not available in the GUI action picker. Add it by editing Configuration.

When you replace the preset list, OpenLogi resets the cycle position to its first entry. The list order is therefore the cycle order.

In the config

OpenLogi stores the active value and preset list under the physical device key:

schema_version = 9

[devices."receiver:aabbccdd:slot:1"]
dpi = 1600
dpi_presets = [800, 1600, 3200]

The mouse holds DPI in volatile memory. OpenLogi saves dpi and re-applies it when the device reconnects. See Configuration for the full action syntax and Per-app profiles for per-app button bindings.

Status: macOS, Linux, and Windows, for devices that expose adjustable DPI. See 0x2201 adjustableDpi for the protocol detail.

On this page