Meshyface

Meshyface ist ein Chat-zentriertes Meshtastic-Dashboard, das als einzelner Python-Dienst läuft und eine Single-Page-Web-UI über HTTP bereitstellt.

Aktuelle App-Oberfläche

Die aktuelle UI bietet:

• Chat sowie Direkt-Peer-Gespräche
• Netzwerkarbeitsbereich für Karte, Übersicht, Verbindungen, Routen, Sensoren, Top-10-Rankings, Knotendetails und On-Demand-Verlauf
• Konsolenarbeitsbereich für Live-Paket-/Log-Ausgabe
• Apps-Arbeitsbereich mit Spielen und einem Dateireiter, wenn Dateiübertragung aktiviert ist
• Einstellungsarbeitsbereich mit Funkgerät-, Geräte-, Konnektivitäts-, Standort-, Kanäle-, Ticker-, Listen-, Darstellungs- und Über-Panels
• SQLite-gestützter Verlauf, Suche, Rollups, Themenpersistenz und persistente benutzerdefinierte Telemetrieregeln

Konsolenarbeitsbereich

Der Konsolenarbeitsbereich ist eine terminalartige Steuerfläche für Paketverkehr, Verlaufssuche und Mesh-Dienstprogrammbefehle.

• Gib einen Befehlsnamen ein, um Autocomplete-Vorschläge zu öffnen. Verwende Tab oder Enter zum Annehmen, PfeilRechts zum Annehmen des ausgegrauten Suffixes und PfeilHoch / PfeilRunter zum Navigieren durch das Popup.
• Befehle mit einem Knotenziel zeigen umfangreiche Knotenvorschläge mit Name, ID, Emoji, Tag, Status, Hops, GPS, letztem Hören, Ports und Knotennummer an. Normaler Text filtert nach Knotennamen und Tags; ! filtert nach Knoten-ID.
• live streamt Paketverkehr bis Strg+C oder q. Verwende live grep <text>, live rg <text>, live filter=<text> oder einfach live <text>, um nur passende Live-Paketgruppen zu streamen. Ebenen- und Ausführlichkeitsfilter gelten weiterhin, z.B. live rg TEXT_MESSAGE_APP -vv --layer=2.
• grep <text> und rg <text> durchsuchen den gespeicherten Paket-/Chat-Verlauf mit Kontextfenstern, Begrenzungen, Paket-/Chat-Quellfiltern und Zusammenfassungs-/Paketbereichsfiltern.
• /search <text> filtert die sichtbare Konsolenausgabe von der Eingabeaufforderung, ohne eine gespeicherte Verlaufssuche zu starten.

Screenshots

Live-Netzwerkkarte

Kartenansicht mit Knotenpositionen, Verbindungen, gemeinsamen Pfaden, Clustern und Signal-Wärmekarte.

Netzwerkübersicht

Verlaufsansicht für Knotenanzahlen, Online-Status, neue Knoten und Positionsmeldungen.

Verbindungstopologie

Topologieansicht, die beobachtete Verbindungen vom ausgewählten Wurzelknoten zeigt.

Routenverfolgung

Trace-Ansicht für eine Quelle, ein Ziel, nahegelegene Verbindungen und paketgenaue Details pro Hop.

Sensorverlauf

Telemetriediagramm, das den Sensorverlauf über mehrere Knoten vergleicht.

Statuskarten

Oberste Karten für Funkaktivität, Knotenanzahlen, Pakete, Verbindungen, Akku und Kanalnutzung.

Design-Anpassung

Designs können das gesamte Dashboard mit benutzerdefinierten Farben, Farbverläufen, Transparenz, Unschärfe, Schriftarten, Partikeln oder einem Live-Karten-Hintergrund umgestalten. Diese Beispielpaletten sind benutzerdefinierte Designs; wähle eine Vorschau aus, um ihren Screenshot in voller Auflösung zu öffnen.

Signal Grün	Neon Magenta	Aurora Relay

Gemeinsame Knotendarstellungen

Meshyface-Knoten können kompakte Darstellungspakete teilen, die ein Knoten-Design-Rezept und einen optionalen Geist oder ein Wasserzeichen enthalten. Konfiguriere und zeige eine Vorschau deines Knotens unter Einstellungen > Darstellung > Knotendarstellung, aktiviere Knotendarstellung teilen und verwende dann Darstellung senden, um sie zu veröffentlichen.

• Darstellungspakete verwenden den konfigurierten Profile-Sendekanal und übernehmen die Hop-Limit-Einstellung des Funkgeräts; Meshyface legt kein separates Hop-Limit fest.
• Empfangene Darstellungen können Knotenidentitäten in Chat, Listen, Knotendetails, Karten, Graphen, Sensoren und Tickern gestalten, ohne das Design des empfangenden Dashboards zu ersetzen.
• Das Deaktivieren von Knotendarstellung teilen deaktiviert beide Seiten der Funktion. Es stoppt Sendungen und umgeht den Profile-Empfangspfad, bevor eingehende Darstellungsdaten dekodiert, zwischengespeichert oder gespeichert werden; zwischengespeicherte gemeinsame Darstellungen werden gelöscht und keine empfangene Darstellung wird gerendert.
• Wenn der Verlauf aktiviert ist, bleiben empfangene Profile und die lokale Freigabeeinstellung in der SQLite-Verlaufsdatenbank erhalten.
• Gemeinsame Darstellungen sind kosmetische Metadaten. Eine empfangene Darstellung ändert keine Funkeinstellungen, Kanäle oder das gespeicherte Paketdesign des Dashboards.

Systemarchitektur

flowchart LR
  Browser["Browser<br/>single-page UI"]
  CDN["Vendored browser assets<br/>Leaflet + leaflet.heat + particles.js"]
  Tiles["Basemap provider<br/>OpenStreetMap tile service"]
  Server["ThreadingHTTPServer<br/>HTML shell + JSON API"]
  Assets["Python template assembly<br/>meshdash/html* + meshdash/assets/*"]
  State["State loaders<br/>live snapshot + history readers"]
  Services["Write services<br/>chat, settings, tools, games, optional files"]
  Tracker["DashboardTracker<br/>live receive path + in-memory buffers"]
  History["HistoryStore / SQLite (WAL)<br/>chat, packets, rollups, settings"]
  Radio["Meshtastic interface<br/>serial or TCP"]
  Mesh["Meshtastic radio / mesh"]
  Atlas["Bundled offline atlas<br/>reference basemap fallback"]

  Browser -->|GET /| Server
  Browser -->|GET /api/*| Server
  Browser -->|POST write APIs| Server
  Browser --> CDN
  Browser --> Tiles
  Browser -->|fallback basemap data| Atlas
  Server --> Assets
  Server --> State
  Server --> Services
  State <--> Tracker
  State <--> History
  Services <--> History
  Services <--> Radio
  Radio <--> Mesh
  Radio -->|receive callbacks| Tracker

Installation

Beginne mit Voraussetzungen und Abhängigkeiten, wähle dann einen Installationspfad: