---

---

See it in action

Getting started (players)

No Node, no build tools, no certificates — three steps:

1. Check your phone — open the start page on your Android phone; it tells you on the spot whether WebXR AR is supported (and how to fix it if not).
2. Run point-bang on the PC — download the single executable for Windows, Linux or macOS (Apple Silicon or Intel) from Releases and run it. It prints a QR code. (Windows: accept the firewall prompt for private networks. macOS: make the download executable, clear its quarantine and grant Accessibility — the guide has the two commands.)
3. Scan, allow, play — scan the QR with the phone, tap Allow on Chrome's one-time local-network prompt, calibrate on your three screen corners, and the PC cursor follows your aim. Aim data flows over a WebRTC DataChannel directly across your WiFi.

Then set up an actual game — the game guides → walk through Time Crisis in DuckStation. Prefer a cable? The USB flow has the lowest jitter of all and charges the phone while you play.

Alternatively, you can skip setting up a game and just move the PC cursor around with your phone to test the aim.

Getting started (developers)

Requires Node ≥ 23.6 (TypeScript runs natively via type stripping — no build step anywhere in the dev loop):

git clone https://github.com/ggcaponetto/point-bang.git
cd point-bang
npm install
npm run start:adb    # USB flow: sets up the adb tunnel for you

Open http://localhost:8443 in Chrome on the phone, tap START AR, capture the three corners. npm start additionally prints the QR for the wireless flow, npm run start:tunnel exposes a public ngrok URL, and the development guide covers testing the remote flow against uncommitted code.

npm run validate     # format:check + typecheck + knip + tests (90% coverage gate)
npm run build:sea    # single self-contained executable -> dist/point-bang[.exe]
node cli.ts --help   # every option is a flag

How it works

flowchart LR
    subgraph phone [Phone — Chrome WebXR]
        A[ARCore 6DoF pose] --> B[aim ray × calibrated screen plane]
        B --> C[One Euro filter]
        H[on-screen buttons<br/>from buttons.json]
    end
    C -- "WebRTC DataChannel (LAN)<br/>or WebSocket (USB)" --> D
    H --> D
    subgraph pc [PC — Node]
        D[protocol handler] --> E[newest aim sample<br/>no prediction, ever]
        E --> F[2ms cursor loop]
        F --> G[absolute mouse input]
        D --> I[button executor<br/>key combos and clicks]
    end

ARCore's visual-inertial tracking gives absolute, drift-corrected aim at top-class latency (~15–30ms phone-side) — the camera corrects the IMU, so there's no yaw drift and no recentering. You calibrate once per session by pointing at three screen corners; WebXR anchors keep the calibration self-correcting as ARCore refines its map of your room. The wireless setup needs zero certificates: the phone page is hosted over HTTPS, signaling is one Local-Network-Access fetch, and WebRTC brings its own encryption.

Highlights

• Absolute aim, no drift — WebXR immersive-ar with two-ray corner calibration that works on any screen (no surface tracking needed); anchor-pinned self-correcting hit-test mode one toggle away.
• Scan-to-play wireless setup — the startup QR loads the hosted page over HTTPS and connects a WebRTC DataChannel straight across the LAN via Chrome's Local Network Access permission: zero certificates, zero flags, zero accounts (Chrome 142+).
• Latency-obsessed — One Euro filtering phone-side, a 2ms newest-wins cursor loop, zeroed input-driver delays, no prediction or lookahead of any kind (the cursor is exactly where the phone last said the aim was), and live p50/p95 jitter stats to prove it.
• 20 assignable buttons — one JSON file maps on-screen buttons to any key combo or mouse button, press-and-hold included, places each one anywhere on the screen, and gives each a tunable haptic tick on press. The trigger is just button b0 — remappable like everything else.
• Off-screen gestures & real triggers — assign any button to a screen edge (aim past it to press, back on screen to release — the classic Time Crisis reload/duck), and map Bluetooth gamepad or clicker buttons to any action via the Gamepad API; the HUD shows each physical press's button index so any device is easy to map.
• Live button editor — the server hosts a drag-and-drop editor (/editor.html, URL in the startup banner): move and resize buttons on a phone-shaped canvas, remap keys, tune haptics — Save applies instantly, the PC remaps without a restart and a connected phone re-renders mid-session without recalibrating.
• Multi-monitor aware — point-bang monitors lists your displays; --monitor 2 aims at one of them, --monitor all spans the whole desktop with each monitor calibrated as its own plane (bezels and angled panels stay accurate, with independent aim correction per monitor), and the default stays the primary screen. During calibration the PC cursor jumps to the monitor you should aim at next, and if you still calibrated them in the wrong order, one tap on SWAP in the aim panel fixes the assignment — no recalibration. (X11 multi-monitor setups that relied on the old implicit span: that is --monitor all now.)
• Pause hotkey — shift+s pauses tracking so the real mouse works, and resumes right where you left off; configurable, and never swallows the combo from the focused game.
• Windows and Linux, equally — and macOS (Apple Silicon & Intel) — one yargs CLI, no bash-only syntax, CI runs the whole suite on all three. macOS is the community-verified tier: built and smoke-tested on real macOS CI (arm64 and x64) every change, end-to-end aim verified by players.

Project status

Working end-to-end: calibrate, aim, shoot — over USB, WiFi (QR → WebRTC), or an ngrok tunnel. On the roadmap: a measurement harness (accuracy/drift reports), MAME/RetroArch integration testing, and multi-gun support.

Contributing

PRs are very welcome — including community guides, hacks and mods, which get linked from the docs. Read CONTRIBUTING.md for setup, the npm run validate gate and commit conventions, and mind the Code of Conduct.

License

MIT © 2026 ggcaponetto