open source · GPL-3.0

Free — as it should be

WADAMESH

A real touchscreen UI for your mesh radio.

MeshCore MESHCOMOD firmware for the LilyGo T-Deck and Heltec V4 — map, chat, channels and contacts on the device itself, and a companion radio for the MeshCore app at the same time.

Offline map Offline mapA real OpenStreetMap you can pan and zoom on the device. Pre-load tile packs to an SD card for fully offline use, or fetch over Wi-Fi — and see your contacts' GPS positions plotted on it. Chat & channels Chat & channelsDirect messages and group channels with delivery receipts (✓/✓✓), unread badges and jump-to-latest, quick-replies, colour emoji, and an on-screen keyboard with accents. Contacts ContactsAdd contacts manually or auto-discover them from adverts. Reset paths, run a route trace, read telemetry, and keep favourites — plus an ignore list for the noisy ones. 11 languages 11 languagesThe whole UI in English, Dutch, German, French, Spanish, Italian, Russian, Ukrainian, Bulgarian, Serbian and Greek — switch any time, with proper Cyrillic and Greek fonts. Multi-transport Multi-transport companionIt's a standalone touch device and a full companion radio at the same time — connect the MeshCore phone app or a web client over Bluetooth, Wi-Fi (TCP + WebSocket) or USB, all at once.
↓  get it on your device

Two ways to install

Pick the path that fits how you like to use your device. You can switch later.

Standalone

Just WADAMESH — the device boots straight into the touch UI.

Best if you want the simplest path: flash once, from your browser, and you're done.
Choose standalone
T-Deck only

With Launcher

Run WADAMESH as one app inside bmorcelli's Launcher on the LilyGo T-Deck.

Best if you want to keep multiple firmwares and switch between them from a menu. The Heltec V4 installs Standalone only.
Choose Launcher

Standalone install

Plug the device in over USB and flash it right here. Works in Chrome or Edge on desktop.

1

Connect over USB

Plug your T-Deck or Heltec V4 into your computer with a data cable.

2

Pick your board & install

Hit Install below, choose the serial port, and let it flash. It does a clean full install.

3

You're on the mesh

The device reboots into WADAMESH. Set your name + region in the first-run wizard.

Heltec V4 + TFT

ESP32-S3 with CHSC6x touch.

LilyGo T-Deck / Plus

ESP32-S3 keyboard handheld.

Your browser can't flash here — use Chrome or Edge on a desktop.

T-Deck not detected? Hold the trackball while tapping reset to force download mode.

Install with bmorcelli's Launcher

Launcher is a multi-app boot menu for ESP32 devices — keep it, and run WADAMESH as one of your apps.

This path is for the LilyGo T-Deck only. On the Heltec V4, install Standalone instead.

1

Install Launcher first

Flash bmorcelli's Launcher to your device, following its own installer — bmorcelli.github.io/Launcher.

2

Add the WADAMESH app

Grab the WADAMESH app image for your board below, then install it from Launcher (via its web UI / OTA, or copy the .bin to your SD card).

3

Launch WADAMESH

Pick WADAMESH from the Launcher menu. Settings persist to SD, so they survive Launcher's slim partition.

LilyGo T-Deck / Plus

app image (no bootloader)

Download .bin

New to Launcher? It's the easiest way to try WADAMESH without giving up your other firmware — and you can fully switch to Standalone any time.

This site uses only essential cookies (via Cloudflare) to stay secure and online — no tracking, no analytics. Cookie Policy