MousePlotter

Records raw mouse input and plots it, for checking polling rate, jitter, and sensor quality. Inspired by MouseTester.

• public/ - the web app, hosted at mouseplotter.xbabtech.com. Record mouse reports in-browser or import a CSV to plot and analyze a session. To serve locally with high timer resolution in-browser recording, run python3 serve.py (sets the COOP/COEP headers needed for high-resolution timers).

  OS/Browser combos that work well for in-browser recording:

  • Linux: Chromium-based browsers.
  • Windows: Chromium-based browsers.
  • macOS: Safari gives mostly uncoalesced data, though with significant jitter. Other browsers coalesce data.

• linux_cli/ - Linux command-line logger. Records un-coalesced mouse reports via evdev/raw input, then saves a CSV or a self-contained HTML report that opens in the browser with the capture already plotted. Build with make (produces mouseplotter; needs Python 3, which builds the report template from public/). For a portable binary to distribute, use make release (needs Zig as a C toolchain).

• windows_gui/ - Windows GUI logger, same recording logic and save options as the CLI. Click with the mouse you want to test to pick it, so that a second pointing device cannot mix into the capture. It asks for administrator rights at launch, and with them opens a real-time Event Tracing for Windows session. It identifies the selected mouse's USB endpoint and pairs its completions with Raw Input in report order. Where supported, controller and interrupter IDs associate the completion with an earlier interrupt event, reducing timestamp jitter from deferred driver work. The CSV includes eventTime, userTime, and a per-row timestampSource; ambiguous samples keep their Raw Input time. Interrupt moderation can batch reports, so shared interrupt times do not resolve their individual USB arrival times. Without administrator rights or a usable USB trace, it saves a 3-column Raw Input CSV. Recording stops on focus loss or device removal. Build with build.bat (needs Zig as a C toolchain and Python 3) or make, producing MousePlotter.exe. Run the offline Windows regression tests with build.bat test (Zig only, no elevation).

License

Root LICENSE (AGPL-3.0) covers public/. linux_cli/ and windows_gui/ each carry their own LICENSE (MIT), which takes precedence for those directories.

---

Made by XBAB Tech.