Ardudeck

<p align="center"> <img src="apps/desktop/resources/banner.png" alt="ArduDeck" /> </p> <p align="center"> <a href="https://opensource.org/licenses/GPL-3.0"><img src="https://img.shields.io/badge/License-GPL%203.0-blue.svg" alt="License: GPL-3.0" /></a> <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.0-blue?logo=typescript" alt="TypeScript" /></a> <a href="https://www.electronjs.org/"><img src="https://img.shields.io/badge/Electron-28-47848F?logo=electron" alt="Electron" /></a> <a href="https://reactjs.org/"><img src="https://img.shields.io/badge/React-18-61DAFB?logo=react" alt="React" /></a> <a href="https://mavlink.io/"><img src="https://img.shields.io/badge/MAVLink-v1%2Fv2-green" alt="MAVLink" /></a> <a href="https://github.com/iNavFlight/inav/wiki/MSP-V2"><img src="https://img.shields.io/badge/MSP-v1%2Fv2-orange" alt="MSP" /></a> <a href="https://codecov.io/gh/rubenCodeforges/ardudeck"><img src="https://codecov.io/gh/rubenCodeforges/ardudeck/branch/master/graph/badge.svg" alt="Coverage" /></a> <a href="https://discord.gg/JX2JdVXPPC"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white" alt="Discord" /></a> <a href="https://ardudeck.com"><img src="https://img.shields.io/badge/Website-ardudeck.com-22d3ee" alt="Website" /></a> </p> <p align="center"> <strong>A modern, cross-platform ground control station for ArduPilot, Betaflight, and iNav.</strong> </p>

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 - join our Discord for support and updates, or 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.

---

Table of Contents

• Features
• Screenshots
• Download & Install
• Development (Contributors Only)
• Supported Vehicles
• Veteran Board Support
• Bug Reporting
• Roadmap
• Contributing
• Acknowledgments

---

Features

Real-Time Telemetry

• 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

Interactive Map

• Live Vehicle Tracking - Real-time position with heading indicator
• Flight Trail - Historical path visualization
• Multiple Layers - Street, Satellite, Google Sat, Hybrid, Terrain, Dark mode
• Home Position - Distance and bearing to home
• Overlays - Compass, attitude indicator, stats
• Weather Radar - RainViewer weather overlay with dynamic color schemes
• Airspace Zones - Colored CTR, restricted, danger, and TMA zone polygons with legend
• Aviation Charts - OpenAIP tile layer with airports, navaids, and zoom-adaptive aviation symbology
• Terrain Elevation - Color-coded height overlay with auto-range and relative-to-craft modes
• Offline Maps - Download map regions for offline use with tile caching

Companion Board Support

• Companion Board Store - Browse pre-configured templates for ESP32, Raspberry Pi, Jetson, and Orange Pi
• ESP32 Flashing - Direct USB flash with auto-downloaded esptool (DroneBridge, MAVLink bridge)
• DroneBridge Integration - Auto-detect DroneBridge ESP32 on network, view status, configure WiFi/serial settings
• Agent Dashboard - Real-time CPU/RAM/temp metrics, terminal access, service management for companion computers
• Dockview Layouts - Customizable panel layouts with presets (Overview, Debug, Manage)
• Encrypted API Keys - Secure storage for OpenAIP and other service credentials

Dockable Dashboard

• IDE-Style Panels - Drag & drop layout customization
• Save/Load Layouts - Multiple named layout profiles
• Resizable Panels - Flexible workspace arrangement

Mission Planning

• 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
• Survey Grid - Automated survey patterns (Grid, Crosshatch, Circular) with configurable camera, spacing, overlap, and angle
• 3D Mission View - Three-dimensional visualization of mission waypoints and flight path
• 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

Parameter Management

• 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

Settings & Vehicle Profiles

• 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

Betaflight/iNav Configuration

• 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
• VTX Configuration - Video transmitter band, channel, and power settings
• Filter Tuning - Gyro and D-term filter configuration
• Custom Profiles - Save/load custom PID tunes and rate profiles

ArduPilot Configuration

• PID Tuning - ArduPilot PID controller tuning with presets
• Rate Profiles - Rate curve editor with visualization
• Flight Modes - 6-mode channel assignment for ArduPilot
• Safety & Failsafe - Failsafe actions, geofence behavior, RTL settings
• MAVLink Signing - Passphrase-based packet signing to prevent unauthorized access to your vehicle
• Battery Monitor - Voltage/current sensor calibration
• Sensor Status - Compass, GPS, barometer, and IMU health
• Rover/Boat Tuning - Dedicated tuning parameters for ground and marine vehicles

Quick Setup Wizard

• One-Click Configuration - PIDs, rates, modes, mixers, failsafe in one flow
• Preset Library - Common setups for popular frame types
• Live TX Verification - Real-time transmitter channel check before applying
• Config Review - Preview all changes before writing to board
• Legacy Board Support - Works with both modern MSP and legacy CLI boards

Calibration

• Accelerometer Calibration - Level calibration with position diagrams
• Compass Calibration - Live progress tracking with fitness indicators
• Status Detection - Arming flag-based sensor status detection
• Step-by-Step Wizard - Countdown timers, position guides, and result cards

CLI Terminal

• Full Terminal Emulation - xterm.js with ANSI color support
• Command Autocomplete - Tab completion for commands and parameters
• Parameter Suggestions - Parsed from dump output for quick access
• Command History - Up/down arrow navigation through previous commands
• Legacy Board Support - Full configuration for F3-era boards via CLI

OSD Simulator

• 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