Rust-powered desktop telemetry dashboard for model rocketry missions.
KhagaLink is a Ground Control Station (GCS) bridging raw flight logs and actionable insights. It combines a React frontend for visualization with a native Rust backend for low-latency serial communication, built specifically for ESP32 and STM32 flight computers.
Maintained by a solo developer. If this tool saves you an hour of wrestling with Python scripts or stops your laptop from crashing over a massive CSV, consider dropping a ⭐ on the repo! It is the absolute best way to keep this project alive and updated.
- Web-based tools lack reliable, low-level serial port access.
- Native Rust backends ensure zero-latency data processing during live field operations.
- Offline-first architecture guarantees functionality on launch days without internet access.
Project Management
- Create new projects with custom naming and local folder storage.
- Load existing projects via native OS file dialogs.
- Delete projects via right-click context menus.
- Persistent storage utilizing
localStoragefor UI state andproject.jsonfor metadata.
Real-Time Telemetry
- Direct COM port serial connection (e.g., COM5).
- Configurable baud rates: 9600, 19200, 38400, 57600, 115200, 230400.
- Live streaming of newline-delimited packets.
- Native comma-separated value (CSV) packet parsing.
Telemetry Dashboard Widgets
- Live Graphs: Real-time line charts with configurable data columns and smart auto-panning.
- GPS Map: Leaflet integration displaying lat/lng position based on selected packet indices.
- 3D Orientation: Three.js quaternion visualization mapping W/X/Y/Z columns to a 3D model.
- Data Rate: Real-time metrics for packets per second (Hz) and packet loss percentage.
CSV Analysis
- Native dialog browser for CSV file selection.
- Paginated table view (50 rows/page) with automatic header detection.
- Column intelligence displaying total rows and column counts.
- Interactive line graphs supporting any X/Y column combination.
- Smart data downsampling (max 2000 points) to maintain render performance.
| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript |
| Desktop Core | Tauri 2 (Rust) |
| State Management | Zustand 5 (with persistence) |
| Build Tool | Vite 7 |
| Styling | Tailwind CSS 4 |
| Charts | Recharts |
| Maps | Leaflet + react-leaflet |
| 3D Rendering | Three.js + @react-three/fiber |
| Hardware IO | Rust serialport crate |
| Data Parsing | Rust csv crate |
Frontend (React)
Handles all UI components, 3D rendering, and chart updates. Communicates with Tauri via invoke() commands and listens to telemetry-packet events.
Tauri Core (Rust)
Manages file operations (create_project, load_project, save_project), heavy data parsing (get_csv_metadata, get_graph_data), and spawns dedicated background threads for uninterrupted serial port listening.
Prerequisites
- Node.js (LTS)
- Rust & Cargo
Installation
# Clone the repository
git clone [https://github.com/govindgcoder/KhagaLink.git](https://github.com/govindgcoder/KhagaLink.git)
cd KhagaLink
# Install dependencies
npm install
# Run development server
npm run tauri devBuild for Production
npm run tauri buildOutput binaries (.exe for Windows, .app for macOS) will be generated in src-tauri/target/release/.
- Create a Project: Click "Create a new Project", select a local folder, and assign a name.
- Load Flight Data (CSV): Open your project, click the "+" icon to browse, and select your flight log.
- Analyze Data: Use the paginated table to inspect raw values. Add Graph Widgets and select your X/Y columns to visualize trends.
- Connect to Flight Hardware: Navigate to the Telemetry tab, click "Configure Connection", enter your COM port and Baud Rate, and connect.
- Monitor Live Data: Add live graphs, map your GPS columns, and assign quaternion data to watch the 3D orientation model track your hardware in real time.
KhagaLink/
├── src/
│ ├── components/
│ │ ├── home.tsx # Project list & creation
│ │ ├── projectDashboard.tsx # Main dashboard shell
│ │ ├── csvVisualizer.tsx # CSV table + static graphs
│ │ ├── telemetry.tsx # Live telemetry dashboard
│ │ ├── GraphWidgetComponent.tsx # Shared charting logic
│ │ ├── mapView.tsx # Leaflet GPS integration
│ │ ├── orientationWidget.tsx # Three.js quaternion viz
│ │ ├── DataRateWidget.tsx # Link statistics
│ │ ├── projectCreator.tsx
│ │ └── projectLoader.tsx
│ ├── stores/
│ │ └── useStore.ts # Zustand state & Rust bridge
│ ├── App.tsx
│ ├── main.tsx
│ └── index.css
├── src-tauri/
│ ├── src/
│ │ ├── lib.rs # Tauri commands & Serial threads
│ │ └── main.rs
│ ├── Cargo.toml
│ └── tauri.conf.json
├── package.json
└── vite.config.ts
MIT License.
Built for the VeloCET Payload Team at velo.cet.ac.in.