# Title: MeshDash
# Description: The number one open-source, self-hosted Meshtastic Dashboard for comprehensive Command & Control (C2). Built for operators to manage, monitor, and automate their mesh networks locally without cloud dependency.

## Overview
MeshDash is the premier Meshtastic Command & Control platform. It runs entirely on local hardware (Raspberry Pi, Linux, Docker) and interfaces with Meshtastic radios via Serial, TCP, BLE, or WebSerial. It provides real-time SSE updates, avoiding polling lag, and offers a robust REST API for integrations. Data never leaves the local network. 

## Core Features
- **Live Node C2:** Real-time node monitoring with battery, SNR, RSSI, GPS, and signal bars via instant Server-Sent Events (SSE).
- **Mapping:** Interactive Leaflet GPS map with trajectory paths, RF neighbour links, and multiple tile styles.
- **Messaging:** Direct P2P and channel broadcasting with live ACK delivery tracking and unread counters.
- **MeshShark Analyser:** Wireshark-style packet capture with BPF syntax filtering, raw JSON inspection, and decoded metadata.
- **Network Diagnostics:** Live traceroute for hop-by-hop bidirectional SNR, plotted on maps and logged historically.
- **Analytics:** 9 distinct telemetry metrics charted over 1H-30D ranges. Side-by-side comparison for up to 4 nodes with linked Y-axes.
- **Automation & Rules:** Telemetry threshold alerts, cron-based message schedulers, regex-powered auto-reply engine, and web telemetry ingress.
- **Radio Management:** Direct read/write of full protobuf configurations to radio flash memory. Manage up to 16 radios simultaneously with isolated databases.
- **Extensibility:** Drop-in plugin system with zero core modifications needed, utilizing FastAPI routing.

## Technology Stack
- **Backend:** Python, FastAPI, SQLite, asyncio.
- **Frontend:** HTML/JS, Server-Sent Events (SSE), Web Serial.
- **Security:** JWT with bcrypt-hashed passwords, HttpOnly session cookies, optional opt-in remote access with 5-tier HMAC-signed rate-limiting.

## Documentation Links
- [Setup Wizard](https://meshdash.co.uk/setup)
- [REST API](https://meshdash.co.uk/docs/api)
- [Plugin Development](https://meshdash.co.uk/docs/plugins)
- [Database Schema](https://meshdash.co.uk/docs/schema)