MeshCore App: Android, iOS, Windows, Mac, Linux und Web im Überblick

Erst die Firmware, dann die App

Bevor es um Apps geht, ein Punkt, der die meisten Support-Anfragen erklärt: Ein MeshCore-Board bekommt eine Firmware für eine Rolle. Companion und Repeater sind getrennte Images, ein Gerät kann nicht beides gleichzeitig sein. Und die Companion-Firmware gibt es in mehreren Verbindungsvarianten: Bluetooth (BLE) für die Handy-App, USB für den Rechner, WiFi nur per Selbstbau oder mit einem Patcher. Ein Umschalten zwischen BLE und USB ohne Neuflash ist nicht vorgesehen.

Die Folge: Läuft das Board, aber die App findet es nicht, ist in den allermeisten Fällen die USB-Variante statt der BLE-Variante drauf. Dann hilft nur neu flashen. Zum Flashen brauchst du Chrome oder Chromium, Firefox funktioniert mit dem Web-Flasher nicht. Nimm den Flasher unter meshcore.io, nicht die co.uk-Domain, die inzwischen kommerziell mit MeshOS und Lizenzkosten verknüpft ist.

Welche App auf welchem Gerät

Offizielle App (Android und iOS)

Die App von Liam Cottle ist die Referenz. Sie ist von Version 1.23 im August 2025 bis 1.49 im August 2026 gewachsen; wichtige Zwischenschritte waren 1.29 (Guest Tools, paginierte Nachbarliste), 1.32 (Bugsnag-Opt-out, stabilere Bluetooth-Hintergrundverbindung) und 1.39/1.40 mit der Regionen-Oberfläche. Bei 1.40 auf iOS war das Regionen-Menü zeitweise nicht erreichbar, Android 1.41 lief; wer ein älteres iPhone-Build hat, sollte aktualisieren.

Die App war zunächst kostenpflichtig, etwa 4 Euro pro Gerät, eine Play-Store-Version wurde angekündigt.

Die Übersetzung ins Deutsche läuft über Crowdin und liegt bei rund 58 Prozent. Einige Begriffe bleiben bewusst englisch, „Advert" zum Beispiel wurde nicht zu „Bekanntmachung", weil sich die Community nicht einigen konnte. Rechne also mit gemischtsprachigen Menüs.

KiekR als Alternative

KiekR von Marcel Verdault gilt in der Community als beste Alternative zur offiziellen App. Sie läuft auf Android und auf iOS per TestFlight, ist Library-basiert und liegt bei Regionen und Kanälen vorn: Sie zeigt lokale Kanäle übersichtlich an, erklärt Scopes unter kiekr.app/why-regions und bringt mit map.kiekr.app die derzeit beste Repeater-Karte mit. Als Monitoring-Werkzeug ist sie der offiziellen App ebenfalls voraus. Was fehlt, sind Offline-Karten. Die iOS-App gibt es im App Store (apps.apple.com/app/meshcore/id6742354151), die Android-App im Play Store.

Desktop: Windows, macOS, Linux

Für Windows und macOS gibt es die experimentelle Desktop-App von Liam Cottle, sie spricht Boards per USB und Bluetooth an. Unter Linux ist der übliche Weg ein Companion mit USB-Firmware und meshcore-cli, das seit Ende August 2025 einen interaktiven Chat beherrscht und sich auch auf einem Raspberry Pi betreiben lässt. pyMC_Console ist eine weitere Python-Konsole, läuft aber nicht mit dem Heltec V4. Eine Linux-Firmware wird diskutiert, existiert aber nicht.

Home Assistant bindest du über github.com/awolden/meshcore-ha an, ebenfalls mit einem Companion per USB oder Bluetooth.

Web: Flasher und Repeater-Konsole

Im Browser läuft die Firmware-Installation und die Repeater-Konfiguration per USB: config.meshcore.dev bzw. config.meshcore.io mit Setup-Export, dazu die Konsole des Web-Flashers, über die du Befehle wie get prv.key absetzt. Voraussetzung ist immer Chrome. Eine Web-App für den Chat mit TCP-Anbindung stand lange auf der Wunschliste und war im Material nicht als verfügbar belegt. Die Web-App läuft unter app.meshcore.io im Browser mit USB oder Bluetooth.

WiFi-Companions bekommst du über den SSID-Patcher unter weyhmueller.org oder weyes.de/mcstuff; der erste Start kann drei Minuten dauern, und der Patch greift manchmal erst, wenn vorher die Standard-Firmware mit Erase drauf war.

Typische Verbindungsprobleme

Gerät wird nicht gefunden

