Initial commit: Incott mouse HID driver

Windows system tray utility for Incott wireless mice (Ghero, G23, G24,
G23V2, Zero 29, Zero 39). Supports DPI, polling rate, LOD, debounce,
sleep timer, motion sync, angle snapping, ripple control, receiver LED.
Includes auto-boost feature, autostart, two-level logging, and unit tests.

Author: romkazor

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.26'
+          cache: true
+
+      - name: Run tests
+        run: go test -v ./...
+
+      - name: Compile Windows resource (icon)
+        shell: pwsh
+        run: |
+          $windres = (Get-Command windres -ErrorAction SilentlyContinue).Source
+          if (-not $windres) {
+            $windres = "C:\msys64\mingw64\bin\windres.exe"
+          }
+          Push-Location icons
+          & $windres app.rc -o ../app_windows.syso
+          Pop-Location
+
+      - name: Build binary
+        env:
+          CGO_ENABLED: 1
+        run: go build -o IncottDriver.exe -ldflags="-H windowsgui -s -w" .
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: IncottDriver.exe
+          generate_release_notes: true
+          draft: false
+          prerelease: false

.gitignore

@@ -0,0 +1,6 @@
+IncottDriver.exe
+incott.log
+settings.json
+app_windows.syso
+docs/
+.claude/

CLAUDE.md

