Skip to content

About

A cross-platform Meshtastic GUI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Meshfrantic

A .NET 10 Blazor Server application for interfacing with a Meshtastic LoRa mesh radio node over USB/serial or TCP.

Features

  • 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.

Requirements

  • .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

Getting Started

git clone https://github.com/riddlemd/meshfrantic
cd meshfrantic/Meshfrantic
dotnet run

Open 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 (TCP)

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.

Themes

Green

A Classic phosphor green image

Amber

A Warm amber terminal image

White

Greys and whites image

T-800

Red phosphor on pure black image

Nostromo

Alien/Aliens inspired — aged amber + xenomorph acid image

Cyberdyne

Electric blue on cold steel image

Architecture

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)

Dependencies

See THIRD-PARTY-NOTICES.md for the full dependency license audit.

License

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 Meshtastic client library is GPL-3.0 (strong copyleft) and Meshfrantic links against it directly. Third-party component licenses are documented in THIRD-PARTY-NOTICES.md.

About

A cross-platform Meshtastic GUI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages