Repository navigation
A race director can run a complete FPV event, end to end, from the RD console. That was the v0.4 goal, and this is it — the milestone closed at 145 issues, and 255 commits since v0.4.0-alpha.1.
This is the first build without a pre-release tail. It is not 1.0: see Still to come.
Get it
Download the portable for your machine below. One file, no installer, no runtime to set up.
Each download is a ZIP with one file inside: gridfpv-desktop (.exe on Windows).
| Your computer | Download | Then |
|---|---|---|
| Windows | gridfpv-windows-portable.zip |
Unzip, double-click. SmartScreen will warn — More info → Run anyway. |
| Linux | gridfpv-linux-portable.zip |
Unzip, chmod +x ./gridfpv-desktop, run it. |
| macOS (Apple Silicon) | gridfpv-macos-portable.zip |
Unzip, chmod +x ./gridfpv-desktop, then right-click → Open the first time. |
Your race data lives in a gridfpv-data/ folder next to the executable, so put it somewhere it can stay. Full walkthrough: Getting Started.
What you can do with it
Run the whole day. Pilots, classes, rounds and heats; a setup wizard for the common path; and a race-control cockpit that drives one heat at a time through stage → start → finish → finalize.
Race real hardware. RotorHazard 4.3.0+ over the GridFPV plugin, which GridFPV serves and installs for you. The plugin switches off RotorHazard's own race format and lap filter, so every crossing reaches GridFPV and RotorHazard makes no scoring decisions of its own.
Tune the gate from your phone. A per-node Tune page with live signal, draggable enter/exit levels, and a crossing band that actually answers "did that pass register?". No Apply button — every change is confirmed by reading it back off the timer, and says Not taken if the hardware refused. Capture measures a level from a real pass instead of you guessing one.
Defend your results. Marshaling against the recorded RSSI trace: remove a false crossing, re-time a lap, split a double, throw one out, add a missed one, or re-derive a pilot's whole set from the trace. Penalties, protests and heat voids. Every change is a recorded ruling and the standings re-derive live.
Hear the race. Start tone, end-of-race countdown, race-end buzzer, and spoken lap callouts — following you to every page, so you can look away from the screen. A beep for every gate crossing, including ones that scored nothing, because a beep with nobody flying is how you catch a gate firing at noise.
Choose your structure. Practice, Time Trials and Head-to-Head, chained with From ranking seeding. Channel layouts with a live IMD reading that names the worst offending mix rather than just scoring it.
New in this release
Gate bounce is now its own rule (#517). A gate can report one drone going past as three or four crossings a fraction of a second apart. That used to be lumped in with the min-lap floor, which meant the console could not hide a reflection burst without also hiding a genuinely short lap. Now there is a per-timer same-pass window (default 1s, capped at 2s), those crossings group into one line in Marshaling instead of burying your laps, and they stay silent. The value is recorded when a heat arms, so changing the setting never re-scores a race that already ran.
The grace window is honored properly (#505, #512). A crossing just after the buzzer counts; the next one does not.
Build stamps name themselves honestly (#513, #514, #515, #516). A release names its tag, a dev build names its commit, and the Windows portable stopped stamping itself -dirty.
Plus a large field-testing wave: the min-lap floor on every surface (#502, #409), one tone per reflection burst (#503), time-trial clock and tones (#504), node discovery from the timer (#412), a read-only gate-signal strip during a race (#415), and refusals that say what to do instead of returning an HTTP code (#433).
Documentation
docs.gridfpv.com has been rewritten for this release, in plain English — average Flesch-Kincaid grade 5.5, down from 7.9. Most FPV pilots are technical; a manual should not require it.
Still to come {#still-to-come}
Deliberately lighter today, and we would rather ship them properly than promise them early:
- Tournament structures — bracket builders, multi-main tiers, round robin. Being rebuilt on the three round formats. Until then, chain rounds by hand with From ranking.
- Streaming and broadcast — overlays and announcer feeds.
- An optional cloud tier.
On breaking changes: v0.4.0 is a real release, but GridFPV's pre-release engineering rules run until v1.0.0. Wire formats and stored shapes can still change between now and then. Nothing you record today is guaranteed to load in 1.0.