Auto-detect, configure & manage your FPV fleet from the browser.
RadioMaster radios · Betaflight flight controllers · ExpressLRS — without juggling three configurators.
Setting up an FPV quad means bouncing between Betaflight Configurator, the ExpressLRS Configurator, EdgeTX Companion and a file manager for the radio's SD card — copying settings by hand and bricking things along the way. FPV Dashboard puts the whole workflow in one local web app:
- 🔌 USB Auto-Detection — plug in a RadioMaster TX16S/Pocket, a Betaflight FC or DJI gear and it shows up, identified
- 🚁 Betaflight over serial — read FC config via MSP, flash CLI batches directly (no Configurator needed), with server-side safety guards
- 🗂️ EdgeTX SD management — analyze the card, health-score it, inject ready-to-fly models using proper
modelN.ymlslots +models.ymlindex, automatic backups - 📡 ELRS guides — step-by-step firmware flashing and binding walkthroughs
- ⚙️ Config templates — battle-tested EdgeTX + Betaflight configs for RadioMaster × iFlight Nazgul / Darwin Hulk 2 combos, binding phrase included
- 🔧 Motor testing — visual layout, per-motor spin test, abortable, throttle-capped server-side
- 🎮 Simulator setup — Liftoff / VelociDrone / Uncrashed with per-radio axis mappings
- 📖 Beginner guide — 17 safety-first tips (props off, failsafe DROP, LiPo storage...)
| Drone control | Radio SD analyzer |
|---|---|
 |
 |
| Config templates | Simulator setup |
|---|---|
 |
 |
More screenshots
git clone https://github.com/SoCloseSociety/radiomaster.git
cd radiomaster
npm install
npm run devOpen http://localhost:3000 — plug in your gear and hit Scanner.
npm run build # production build
npm start # production server
npm test # unit tests (95: MSP protocol, templates, guards, injector, mocked serial)
npm run lint # ESLintLaunch the dashboard like a native app, without touching a terminal.
macOS — installs "FPV Dashboard.app" (SoClose icon included) into /Applications; it starts the server if needed and opens the browser:
./desktop/install-macos.shWindows — double-click desktop/windows/FPV-Dashboard.bat. USB device detection works through serial-port enumeration (COMn), and EdgeTX SD cards are detected by scanning drive letters. The full USB tree (system_profiler) remains macOS-only.
- Next.js 16 (App Router, Turbopack) · React 19.2 · TypeScript 5.9 · Tailwind CSS 4.3
- SerialPort 13 — Node native module speaking MSP v2 (binary) and Betaflight CLI (text) to the FC
- Vitest — 95 unit tests, including a fully mocked serial port
- Zero database — JSON file persistence, atomic writes; nothing leaves your machine
This dashboard can spin motors and rewrite flight controller config, so the API is guarded:
- CLI allowlist — only known-safe Betaflight CLI verbs reach the FC;
dfu,bl,erase, baredefaultsare rejected server-side - Motor test cap —
motorcommands are clamped to a low test throttle; full-throttle requests are refused - Port validation — a client-supplied serial port must be one of the detected FC ports
- Local-only — mutating routes reject cross-origin browser requests (CSRF/DNS-rebinding guard)
- Serial mutex — MSP reads and CLI sessions are serialized per port; an auto-refresh can never corrupt a flash
- Guaranteed CLI exit — the FC is never left stuck in CLI mode (CLI blocks arming)
- One Save Rule — generated CLI batches contain exactly one
save, as the last command - Backup before write — SD card operations back up models before deleting or overwriting
| Category | Devices |
|---|---|
| Radios | RadioMaster TX16S, Pocket (full support) · Zorro, Boxer (detection) |
| Drones | iFlight Nazgul Evoque F5D V2 (BLITZ F722) · Darwin FPV Hulk 2 · any Betaflight FC over USB (MSP read) |
| Link | ExpressLRS (ELRS) 2.4GHz · CRSF · DShot600 |
| Other | DJI Goggles / Air Units (detection) · ELRS USB receivers (CP210x / CH340) |
| Route | Method | Purpose |
|---|---|---|
/api/usb/scan |
GET | Detect USB devices, serial ports, EdgeTX mount |
/api/betaflight |
GET | Read FC config via MSP |
/api/betaflight/flash |
POST | Send validated CLI commands to FC |
/api/inventory |
GET/POST/DELETE | Device inventory CRUD |
/api/profiles |
GET/POST/DELETE | Flight profile management |
/api/templates |
GET | Config templates for radio/drone combos |
/api/edgetx |
GET | Read EdgeTX SD card config |
/api/inject |
GET/POST | Inject models onto EdgeTX SD card |
/api/analyze |
GET/POST | Full SD analysis, backup, clean-inject |
/api/simulator |
GET | Simulator info and axis mappings |
- EdgeTX 2.8+
models.ymllabels format - More radio targets (Zorro, Boxer, MT12 templates)
- VTX table management (SmartAudio / Tramp)
- Blackbox log download & viewer
- Hardware-in-the-loop test rig
PRs are welcome — read CONTRIBUTING.md first (there are hardware-safety rules encoded from real incidents: a wrong resource pin once made Motor 4 vanish). Bug reports and feature requests via the issue templates.
If this project saves you a bricked FC or a lost weekend, a ⭐ helps other pilots find it.
- macOS for full hardware detection (
system_profilerUSB tree); Windows/Linux get serial-based detection - Node.js 20.9+ (Node 22 recommended)
- USB cable for radio/drone connection
MIT © SoClose Society — SOCLOSE PTE. LTD.
Keywords: FPV drone configuration, Betaflight CLI, MSP protocol, EdgeTX SD card, ExpressLRS ELRS binding, RadioMaster TX16S, RadioMaster Pocket, drone dashboard, quadcopter setup, flight controller flashing, FPV simulator setup.