Windows
Your systemWindows 10 or 11, x86_64
gflick-0.1.0-windows-x86_64.zip(Get-FileHash .\gflick-0.1.0-windows-x86_64.zip -Algorithm SHA256).Hash.ToLower()Unsigned prereleases
Every release publishes a user bundle and a devtools bundle per platform, plus a SHA256SUMS file. Unless you are diagnosing hardware or measuring resource usage, you want the user bundle and nothing else.
Version 0.1.0 · All releases and changelogs
Windows 10 or 11, x86_64
gflick-0.1.0-windows-x86_64.zip(Get-FileHash .\gflick-0.1.0-windows-x86_64.zip -Algorithm SHA256).Hash.ToLower()Apple Silicon only - Intel is unsupported
gflick-0.1.0-macos-aarch64.tar.gzshasum -a 256 gflick-0.1.0-macos-aarch64.tar.gzEveryone
This is the one to download. It never opens HID directly except through the agent.
Development and hardware diagnosis
Probe talks to HID directly and must not run while the agent is running - they compete for the same interface.
Intel macOS is outside the support and test matrix, so the installer refuses it rather than installing something that would fail later.
| Platform | Target | Status |
|---|---|---|
| Windows | Windows 10 or 11, x86-64 | Supported |
| macOS | Apple Silicon (aarch64) | Supported |
| macOS | Intel (x86-64) | Rejected by the installer |
| Linux | Any | Not built |
Building from source avoids the unsigned-binary warnings entirely. It needs Rust stable - the workspace declares 1.85 as its minimum - plus Visual Studio Build Tools with Desktop development with C++ and a Windows SDK, or the Xcode Command Line Tools on macOS.
git clone https://github.com/R4ULtv/gflickcargo build --release --workspacecargo run -p gflick-agentNothing published here is code-signed or notarised, so Windows SmartScreen and macOS Gatekeeper will both warn about an unidentified developer. That warning is expected, which is exactly why the hash check matters: download SHA256SUMS alongside the archive and compare the two before extracting anything.
The per-platform verification command is on the card for your platform above, and the step-by-step install flow is on the setup page.
The default install registers the agent and the tray. The agent discovers devices, keeps each mouse session owned by one thread, refreshes battery state, persists your preferences, and serves protocol version 1 over an OS-local socket. The tray subscribes to those events and sleeps between changes rather than polling.
A graphical settings application is the intended primary interface and is not shipping yet. Until it does, control happens through the gflick CLI. Component selection, installed paths, and uninstall behaviour are covered in the setup README .