A modern, cross-platform ground control station for ArduPilot, Betaflight, and iNav.
ALPHA SOFTWARE - ArduDeck is under active development. Features may be incomplete, unstable, or change without notice. Use at your own risk and always have a backup configuration tool available. We appreciate early testers - please report bugs to help improve the project!
ArduDeck is a next-generation ground control station built with Electron, React, and TypeScript. It provides real-time telemetry, parameter management, PID tuning, and mission planning for drones and vehicles running ArduPilot, Betaflight, or iNav firmware.
One app for all your flight controllers - Cross-platform (Windows, macOS, Linux), modern UI, supports both MAVLink and MSP protocols.
- Features
- Screenshots
- Quick Start
- Supported Vehicles
- Veteran Board Support
- Bug Reporting
- Roadmap
- Contributing
- Acknowledgments
- Attitude Indicator - Roll, pitch, yaw with compass heading
- Flight Data - Altitude (MSL/AGL), airspeed, ground speed, climb rate
- GPS Status - Fix type, satellite count, HDOP, coordinates
- Battery Monitor - Voltage, current, remaining capacity with visual indicator
- Flight Mode - Armed/disarmed status, current mode display
- Live Vehicle Tracking - Real-time position with heading indicator
- Flight Trail - Historical path visualization
- Multiple Layers - Street, Satellite, Terrain, Dark mode
- Home Position - Distance and bearing to home
- Overlays - Compass, attitude indicator, stats
- IDE-Style Panels - Drag & drop layout customization
- Save/Load Layouts - Multiple named layout profiles
- Resizable Panels - Flexible workspace arrangement
- Interactive Map Editing - Click to add waypoints, drag to reposition
- Waypoint Table - Beginner-friendly with human-readable summaries
- Altitude Profile - Terrain-aware visualization with drag-to-edit
- Terrain Data - Real elevation data from Open-Meteo (Copernicus DEM)
- Collision Detection - Visual warnings when path intersects terrain
- Spline Waypoints - Smooth curved flight paths with Catmull-Rom interpolation
- Command Support - Takeoff, Waypoint, Loiter, Land, RTL, Speed changes
- File Operations - Save/Load .waypoints and QGC .plan formats
- Upload/Download - Full MAVLink mission protocol support
- Full Parameter List - View all 800+ ArduPilot parameters
- Search & Filter - Quick parameter lookup by name or group
- Inline Editing - Click to edit, Enter to save, Escape to cancel
- Real-Time Validation - Range, enum, and increment checks with error tooltips
- Modified Tracking - Visual indicator with revert option
- Write to Flash - Persist changes to EEPROM with confirmation dialog
- Save/Load Files - Export and import .param files
- Auto-Load Metadata - Descriptions from ArduPilot XML + 600 fallback descriptions
- MAVLink v1/v2 Auto-Detection - Compatible with legacy and modern flight controllers
- Vehicle Profiles - Create and manage multiple vehicle configurations
- All Vehicle Types - Copter, Plane, VTOL, Rover, Boat, Submarine
- Type-Specific Properties - Frame size, wingspan, hull type, thruster count, etc.
- Performance Estimates - Flight time, range, cruise speed based on specs
- Live Weather - GPS-based weather conditions from Open-Meteo API
- Maritime Data - Wave height, swell info for boats/subs
- Persistent Storage - Profiles saved to disk, survive app restarts
- Auto-Detection - Automatically detects MSP protocol (Betaflight/iNav) vs MAVLink
- PID Tuning - Beginner-friendly presets (Beginner, Freestyle, Racing, Cinematic)
- Rate Curves - Visual rate curve editor with presets
- Modes Wizard - Step-by-step mode configuration with live RC feedback
- Servo Wizard - Fixed-wing servo setup with aircraft presets (Traditional, Flying Wing, V-Tail, Delta)
- Platform Type Change - Convert multirotor to airplane with MSP2 + CLI fallback for iNav 2.0.0
- Custom Profiles - Save/load custom PID tunes and rate profiles
- Full Terminal Emulation - xterm.js with ANSI color support
- Command Autocomplete - Tab completion for commands and parameters
- Parameter Suggestions - Parsed from
dumpoutput for quick access - Command History - Up/down arrow navigation through previous commands
- Legacy Board Support - Full configuration for F3-era boards via CLI
- Live Preview - See exactly what appears in FPV goggles
- Demo Mode - Adjust telemetry values with sliders for font development
- Live Mode - Real-time display from connected flight controller
- MCM Font Support - Full MAX7456/AT7456E font parsing
- 8 Bundled Fonts - Default, Bold, Clarity, Impact, Vision, and more
- PAL/NTSC - Support for both video standards (30x16 / 30x13 grids)
- 15+ OSD Elements - Altitude, speed, battery, GPS, artificial horizon, CCRP indicator, and more
- CCRP Indicator - Continuously Computed Release Point for payload drops (shows predicted impact point)
- Element Toggle - Enable/disable individual OSD elements
- Multi-Protocol Detection - Auto-detect boards via MAVLink, MSP, or STM32 bootloader
- USB VID/PID Recognition - 30+ known boards identified by USB IDs
- ArduPilot Support - Flash ArduCopter, ArduPlane, ArduRover, ArduSub
- Betaflight/iNav Support - Flash Betaflight and iNav firmware with curated version lists
- F3 Legacy Support - SPRacing F3 (iNav 2.0.0), FrSky F3 (iNav 2.6.1), Betaflight 3.5.7
- Boot Pad Wizard - Guided entry for boards requiring manual bootloader activation
- STM32 Serial Bootloader - Native USART flashing (no external tools needed)
- Progress Tracking - Real-time erase/write/verify progress with detailed logging
- Firmware Caching - Downloaded firmware cached for fast re-flashing
- Serial (USB) - Direct connection via COM/ttyUSB ports
- TCP Client - Network connection to SITL or telemetry bridges
- UDP - Listen mode for MAVProxy and other forwarders
- Auto-Detect - Scan ports for MAVLink devices
🚧 Coming Soon - This feature is currently under development and temporarily disabled. The SITL simulator requires complex protocol bridging that is still being refined. Check back in a future release!
What is this? SITL (Software In The Loop) lets you run real flight controller firmware on your computer - no drone required! Perfect for:
- Learning - Practice mission planning and configuration without risking a crash
- Testing - Verify your settings work before uploading to real hardware
- Development - Test new features without leaving your desk
How it works:
- ArduDeck downloads and runs the actual iNav/Betaflight firmware as a desktop application
- The simulated flight controller behaves exactly like real hardware
- You can configure PIDs, modes, missions - everything works!
- Optionally connect to FlightGear (free flight simulator) to see your virtual aircraft fly
FlightGear Integration - If you have FlightGear installed, ArduDeck automatically detects it and can bridge the simulator to your SITL session. Watch your configured aircraft respond to your mission in a realistic 3D environment!
TL;DR: Test your drone configuration on your computer before flying for real. Break things in simulation, not in the field!
Mission planning with terrain-aware altitude profile and automatic elevation data
Mission + Telemetry Layout |
Telemetry Dashboard |
Firmware Flash |
Vehicle Profiles & Weather |
PID Tuning with Quick Presets |
Rates & Expo Configuration |
Flight Modes - Simple View |
Modes Setup Wizard |
Flight Modes - Advanced View |
Servo Tuning for Fixed Wing |
Safety & Failsafe Configuration |
Sensors & Live Telemetry |
OSD Simulator - Demo Mode |
CLI Terminal with Autocomplete |
SITL Simulator with FlightGear |
Parameter Management |
- Node.js 18 or higher
- pnpm 8 or higher
# Clone the repository
git clone https://github.com/rubenCodeforges/ardudeck.git
cd ardudeck
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run in development mode
pnpm dev# Build all packages
pnpm build
# Package for distribution (coming soon)
# pnpm package- Copter - Quadcopters, hexacopters, octocopters
- Plane - Fixed-wing aircraft, flying wings
- VTOL - Tiltrotors, tailsitters, QuadPlanes
- Rover - Ground vehicles, boats
- Submarine - Underwater ROVs (ArduSub)
- Multirotors - Quads, hexes, octos, tris
- Fixed Wing - Traditional, flying wing, V-tail, delta
- F3/F4/F7/H7 - All STM32 flight controllers
"No board left behind"
Got an old SPRacing F3, Naze32, or other F3-era board collecting dust? We've got you covered.
While other configurators have abandoned these classic boards, ArduDeck provides a fully-featured graphical interface - not just CLI access, but the same modern UI experience as newer boards:
| Board Era | Firmware Support | Configuration |
|---|---|---|
| F3 Boards | iNav 2.0.0, Betaflight 3.5.7 | Full GUI (powered by CLI) |
| F4/F7/H7 | Latest iNav & Betaflight | Modern MSP Protocol |
These boards were the workhorses of the FPV revolution. They flew millions of packs, survived countless crashes, and taught a generation of pilots how to tune PIDs. They deserve better than a drawer.
No command-line typing required! ArduDeck automatically detects legacy boards and presents a complete graphical interface:
- PID Tuning Tab - Sliders and inputs for P/I/D/FF, just like modern boards
- Rates Tab - Visual rate configuration with expo curves
- Mixer Tab - Graphical motor (
mmix) and servo (smix) mixer editor - Servo Tab - Visual endpoint tuning with range indicators
- Modes Tab - Point-and-click flight mode assignment
- CLI Terminal - For power users who want raw access with autocomplete
The GUI talks to your board via CLI commands under the hood - you get the convenience of a modern interface with the compatibility of CLI.
- SPRacing F3 / F3 EVO / F3 Mini / F3 Neo
- Naze32 Rev6
- CC3D (with iNav)
- Flip32 F3
- Seriously Pro Racing F3
- ...and any other F3-era board running iNav < 2.1 or Betaflight < 4.0
Dust off those veterans and give them one more flight! 🛩️
Found a bug? We want to hear about it! ArduDeck includes a built-in bug reporting tool that makes it easy to share diagnostic information with the development team.
Built-in bug reporting with automatic log collection
- Open the Bug Report screen - Click the bug icon in the sidebar or go to Help > Report Bug
- Describe the issue - Tell us what happened and what you expected
- Choose what to include:
- App logs - Recent application logs (always recommended)
- Board dump - Flight controller configuration (requires connected board, will trigger reboot)
- Review the data - See exactly what will be collected before sending
- Generate report - Creates an encrypted
.deckreportfile - Send to developers - Share the file via GitHub issue or email
| Data | Description | Privacy |
|---|---|---|
| App logs | Recent application logs (errors, warnings, debug info) | Paths sanitized, no personal data |
| System info | OS, version, architecture | Anonymous |
| Board dump | Flight controller settings via CLI dump command |
Your FC configuration |
- You control what's shared - Choose what to include, preview before sending
- Encrypted reports - Only the ArduDeck dev team can decrypt
.deckreportfiles - No automatic uploads - You decide when and how to share the file
- Real-time telemetry with dockable dashboard
- Interactive map with vehicle tracking
- Mission planning with terrain-aware altitude profile
- Full parameter management with validation
- Geofence and rally point editing
- Vehicle profiles with weather integration
- Firmware flashing (ArduPilot, Betaflight, iNav)
- Betaflight/iNav PID tuning and configuration
- CLI Terminal with autocomplete and command history
- Legacy F3 board support via full CLI configuration
- OSD Simulator with demo and live telemetry modes
- SITL Simulator - Software-in-the-loop with FlightGear integration (temporarily disabled)
- OSD element editor and font designer
- Calibration wizards (compass, accelerometer, radio)
- Auto-updater and crash reporting
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the GPL-3.0 - see the LICENSE file for details.
- ArduPilot - Open-source autopilot firmware
- Betaflight - Flight controller firmware for multirotors
- iNav - Navigation-focused flight controller firmware
- Mission Planner - Original GCS that inspired this project
- QGroundControl - Cross-platform GCS inspiration
- MAVLink - Micro Air Vehicle communication protocol
- Leaflet - Interactive maps library
Made with ❤️ by Codeforges