A .NET 10 Blazor Server application for interfacing with a Meshtastic LoRa mesh radio node over USB/serial or TCP.
- Dashboard — live stats: nodes seen, messages, channels, and connected device info (name, ID, position, hardware, firmware, battery, telemetry)
- Messages — channel-aware chat with a sidebar listing active channels and direct-message threads per node; message delivery ACK tracking (sent / delivered / failed)
- Nodes — sortable table with expandable rows showing full node detail: position, telemetry (device metrics + environment sensors), and one-click traceroute request with hop-by-hop path display
- Channels — manage all 8 channels: edit name, PSK, role, uplink/downlink; changes written to device immediately
- Map — Leaflet map with node position markers, waypoint markers, and layer toggles (nodes / waypoints)
- Config — tabbed device config editor: LoRa (region, modem preset, hop limit, TX power), Device (role, rebroadcast mode, timezone), Position (GPS mode, broadcast interval), Bluetooth, Power
- Module Config — tabbed module config editor: Telemetry, MQTT, Store & Forward, Neighbor Info, External Notifications, Serial
- Commands — device admin panel: request config, reboot, factory reset, node DB reset, rename device
- Logs — live packet log
- Themes — six built-in terminal themes with localStorage persistence
Meshfrantic covers everything in the official Meshtastic web client, plus device admin commands (reboot, factory reset, node DB reset) that the official client doesn't expose.
- .NET 10 SDK
- A Meshtastic device — either:
- Connected via USB/serial (e.g. T-Beam, Heltec, RAK), or
- Reachable over TCP via meshtasticd (the Linux-native Meshtastic daemon)
- Windows, Linux, or macOS
git clone https://github.com/riddlemd/meshfrantic
cd meshfrantic/Meshfrantic
dotnet runOpen https://localhost:5001 in your browser and connect:
- Serial — select your COM port from the dropdown and click Connect
- TCP — switch the mode selector to TCP, enter the host and port (default
localhost:4403), and click Connect
meshtasticd is the official Meshtastic daemon for Linux/Docker. It exposes the same protobuf API over TCP port 4403 and supports a wider range of hardware including CH341-based USB LoRa sticks. A minimal Docker Compose setup:
services:
meshtasticd:
image: meshtastic/meshtasticd:beta
container_name: meshtasticd
restart: unless-stopped
ports:
- "4403:4403"
volumes:
- ./config.yaml:/etc/meshtasticd/config.yaml:ro
- ./data:/var/lib/meshtasticd
command: ["sh", "-cx", "meshtasticd --fsdir=/var/lib/meshtasticd"]Meshfrantic handles meshtasticd restarts gracefully — config saves that trigger a daemon reboot automatically reconnect without dropping the UI.
Note on USB LoRa hardware for meshtasticd: The daemon requires direct SPI access to the LoRa chip. CH341-based USB LoRa sticks (e.g. MeshStick, Pinedio, Meshtoad E22 — USB PID
0x5512) work natively.
Alien/Aliens inspired — aged amber + xenomorph acid

Blazor Server — single MeshtasticService singleton drives the serial connection and exposes state to all pages via StateChanged events.
| File | Role |
|---|---|
Services/MeshtasticService.cs |
Singleton: connection lifecycle, read loop, packet dispatch, send methods |
Services/ThemeService.cs |
Tracks active theme; switching is JS/localStorage-driven |
Components/Layout/MainLayout.razor |
Connection toolbar (port select, connect/disconnect, battery, theme) |
Components/Pages/Home.razor |
Dashboard + own-device telemetry card |
Components/Pages/Messages.razor |
Channel/DM sidebar, message list, ACK status icons |
Components/Pages/Nodes.razor |
Node table with expandable detail + traceroute |
Components/Pages/Channels.razor |
Channel management (name, PSK, role, uplink/downlink) |
Components/Pages/Map.razor |
Leaflet map with node + waypoint layers |
Components/Pages/DeviceConfig.razor |
Core radio config (LoRa, Device, Position, Bluetooth, Power) |
Components/Pages/ModuleSettings.razor |
Module config (Telemetry, MQTT, Store & Forward, etc.) |
Components/Pages/Commands.razor |
Admin commands |
Components/Pages/Logs.razor |
Packet log |
Models/ChatMessage.cs |
Per-message state including channel, ACK, and DM destination |
Models/NodeTelemetry.cs |
Per-node telemetry accumulator (device + environment metrics) |
Meshtastic2.0.8 — C# client library for the Meshtastic protobuf protocol (GPL-3.0)LeafletForBlazor2.4.6.28 — interactive map componentSystem.IO.Ports10.0.6 — serial port access (MIT)Tmds.DBus0.92.0 — D-Bus access for Linux serial enumeration (MIT)Serilog.AspNetCore9.0.0 +Sinks.File/Sinks.Console— structured logging (Apache-2.0)
See THIRD-PARTY-NOTICES.md for the full dependency license audit.
Meshfrantic is licensed under the GNU General Public License v3.0 — see LICENSE.txt.
Meshfrantic — a Blazor client for Meshtastic LoRa mesh radios
Copyright (C) 2026 Michael Riddle
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
GPL-3.0 is required here rather than a permissive license such as MIT, because the core
Meshtasticclient library is GPL-3.0 (strong copyleft) and Meshfrantic links against it directly. Third-party component licenses are documented inTHIRD-PARTY-NOTICES.md.




