HID++ agent · Windows & macOS

Your mouse, without the bloat

GFlick talks to your Logitech mouse directly over HID++. It sets DPI, report rate, lighting, and onboard profiles, then gets out of the way - one background process holding 7.58 MiB.

DownloadRead the source

Windows and Apple Silicon macOS · Unsigned prerelease · MIT licensed

gflick-agentattached
  1. 00:00.000rx11 01 09 00 3f 00 00battery
Resident
7.58 MiB
CPU, one core
0.105 %
Processes
1

Report traffic is illustrative. Idle figures are measured - see idle cost.

Hardware validated

Three mice, tested on real firmware

Support is capability-driven: a control appears only when the mouse advertises the matching HID++ feature. Anything not validated on the bench is not listed here.

  • Logitech G

    PRO X Superlight

    Sensor

    0x2201

    Max rate

    1 kHz

    Profile format

    0x04

    Notes

    Live flash write proven

  • Logitech G

    PRO X Superlight 2

    Sensor

    0x2202

    Max rate

    8 kHz

    Profile format

    0x07

    Notes

    X/Y DPI, lift-off distance

  • Logitech G

    G305

    Sensor

    0x2201

    Max rate

    1 kHz

    Profile format

    0x03

    Notes

    One public RGB zone

Full feature matrix, including what is excluded on purpose

What it controls

Settings, not a suite

Every write is validated, sent, then read back from the device. Host macros, onboard macro recording, and per-application profiles are out of scope on purpose.

Sensor

0x2201 / 0x2202
  • DPI across the full supported range
  • Separate X and Y DPI where the sensor allows it
  • Lift-off distance
  • DPI stages, plus the active and shift stage

Report rate

0x8060 / 0x8061
  • Wired polling rate
  • Wireless polling rate up to 8 kHz
  • Separate wired and wireless rates when the mouse keeps two
  • Performance and endurance mode

Power

0x1000 / 0x1001
  • Battery percentage and charge state
  • Sleep and power-off timers
  • Firmware, model, and unit identity

Lighting

0x8070
  • Fixed colour, cycling, and breathing effects
  • Effect-aware read-back on every write
  • Firmware LED ownership handed back on exit

Onboard profiles

0x8100 / 0x8110
  • Read, decode, and select stored profiles
  • Button assignments, names, and power timers
  • Enable or disable profiles in the directory
  • Host or onboard mode without erasing storage

Write safety

Core guarantee
  • Unknown sector bytes preserved byte for byte
  • HID++ CRC regenerated and verified on read-back
  • Automatic rollback when verification fails
  • Flash writes need an explicit acknowledgement

Measured August 3, 2026

What it costs to leave running

A 30-minute idle recording of OS process counters -900 samples at two-second intervals, on Windows 10 Pro with a Ryzen 7 5700X.

MetricGFlickG HUB stackReduction
Resident memory, mean7.58 MiB227.55 MiB96.7%
CPU, one-core basis0.105%0.385%72.8%
Accumulated CPU time1,890 ms6,937 ms72.8%
CPU sample maximum1.60%10.91%85.3%
Read I/O, total24 KB20.1 MB99.9%
Resident processes13—

These are the Windows figures. Both stacks were resident and both recorders sampled concurrently for about 26 minutes, so this is a co-resident comparison rather than an isolated sequential A/B test, and a preliminary result rather than a power-draw claim. The Apple Silicon run went differently: far less memory and I/O, but slightly more CPU than G Hub.

Both platforms in full

Getting it running

A hash check, then one command

Installation is transactional: a failed step rolls back rather than leaving half a tree behind. Uninstalling keeps your settings unless you ask it not to.

  1. 01

    Verify the archive

    Nothing is code-signed yet, so compare the hash against SHA256SUMS before extracting.

    Windows PowerShell
    (Get-FileHash .\gflick-<version>-windows-x86_64.zip -Algorithm SHA256).Hash.ToLower()
  2. 02

    Run the installer

    No Rust toolchain and no compiler. Installs per user, and never asks for administrator rights.

    Both platforms
    gflick-setup install
  3. 03

    Confirm it came up

    Reports what is installed and whether the agent is running. Repair fixes anything missing.

    Check
    gflick-setup status
Full setup guide

Components, installed paths, repair, and uninstall

Install it, or read every line first

No account, no telemetry, and no background updater. Every setting it writes is validated and read back from the device, and the whole thing is MIT licensed.

Choose a downloadBrowse the code