@@ -0,0 +1,121 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Windows system tray driver for **Incott** wireless mice (Ghero, G23, G24, G23V2, Zero 29, Zero 39). Communicates with the mouse over HID to control DPI, polling rate, LOD, debounce, sleep timer, motion sync, angle snapping, ripple control, and receiver LED mode. Provides an "auto-boost" feature that switches to 8000 Hz when any of the configured target processes is detected.
+
+- **Language**: Go
+- **Platform**: Windows only (uses `syscall`, `windows/registry`, PowerShell dialogs)
+- **Device IDs**: Vendor `0x093A`, Product `0x522C` (wireless) / `0x622C` (charging) — shared across all models
+- **Model detection**: via HID `Product` string from device firmware
+
+## Build & Run
+
+```bash
+go build -o IncottDriver.exe -ldflags="-H windowsgui" .
+./IncottDriver.exe
+```
+
+The `-H windowsgui` linker flag hides the console window. Omit it during development to see stdout output. Requires CGO — the `CC` environment variable should point to a modern MinGW-w64 GCC (TDM-GCC 10.x is incompatible with Go 1.26+).
+
+### Icons
+
+- **Tray icon**: `tray_icon.ico` — embedded via `go:embed`, generated from `mouse.png` (resized to 16/32/48/64px ICO)
+- **Exe icon**: `app.ico` — compiled into `app_windows.syso` via `windres app.rc`. The `.syso` file is auto-linked by Go.
+- **Source image**: `mouse.png` — original high-res image of the mouse
+
+To regenerate icons after changing `mouse.png`:
+```bash
+python -c "
+from PIL import Image
+img = Image.open('mouse.png').convert('RGBA')
+# Tray
+sizes = [16,32,48,64]
+icons = [img.resize((s,s), Image.LANCZOS) for s in sizes]
+icons[0].save('tray_icon.ico', format='ICO', sizes=[(s,s) for s in sizes], append_images=icons[1:])
+# Exe
+sizes = [16,32,48,64,128,256]
+icons = [img.resize((s,s), Image.LANCZOS) for s in sizes]
+icons[0].save('app.ico', format='ICO', sizes=[(s,s) for s in sizes], append_images=icons[1:])
+"
+windres app.rc -o app_windows.syso
+```
+
+## Project Structure
+
+| File | Responsibility |
+|---|---|
+| `main.go` | Entry point, tray icon via `go:embed tray_icon.ico`, `onExit` |
+| `config.go` | `AppConfig` struct, `loadConfig`/`saveConfig`, `setAutoStart` (registry), `promptForExe` (PowerShell dialog), `parseTargetApps`/`setTargetApps` (comma-separated app list) |
+| `logging.go` | `logInfo` (always writes), `logDebug` (only when debug enabled via `atomic.Bool`). Log file: `incott.log` |
+| `device.go` | HID constants, pre-allocated report buffers, all `apply*` functions, `mouseWorker`, `gameMonitorWorker`, `findRunningApp`, `isMouseDevice` (product name filter) |
+| `ui.go` | Menu structs (fixed arrays replacing maps), `onReady`, `refreshStatusText`, `updateCheckmarks`, click forwarding via goroutines |
+
+## Architecture
+
+Three concurrent components:
+
+1. **systray UI** (`onReady` in `ui.go`) — system tray menu with DPI, Hz, LOD, Debounce, Sleep presets, toggle checkboxes (Motion Sync, Angle Snapping, Ripple Control), Receiver LED submenu, auto-boost toggle, autostart, debug logging toggle. Each submenu group uses `forwardClicks()` which spawns one goroutine per menu item, reducing the main select to ~8 cases.
+2. **`mouseWorker`** (`device.go`) — reconnection loop. Enumerates HID devices by vendor/product ID, filters by `isMouseDevice(info.Product)` to avoid connecting to Incott keyboards sharing the same vendor ID. Opens UsagePage `0xFF05`. On connect, reads current settings (status via `0x89`, debounce via `0x85/0x01`, LOD + motion sync via `0x84`, angle snapping via `0x84/0x03`, ripple control via `0x84/0x02`, receiver LED via `0x88`, sleep via `0x85/0x03`). Device model name is read from HID `Product` field and shown in tray tooltip. Then enters a read loop for live status updates.
+3. **`gameMonitorWorker`** (`device.go`) — polls every 3s via a single `CreateToolhelp32Snapshot` call. Checks all target apps (`targetAppsLower`, comma-separated in config) in one pass over the process list. Auto-boosts to 8000 Hz when any target is found, restores on exit.
+
+### HID Protocol (feature reports)
+
+All reports are 9 bytes, report ID `0x09`. Read commands use the set command byte OR'd with `0x80`.
+
+| Action | Bytes |
+|---|---|
+| Request status | `09 89 00 00 00 00 00 00 00` |
+| Set polling rate | `09 01 <rate> 00 00 00 00 00 00` |
+| Set DPI | `09 03 06 <idx> 00 00 00 00 00` |
+| Set LOD | `09 04 01 <lod> 00 00 00 00 00` |
+| Set ripple control | `09 04 02 <0/1> 00 00 00 00 00` |
+| Set angle snapping | `09 04 03 <0/1> 00 00 00 00 00` |
+| Set motion sync | `09 04 04 <0/1> 00 00 00 00 00` |
+| Set debounce | `09 05 01 <ms> 00 00 00 00 00` |
+| Set sleep | `09 05 03 <lo> <hi> 00 00 00 00` |
+| Set receiver LED | `09 08 <mode> 00 00 00 00 00 00` |
+| Read LOD + motion sync | `09 84 00 ...` → LOD in upper nibble of byte[7], motion sync in lower nibble |
+| Read ripple control | `09 84 02 ...` → value in byte[3] |
+| Read angle snapping | `09 84 03 ...` → value in byte[3] |
+| Read debounce | `09 85 01 ...` → value in byte[3] |
+| Read sleep | `09 85 03 ...` → LE uint16 in bytes[3:5] |
+| Read receiver LED | `09 88 00 ...` → mode in byte[2] |
+
+Rate bytes: `0x00`=1000, `0x01`=500, `0x02`=250, `0x03`=125, `0x04`=8000, `0x05`=4000, `0x06`=2000.
+DPI indices: `0x00`=400, `0x01`=800, `0x02`=1600, `0x03`=2400, `0x04`=3200, `0x05`=6400.
+LOD bytes: `0x00`=1mm, `0x01`=2mm, `0x02`=0.7mm.
+Receiver LED modes: `0x00`=Connect & polling rate, `0x01`=Battery status, `0x02`=Battery warning.
+
+### Synchronization
+
+- `mu` (`sync.Mutex`) guards `activeDevice` and `sendBuf` — used by `mouseWorker` and all `apply*` calls.
+- `boostMu` (`sync.Mutex`) guards `currentHz`, `savedHz`, `autoBoostEnabled`, `targetApps`, `targetAppsLower`.
+
+### Logging
+
+- `logInfo(format, args...)` — always written to `incott.log`. For user actions and lifecycle events.
+- `logDebug(format, args...)` — only when `debugEnabled` (`atomic.Bool`) is true. For HID bytes, device reads, status updates.
+- Config field: `"debug"` in `settings.json`.
+
+### Persistence
+
+- **`settings.json`** — stores `target_game_exe` (comma-separated app list), `auto_boost`, `auto_start`, `debug`. Loaded on startup, saved on setting changes.
+- **Windows Registry** (`HKCU\Software\Microsoft\Windows\CurrentVersion\Run`) — autostart entry under key `IncottDriver`.
+
+### Performance Notes
+
+- Menu items use fixed-size arrays in structs instead of `map[int]*MenuItem`.
+- HID report buffers (`[9]byte`, `[64]byte`) are pre-allocated and reused.
+- `refreshStatusText` uses `strings.Builder` + `strconv.Itoa` (zero `fmt.Sprintf`).
+- `targetAppsLower` is pre-computed via `parseTargetApps`, avoiding repeated `strings.ToLower`.
+- `ProcessEntry32` is reused across `findRunningApp` calls.
+- `findRunningApp` takes a single process snapshot and checks all target apps in one pass.
+
+## Key Dependencies
+
+- `github.com/getlantern/systray` — system tray menu
+- `github.com/karalabe/hid` — HID access (requires CGO, uses native Windows API)
+- `golang.org/x/sys/windows/registry` — registry access for autostart

Makefile

@@ -0,0 +1,22 @@
+BINARY := IncottDriver.exe
+LDFLAGS := -H windowsgui
+
+.PHONY: all build test vet clean run
+
+all: build
+
+# Build depends on test — binary is only produced if tests pass
+build: test
+	go build -o $(BINARY) -ldflags="$(LDFLAGS)" .
+
+test:
+	go test -v ./...
+
+vet:
+	go vet ./...
+
+clean:
+	rm -f $(BINARY) incott.log
+
+run: build
+	./$(BINARY)

README.md

@@ -0,0 +1,154 @@
+# Incott Mouse Driver
+
+<p align="center">
+  <img src="icons/mouse.png" alt="Incott Mouse" width="120">
+</p>
+
+Lightweight Windows system tray utility for **Incott** wireless mice. Communicates directly with the mouse over HID — no vendor software required.
+
+## Features
+
+**Mouse Settings** (read from device on connect, applied instantly):
+- **DPI** — 400, 800, 1600, 2400, 3200, 6400
+- **Polling Rate** — 125, 250, 500, 1000, 2000, 4000, 8000 Hz
+- **LOD (Lift-Off Distance)** — 0.7 mm, 1 mm, 2 mm
+- **Debounce** — 0–30 ms
+- **Sleep Timer** — 10 sec to 15 min
+- **Motion Sync** — on/off
+- **Angle Snapping** — on/off
+- **Ripple Control** — on/off
+- **Receiver LED Mode** — Battery status / Connect & polling rate / Battery warning
+
+**Auto-Boost** — automatically switches polling rate to 8000 Hz when a target application is running, restores the previous value when it closes. Supports multiple apps (comma-separated, e.g. `cs2.exe, valorant.exe`).
+
+**Status Bar** — shows battery level, current DPI, polling rate, and other settings at the top of the tray menu.
+
+**Other:**
+- Start with Windows (autostart via registry)
+- Two-level logging (`incott.log`): INFO for user actions, DEBUG for HID protocol details
+
+## Download
+
+Grab the latest `IncottDriver.exe` from [Releases](../../releases) — no installation needed, just run it.
+
+Releases are built automatically by GitHub Actions on every `v*` tag push.
+
+## Releasing a new version (for maintainers)
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+The workflow at `.github/workflows/release.yml` runs tests, builds the Windows binary, and publishes it as a GitHub Release.
+
+## Building from Source
+
+### Prerequisites
+
+- [Go 1.26+](https://go.dev/dl/)
+- C compiler (CGO is required by the HID library)
+
+### Windows 11
+
+1. Install Go from https://go.dev/dl/
+
+2. Install MinGW-w64 (GCC):
+   ```powershell
+   winget install BrechtSanders.WinLibs.POSIX.UCRT
+   ```
+   > **Note:** TDM-GCC 10.x is incompatible with Go 1.26+. Use WinLibs GCC 15+ or MSYS2.
+
+3. Set the `CC` environment variable (if WinLibs is not first in PATH):
+   ```powershell
+   # Find the installed GCC path:
+   Get-ChildItem -Path "$env:LOCALAPPDATA\Microsoft\WinGet\Packages" -Filter "gcc.exe" -Recurse | Select -First 1
+
+   # Set it permanently for the current user:
+   [System.Environment]::SetEnvironmentVariable('CC', '<path-to-gcc.exe>', 'User')
+   ```
+
+4. Clone and build:
+   ```bash
+   git clone https://github.com/anthropics/MouseIncott.git
+   cd MouseIncott
+   ```
+
+   Build options:
+   - **With Make** (recommended, runs tests first):
+     ```bash
+     mingw32-make build
+     ```
+   - **With batch script**:
+     ```cmd
+     build.bat
+     ```
+   - **Direct go build** (skips tests):
+     ```bash
+     go build -o IncottDriver.exe -ldflags="-H windowsgui" .
+     ```
+
+5. (Optional) Rebuild the exe icon after changing `icons/mouse.png`:
+   ```bash
+   pip install Pillow
+   python -c "
+   from PIL import Image
+   img = Image.open('icons/mouse.png').convert('RGBA')
+   for name, sizes in [('icons/tray_icon.ico',[16,32,48,64]), ('icons/app.ico',[16,32,48,64,128,256])]:
+       icons = [img.resize((s,s), Image.LANCZOS) for s in sizes]
+       icons[0].save(name, format='ICO', sizes=[(s,s) for s in sizes], append_images=icons[1:])
+   "
+   windres icons/app.rc -o app_windows.syso
+   go build -o IncottDriver.exe -ldflags="-H windowsgui" .
+   ```
+
+### Docker (cross-compile)
+
+Build the Windows exe from any OS using Docker:
+
+```bash
+docker run --rm -v "$(pwd):/src" -w /src \
+  x1unix/go-mingw:1.24 \
+  go build -o IncottDriver.exe -ldflags="-H windowsgui" .
+```
+
+> The `x1unix/go-mingw` image includes Go + MinGW-w64 cross-compiler for Windows. The resulting exe will not have the embedded Windows icon (`app_windows.syso` must be compiled with `windres` on Windows).
+
+## Configuration
+
+Settings are stored in `settings.json` (created automatically on first run):
+
+```json
+{
+  "target_game_exe": "cs2.exe, valorant.exe",
+  "auto_boost": true,
+  "auto_start": false,
+  "debug": false
+}
+```
+
+| Field | Description |
+|---|---|
+| `target_game_exe` | Comma-separated list of processes to monitor for auto-boost |
+| `auto_boost` | Enable automatic 8000 Hz when target app is detected |
+| `auto_start` | Launch on Windows startup |
+| `debug` | Write detailed HID protocol data to `incott.log` |
+
+## Supported Devices
+
+All Incott mice sharing the same chipset (Vendor ID `0x093A`) are supported:
+
+| Model | Product ID | Status |
+|---|---|---|
+| Ghero | `0x522C` / `0x622C` | Supported |
+| G23 | `0x522C` / `0x622C` | Supported |
+| G24 | `0x522C` / `0x622C` | Supported |
+| G23V2 | `0x522C` / `0x622C` | Supported |
+| Zero 29 | `0x522C` / `0x622C` | Supported |
+| Zero 39 | `0x522C` / `0x622C` | Supported |
+
+`0x522C` — wireless mode, `0x622C` — charging mode. The device model is detected automatically from the HID product name. Incott keyboards sharing the same vendor ID are automatically filtered out.
+
+## License
+
+MIT

build.bat

@@ -0,0 +1,16 @@
+@echo off
+echo Running tests...
+go test ./...
+if errorlevel 1 (
+    echo.
+    echo Tests FAILED. Build aborted.
+    exit /b 1
+)
+echo.
+echo Tests passed. Building binary...
+go build -o IncottDriver.exe -ldflags="-H windowsgui" .
+if errorlevel 1 (
+    echo Build FAILED.
+    exit /b 1
+)
+echo Build successful: IncottDriver.exe