Meshhessen Client

Kostenloser Windows-Client für Meshtastic-Geräte – Offline-Karte, Telemetrie-Analyse, Traceroute und PKI-Entschlüsselung. Keine Cloud, keine Installation.

Windows 10/11 .NET 8.0 Release License Stars
⬇ Download (EXE) GitHub Repository meshhessen.de
v1.5.9 Feste Position via Karte, Kanal-Uplink/Downlink, Kanalverwaltung-Fix und mehr. Changelog ansehen →

Features

NEU

📨 Nachrichten

  • Broadcast & Direktnachrichten, Multi-Channel
  • Antworten mit Zitat-Block, Nachrichten kopierbar
  • Tap-Back-Reaktionen (32 Emojis)
  • Alert Bell / SOS-Notruf mit Benachrichtigung
  • Persistente SQLite-DB (optional)
  • DM-History automatisch wiederhergestellt

🗺️ Karte

  • OSM Standard, OSM Dark, OpenTopoMap
  • Offline (vorheruntergeladen, Deutschland)
  • Online Meshhessen (lazy download, Deutschland)
  • Online OSM (weltweit, Policy-konform)
  • Node-Pins, GPS-Tracks, Wegpunkte
  • HTTP/3, ETag-Cache, tile.meshhessenclient.de

📊 Telemetrie-Analyse

  • Zeitreihen-Graphen: SNR, RSSI, Batterie
  • LED-Ampeln: Signal, Nachbarn, Pfad, Mesh-Health
  • Kanalauslastung & Airtime-Analyse
  • Nachtabfall-Erkennung & Spannungsverlauf
  • Pfad-Wechselrate & Hop-Kosten
  • Maßnahmen-Empfehlungen je Ampelzustand

📡 Traceroute

  • Hop-Tabelle mit SNR & Entfernung
  • Karten-Visualisierung mit Richtungspfeilen
  • SNR-Popup per Klick auf Hop-Linie
  • Zeitreihenfilter, Deduplizierung
  • JSON-Speicherung aller Traceroute-Daten

🔒 PKI-Entschlüsselung

  • Client-seitig: X25519 + AES-256-CTR
  • Private Key automatisch vom Gerät geladen
  • Key nur im RAM – nie auf Disk geschrieben
  • Automatische Erkennung verschlüsselter Pakete
NEU

⚙️ Verbindung & System

  • USB/Serial, TCP/WiFi, Bluetooth BLE
  • Auto-Reconnect nach Verbindungsabbruch
  • Letzte Verbindung gemerkt (Serial/BT/WiFi)
  • Firmware-Version & Hardware-Modell
  • Update-Check, Dark Mode, Deutsch/Englisch
NEU

🔧 Node-Verwaltung & Konfiguration

  • Node-Farben individuell wählbar (Karte + Liste)
  • Freitext-Notizen pro Node
  • Nodes anpinnen (oben fixieren, unabhängig von Sortierung)
  • Schnellfilter für die Node-Liste
  • Vollständige Node-Konfiguration (Device, LoRa, Position, Power, Network, Display, BT, Security, MQTT, Telemetrie, Kanäle)
  • Feste Position – Lat/Lon/Höhe eingeben oder direkt vom Kartenmittelpunkt übernehmen
  • Kanal-Konfiguration – MQTT-Uplink/Downlink & Positions-Präzision pro Kanal
  • Bluetooth-PIN direkt ändern
  • Meshhessen-Schnellkonfiguration (One-Click Short Slow + EU868)

📊 Telemetrie-Analyse – Messwerte verstehen

Der Meshhessen Client speichert alle empfangenen Telemetrie-Daten in einer lokalen SQLite-Datenbank und wertet sie automatisch aus. Über das Node-Kontextmenü → Telemetrie öffnet sich das Analyse-Fenster für jeden Node. Die LED-Ampeln im Hauptfenster zeigen den Gesamtzustand auf einen Blick.

📶 Signal-Analyse: SNR & RSSI

SNR – Signal-Rausch-Abstand

Gibt an, wie stark das Nutzsignal gegenüber dem Rauschen ist. LoRa kann theoretisch bis ca. −20 dB empfangen, praktisch ist oberhalb von −10 dB aber mit erheblichen Paketverlusten zu rechnen.

  • ▲ > 5 dB – Sehr gut, stabile Verbindung
  • ● 0 – 5 dB – Gut, zuverlässige Verbindung
  • ● −5 – 0 dB – Grenzwertig, Paketverluste möglich
  • ▼ < −5 dB – Schlecht, häufige Paketverluste