• Falsche Firmware-Variante. USB statt BLE geflasht, siehe oben. Erkennungszeichen: per Kabel geht alles, per Bluetooth nichts.
• Alte Kopplung im Handy. Die App speichert den alten BLE-Namen. Kopplung in den Bluetooth-Einstellungen des Handys löschen, unter Android zusätzlich den App-Cache leeren, dann neu verbinden.
• Abstand. Bluetooth-Flashen und OTA-Updates scheitern ab etwa 10 Metern. Unter 5 Meter ran, und keine zweite App parallel verbunden lassen.
• Windows-Bluetooth beim Heltec V4. Entkoppeln und neu koppeln, Browserdaten löschen, in Chrome die Flag chrome://flags/#enable-webusb-device-detection prüfen, notfalls Inkognito-Fenster.

PIN

Geräte ohne Display nutzen die PIN 123456. Geräte mit Display zeigen eine zufällige PIN auf dem Bildschirm. Erscheint unter iOS kein PIN-Fenster, hilft: Gerät in den iOS-Bluetooth-Einstellungen entfernen, Bluetooth aus und wieder ein.

Verbindung bricht ab

• iOS und T1000-E. Das Gerät friert ein, LED aus, kein Bluetooth. Betroffen waren Firmware 1.9.x bis 1.12, behoben ab 1.10 bzw. in den Nightly-Builds. Reset: Knopf halten und Ladekabel anstecken.
• App geschlossen, Verbindung weg. Das ist normal; in den App-Einstellungen den automatischen Reconnect aktivieren. Unter iOS zusätzlich die Stromsparfunktionen für die App lockern.
• Pull-to-Refresh unter iOS war nach einem Update zeitweise unzuverlässig.

Linux-Sonderfälle

Seriell braucht der Nutzer die Gruppe dialout:

sudo usermod -a -G dialout $USER

Danach neu anmelden. Snap-Chromium braucht snap connect chromium:raw-usb, und wenn das Board trotzdem taub bleibt, stört oft brltty. USB-A-zu-C-Kabel nehmen, C-zu-C macht beim Flashen regelmäßig Ärger.

Kontakt- und Kanallimits je Board

Die Limits hängen vom Flash-Speicher des Boards ab, nicht von der App.

Praxisregel aus der Community: Auto-Add ausschalten. Bei über 1.600 Nodes in Süddeutschland läuft jede Kontaktliste sonst binnen Tagen voll. Kontakte, die drei Wochen kein Advert geschickt haben, kannst du löschen. Vor jedem Firmware-Update ein Backup der Kontakte machen, bei Companions gehen sie nach Reboot oder Update gelegentlich verloren; der Import aus der JSON-Datei stellt sie wieder her.

Nachrichten sind auf 160 Byte begrenzt, mit Umlauten bleiben praktisch 113 bis 121 Zeichen. Nachrichten mit Scope über 127 Zeichen blieben in einer Firmware-Version ganz stecken; kürzer schreiben ist ohnehin zuverlässiger.

Companion vs. Repeater in der App

Die App verbindet sich nur mit Companions. Einen Repeater bedienst du aus der App heraus per Fernwartung über das Mesh:

1. Repeater in den Kontakten antippen, drei Punkte, Manage, Admin-Passwort eingeben.
2. Nach jedem Neustart des Repeaters die Zeit synchronisieren, sonst verwirft er Adverts.
3. Regionen ab App 1.39/1.40 über das GUI setzen. Seit Firmware 1.17.x friert region load per CLI ein, das App-Menü funktioniert. Beim P1 Pro wurden Regionen per CLI nicht gespeichert, per App mit Häkchen schon.
4. Remote-Admin möglichst auf Zero-Hop-Nachbarn beschränken, in dichten Netzen bremst Rate-Limiting sonst jede Abfrage aus.

Was nur per USB geht: den privaten Schlüssel auslesen (get prv.key), den Key ändern, die Repeater-ID wechseln. Was in der App fehlt: ein Shutdown-Knopf, ein Hop-Limit beim Senden, der Import eines QR-Codes aus der Galerie.

Nützlich im Alltag: Nachricht lang drücken zeigt Show repeats und Show path, also welche Repeater deine Nachricht gehört haben. Über Kontakte, drei Punkte, Share, to online map trägst du einen Repeater in die Karte ein; löschen kann ihn nur das Gerät, das ihn eingetragen hat. Discover Nearby Nodes braucht Firmware 1.10 auf dem Repeater. Das experimentelle Faster Channel Syncing solltest du deaktivieren, wenn Kanäle nicht sauber synchronisieren.

Wer Direktnachrichten über Repeater mit denyf * verschicken will, setzt im Companion einen Default Scope (set radio.default_region de-hh oder die passende lokale Region). Der muss auf beiden Seiten gesetzt sein, sonst kommt kein ACK zurück. Welche Regionen hier üblich sind, steht in der Anleitung zum Repeater-Aufbau. Hardware-Empfehlungen zu Companions findest du unter Geräte, und wenn der Companion zwar alles hört, aber nichts rausbekommt, liegt das selten an der App, sondern an Antenne oder Störumfeld, siehe SAW-Filter.

Fragen?

Komm in die Telegram-Gruppe: t.me/meshcorede. Dort sitzen die Leute, die KiekR bauen, die Firmware testen und die Repeater in Norddeutschland betreiben.