RSSI – Empfangspegel

Absoluter Empfangspegel in dBm. Gibt an, wie laut das Signal am Empfänger ankommt – unabhängig vom Rauschen. In Kombination mit SNR ergibt sich ein vollständiges Bild der Verbindungsqualität.

  • ● > −100 dBm – Gut
  • ● −100 bis −115 dBm – Grenzwertig
  • ● < −115 dBm – Schwach

Signal-Trend (Regression)

Der Client berechnet den linearen Trend über das eingestellte Zeitfenster (Standard: 6 Stunden). Ein negativer Trend deutet auf eine sich verschlechternde Verbindung hin – z.B. durch wechselnde Wetterbedingungen oder Hindernisse.

  • ▲ Steigend – Signal verbessert sich
  • → Stabil – Kein signifikanter Trend
  • ▼ Fallend – Signal verschlechtert sich

🔋 Batterie & Spannung

Batteriestand (%)

  • ● > 50 % – Gut
  • ● 20 – 50 % – Mittel
  • ● < 20 % – Niedrig, bald laden

Nachtabfall

Gibt an, wie viel % Batterie der Node in der Nacht (kein Solar) verbraucht. Hoher Nachtabfall zeigt erhöhten Ruhestrom oder fehlende Deep-Sleep-Konfiguration.

  • ● < 5 % – Normal (Ruhestrom)
  • ● 5 – 15 % – Leicht erhöht
  • ● > 15 % – Kritisch, Ursache prüfen

Spannung (V)

Rohspannung des Akkus in Volt. Typische LiPo-Werte: 4,2 V = voll geladen, 3,7 V = Nennspannung, 3,2 V = Tiefentladungsgrenze. Solarnodes: Spannung tagsüber deutlich höher als nachts.

📡 Kanalauslastung (Channel Utilization)

Die Kanalauslastung gibt an, wie viel Prozent des LoRa-Zeitfensters auf dem gewählten Kanal belegt ist – durch eigene Pakete und empfangene Pakete fremder Nodes. Hohe Kanalauslastung erhöht die Wahrscheinlichkeit von Kollisionen und Paketverlusten. Der Mesh-Health-Tooltip zeigt die Top-5-Nodes nach Kanalauslastung.

AuslastungBewertungEmpfehlung
0 – 10 %Sehr gutViel Kapazität frei, keine Maßnahmen nötig
10 – 25 %GutNormales, gesundes Mesh
25 – 50 %ErhöhtPosition-Update-Rate reduzieren, Short Slow prüfen
> 50 %KritischViele Paketverluste; Telemetrie-Intervalle und Broadcasts reduzieren

🔀 Routing & Pfad-Stabilität

Hop-Anzahl

Wie viele Zwischenstationen (Relay-Nodes) ein Paket durchläuft. Jeder Hop erhöht die Latenz und verbraucht Airtime auf dem Kanal.

  • ● 1 Hop – Direktverbindung, optimal
  • ● 2–3 Hops – Normal
  • ● 4–5 Hops – Hoch, hoher Airtime-Verbrauch
  • ● 6–7 Hops – Maximum, sehr ineffizient

Pfad-Wechselrate

Gibt an, wie häufig sich der Routing-Pfad zu einem Node ändert. Häufige Pfadwechsel deuten auf instabile Zwischenverbindungen hin – z.B. Relay-Nodes an schlechten Standorten.

  • ● Stabil – Gleichbleibender Pfad
  • ● Mäßig – Gelegentliche Wechsel
  • ● Instabil – Häufige Wechsel, Relay-Nodes prüfen

Hop-Kosten

Gewichteter Durchschnitt der Hop-Anzahl über den Analysezeitraum. Niedrige Hop-Kosten bedeuten kurze, effiziente Pfade; hohe Hop-Kosten erhöhen Latenz und Kanalauslastung im gesamten Mesh.

👥 Nachbarn (Neighbors)

Zeigt alle Nodes, die der ausgewählte Node direkt (1 Hop, ohne Relay) hört. Pro Nachbar wird der SNR der direkten Verbindung und der zeitliche Trend angezeigt. Viele stabile Nachbarn bedeuten eine gute Einbindung ins Mesh; wenige oder instabile Nachbarn zeigen Reichweitenprobleme.

⏱️ Airtime

Gibt an, wie viel Sendezeit (TX-Airtime) und Empfangszeit (RX-Airtime) der Node belegt. Nodes mit hoher TX-Airtime erhöhen die Kanalauslastung für alle anderen Nodes im Bereich. Telemetrie-Intervalle und Broadcast-Häufigkeit sollten entsprechend angepasst werden.

🔧 LED-Ampeln – Bedeutung auf einen Blick

LEDGrünGelbRotGrau
📶 SignalSNR > 0 dB, stabiler TrendSNR grenzwertig oder leicht fallendSNR < −5 dB oder stark fallendKeine Daten
👥 Nachbarn≥ 2 stabile Nachbarn1 Nachbar oder sinkende SNRsKeine DirektverbindungenKeine Daten
🛤️ PfadStabiler Pfad, ≤ 3 HopsGelegentliche WechselHäufige PfadwechselKein Traceroute
🌐 Mesh-HealthGuter GesamtzustandEinzelne ProblembereicheHohe Kanalauslastung oder viele instabile NodesKeine Daten
🌤️ WetterSensor-Daten vorhanden––Kein Umweltsensor

🛠️ Maßnahmen zur Fehlerbehebung

📸 Screenshots (klicken zum Vergrößern)

Meshhessen Client – Offline-Karte mit Meshtastic Node-Positionen unter Windows Offline-Karte mit Node-Positionen (OSM)
Meshhessen Client – Meshtastic Node-Übersicht mit SNR, RSSI, Batterie und LED-Ampeln Node-Übersicht mit SNR, Batterie und LED-Ampeln
Meshhessen Client – Meshtastic Nachrichten, Kanal-Chat und Direktnachrichten (DM) unter Windows Kanal-Chat und Direktnachrichten (DMs)
Meshhessen Client – Meshtastic Kanal-Liste (Multi-Channel) unter Windows Kanal-Liste (Multi-Channel)
Meshhessen Client – Meshtastic Telemetrie-Übersicht: Signal, Airtime, Routing und Nachbarn Telemetrie-Übersicht pro Node
Meshhessen Client – Meshtastic Batterie- und Spannungsanalyse mit Tag/Nacht-Profil Batterie & Spannung – Tag/Nacht-Profil
Meshhessen Client – Meshtastic Airtime-Analyse: TX-Airtime, RX-Airtime und Kanalauslastung Airtime-Analyse (TX/RX, Kanalauslastung)
Meshhessen Client – Meshtastic Nachbar-Analyse: Direkte Verbindungen und SNR-Trends Nachbar-Analyse mit SNR-Trends
Meshhessen Client – Meshtastic Routing-Statistik: Hop-Anzahl und Pfad-Stabilität Routing-Statistik (Hops, Pfad-Stabilität)
Meshhessen Client – Alert Bell SOS-Notruf Signalisierung für Meshtastic-Geräte unter Windows Alert Bell / SOS-Notruf
Meshhessen Client – Offline-Karten-Tile-Downloader für Meshtastic-Geräte unter Windows Offline-Tile-Downloader

Unterstützte Geräte

Funktioniert mit allen Meshtastic-kompatiblen Geräten: LILYGO T-Beam · LILYGO T-Deck · RAK4631 · Heltec LoRa 32 · Heltec Mesh Node · Seeed WiO-E5 · und weitere.
Verbindung per USB/Serial (115200 baud), TCP/WiFi oder Bluetooth Low Energy (BLE).

Download & Installation

  1. .NET 8 Desktop Runtime herunterladen und installieren
  2. Neueste MeshhessenClient.exe herunterladen
  3. Meshtastic-Gerät per USB anstecken
  4. Doppelklick auf MeshhessenClient.exe – fertig. Keine Installation nötig.
Der Meshhessen Client ist ein inoffizieller Community-Client für Meshtastic-Geräte und steht in keiner Verbindung zum offiziellen Meshtastic-Projekt. Meshtastic® ist ein eingetragenes Warenzeichen der Meshtastic LLC. Entwickelt von der Meshhessen Community in Hessen.
v1.5.9 Fixed position via map, channel uplink/downlink, channel management fix and more. View changelog →

Features

NEW

📨 Messaging

  • Broadcast & direct messages, multi-channel
  • Reply with quote block, copyable messages
  • Tap-back reactions (32 emojis)
  • Alert Bell / SOS with visual & audio alert
  • Persistent SQLite DB (optional)
  • DM history auto-restored on open

🗺️ Map

  • OSM Standard, OSM Dark, OpenTopoMap
  • Offline (pre-downloaded, Germany)
  • Online Meshhessen (lazy download, Germany)
  • Online OSM (worldwide, policy-compliant)
  • Node pins, GPS tracks, waypoints
  • HTTP/3, ETag cache, tile.meshhessenclient.de

📊 Telemetry Analysis

  • Time-series graphs: SNR, RSSI, battery
  • LED indicators: signal, neighbors, path, mesh health
  • Channel utilization & airtime analysis
  • Night-drop detection & voltage profile
  • Path change rate & hop cost metrics
  • Actionable recommendations per indicator

📡 Traceroute

  • Hop table with SNR & distance
  • Map visualization with direction arrows
  • SNR popup on hop-line click
  • Time range filter, deduplication
  • JSON storage of all traceroute data

🔒 PKI Decryption

  • Client-side: X25519 + AES-256-CTR
  • Private key loaded automatically from device
  • Key held in RAM only – never written to disk
  • Automatic detection of encrypted packets
NEW

⚙️ Connection & System

  • USB/Serial, TCP/WiFi, Bluetooth BLE
  • Auto-reconnect after connection loss
  • Remembers last connection (Serial/BT/WiFi)
  • Firmware version & hardware model display
  • Update check, dark mode, German/English
NEW

🔧 Node Management & Config

  • Individual node colors (map + list)
  • Free-text notes per node
  • Pin nodes to top (independent of sort order)
  • Quick filter for the node list
  • Full node configuration (device, LoRa, position, power, network, display, BT, security, MQTT, telemetry, channels)
  • Fixed position – enter lat/lon/altitude or pick from current map center
  • Channel config – MQTT uplink/downlink & position precision per channel
  • Change Bluetooth PIN directly
  • Meshhessen quick-config (one-click Short Slow + EU868)

📊 Telemetry Analysis – Understanding the Values

The Meshhessen Client stores all received telemetry data in a local SQLite database and analyses it automatically. Open the analysis window for any node via the node context menu → Telemetry. The LED indicators in the main window give you an at-a-glance overview of the overall mesh state.

📶 Signal Analysis: SNR & RSSI

SNR – Signal-to-Noise Ratio

Indicates how much stronger the signal is compared to background noise. LoRa can theoretically receive down to approx. −20 dB, but below −10 dB expect significant packet loss.

  • ▲ > 5 dB – Excellent, stable link
  • ● 0 – 5 dB – Good, reliable link
  • ● −5 – 0 dB – Marginal, packet loss possible
  • ▼ < −5 dB – Poor, frequent packet loss

RSSI – Received Signal Strength

Absolute received signal level in dBm. Shows how loud the signal arrives at the receiver regardless of noise. Combined with SNR it gives a complete picture of link quality.

  • ● > −100 dBm – Good
  • ● −100 to −115 dBm – Marginal
  • ● < −115 dBm – Weak

Signal Trend (Regression)

The client calculates the linear trend over the configured time window (default: 6 hours). A negative trend indicates a deteriorating link – e.g. due to changing weather or new obstructions.

  • ▲ Rising – Signal improving
  • → Stable – No significant trend
  • ▼ Falling – Signal deteriorating

🔋 Battery & Voltage

Battery Level (%)

  • ● > 50 % – Good
  • ● 20 – 50 % – Medium
  • ● < 20 % – Low, charge soon

Night-time Drop

How many % battery the node consumes overnight (no solar charging). A high night drop indicates elevated idle current or missing deep-sleep configuration.

  • ● < 5 % – Normal (standby current)
  • ● 5 – 15 % – Slightly elevated
  • ● > 15 % – Critical, investigate

Voltage (V)

Raw battery voltage in volts. Typical LiPo values: 4.2 V = fully charged, 3.7 V = nominal, 3.2 V = deep-discharge threshold. Solar nodes show significantly higher voltage during the day.

📡 Channel Utilization

Channel utilization shows what percentage of the LoRa time slot on the selected channel is occupied – by the node's own packets and by received packets from other nodes. High channel utilization increases the probability of collisions and packet loss. The Mesh Health tooltip shows the top-5 nodes by channel utilization.

UtilizationRatingRecommendation
0 – 10 %ExcellentPlenty of capacity free, no action needed
10 – 25 %GoodNormal, healthy mesh
25 – 50 %ElevatedReduce position update rate, consider Short Slow preset
> 50 %CriticalMany packet losses expected; reduce telemetry intervals and broadcasts

🔀 Routing & Path Stability

Hop Count

How many relay nodes a packet passes through. Each hop increases latency and consumes airtime on the channel.

  • ● 1 hop – Direct link, optimal
  • ● 2–3 hops – Normal
  • ● 4–5 hops – High, heavy airtime use
  • ● 6–7 hops – Maximum, very inefficient

Path Change Rate

How frequently the routing path to a node changes. Frequent path changes indicate unstable intermediate links – e.g. relay nodes at poor locations.

  • ● Stable – Consistent path
  • ● Moderate – Occasional changes
  • ● Unstable – Frequent changes, check relay nodes

Hop Cost

Weighted average hop count over the analysis period. Low hop cost means short, efficient paths; high hop cost increases latency and channel utilization for the entire mesh.

👥 Neighbors

Shows all nodes that the selected node hears directly (1 hop, no relay). Per neighbor the SNR of the direct link and its trend over time are displayed. Many stable neighbors indicate good integration into the mesh; few or unstable neighbors indicate range or configuration issues.

⏱️ Airtime

Shows how much transmit time (TX airtime) and receive time (RX airtime) the node uses. Nodes with high TX airtime increase channel utilization for all nodes in range. Telemetry intervals and broadcast frequency should be adjusted accordingly.

🔧 LED Indicators – Quick Reference

LEDGreenYellowRedGrey
📶 SignalSNR > 0 dB, stable trendSNR marginal or slightly fallingSNR < −5 dB or strongly fallingNo data
👥 Neighbors≥ 2 stable neighbors1 neighbor or declining SNRsNo direct linksNo data
🛤️ PathStable path, ≤ 3 hopsOccasional path changesFrequent path changesNo traceroute
🌐 Mesh HealthGood overall stateIndividual problem areasHigh channel util. or many unstable nodesNo data
🌤️ WeatherSensor data present––No env. sensor

🛠️ Troubleshooting

📸 Screenshots (click to enlarge)

Meshhessen Client – Offline map with Meshtastic node positions on Windows Offline map with node positions (OSM)
Meshhessen Client – Meshtastic node list with SNR, RSSI, battery and LED indicators Node list with SNR, battery and LED indicators
Meshhessen Client – Meshtastic channel chat and direct messages on Windows Channel chat and direct messages (DMs)
Meshhessen Client – Meshtastic multi-channel list on Windows Multi-channel list
Meshhessen Client – Meshtastic telemetry overview: signal, airtime, routing and neighbors Telemetry overview per node
Meshhessen Client – Meshtastic battery and voltage analysis with day/night profile Battery & voltage – day/night profile
Meshhessen Client – Meshtastic airtime analysis: TX airtime, RX airtime and channel utilization Airtime analysis (TX/RX, channel utilization)
Meshhessen Client – Meshtastic neighbor analysis: direct links and SNR trends Neighbor analysis with SNR trends
Meshhessen Client – Meshtastic routing statistics: hop count and path stability Routing statistics (hops, path stability)
Meshhessen Client – Alert Bell SOS emergency alert for Meshtastic devices on Windows Alert Bell / SOS emergency alert
Meshhessen Client – Offline map tile downloader for Meshtastic devices on Windows Offline tile downloader

Supported Devices

Works with all Meshtastic-compatible devices: LILYGO T-Beam · LILYGO T-Deck · RAK4631 · Heltec LoRa 32 · Heltec Mesh Node · Seeed WiO-E5 · and more.
Connect via USB/Serial (115200 baud), TCP/WiFi, or Bluetooth Low Energy (BLE).

Download & Installation

  1. Download and install the .NET 8 Desktop Runtime
  2. Download the latest MeshhessenClient.exe
  3. Plug in your Meshtastic device via USB
  4. Double-click MeshhessenClient.exe – done. No installation required.
The Meshhessen Client is an unofficial community client for Meshtastic devices and is not affiliated with the official Meshtastic project. Meshtastic® is a registered trademark of Meshtastic LLC. Developed by the Meshhessen Community in Hesse, Germany.