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, Heltec V4 and Tanmatsu — 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.

Stable is the tested default. Pick it unless you want to help test. Beta · testing gets new features and fixes earlier, before they are proven, so it can be rough. It is for trying things early and reporting bugs.
Already running WADAMESH? You do not have to reflash to switch channels: turn on Settings → About → "Get test builds (beta)" on the device and it updates to test builds over Wi-Fi. Switch it off to go back to stable.

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.

LilyGo

LilyGo T-Deck / Plus

ESP32-S3 keyboard handheld.

Fully supportedFully supportedEverything wadamesh offers works here — this is one of the two primary development boards, tested on every release. Download .bin

LilyGo T-Display P4 (AMOLED)

ESP32-P4 · AMOLED touch handheld.

Partially supportedPartially supportedEarly port — it's known that not everything works yet, but the core does: LoRa mesh communication, chat, map, GPS and the phone-app link over Wi-Fi or USB. Bluetooth pairing isn't available on this board (a hardware limitation of its stock radio firmware). Download .bin

New board: beta channel only until the next stable.

LilyGo T-Display P4 (LCD)

ESP32-P4 · TFT-LCD touch handheld.

Partially supportedPartially supportedThe LCD-screen model of the T-Display P4 (the AMOLED variant is listed above). Early port — the core works: LoRa mesh, chat, map, GPS and the phone-app link over Wi-Fi or USB. Bluetooth pairing isn't available on this board. Flash with care and report back. Download .bin

New screen variant, not yet hardware-tested — beta only. Flash with care and report back.

LilyGo T-LoRa Pager

ESP32-S3 QWERTY + rotary encoder.

Partially supportedPartially supportedNew community port (thanks @codemonkeybr). The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Pick the build that matches your radio chip.

Radio LR1121:

Download .bin

Radio SX1262:

Download .bin

New board: beta channel only until the next stable.

Heltec

Heltec V4 + TFT

ESP32-S3 with CHSC6x touch.

Fully supportedFully supportedEverything wadamesh offers works here — this is one of the two primary development boards, tested on every release. Download .bin

Heltec V4-R8 (experimental)

ESP32-S3 · 8 MB PSRAM · SD card.

Partially supportedPartially supportedThe core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. This revision is still being hardware-verified — flash with care and report back. Download .bin

New board, not yet hardware-tested — beta only. Please flash with care and report back.

Elecrow

ThinkNode M9

ESP32-S3 QWERTY handheld (LR1110).

Partially supportedPartially supportedThe core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Not every feature has been ported or hardware-verified on this board yet. Download .bin

New board: beta channel only until the next stable.

RAKwireless

RAK WisMesh Tap V2

ESP32-S3 touch node.

Partially supportedPartially supportedThe core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Not every feature has been ported or hardware-verified on this board yet. Download .bin

New board: beta channel only until the next stable.

Nicolai Electronics

Tanmatsu

ESP32-P4 keyboard handheld.

Partially supportedPartially supportedThe core works: LoRa mesh communication, chat, contacts, channels and the phone-app link over Wi-Fi/USB. Some features are still settling on this board (Bluetooth pairing has known gaps).

Already have one? No USB flashing needed — install WADAMESH straight from the Tanmatsu app store on the device.

Get a Tanmatsu
Attaky

Attaky Core (experimental)

ESP32-S3 · 16 MB · 8 MB PSRAM.

Partially supportedPartially supportedThe core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. This community-contributed board (PR #158) isn't hardware-verified by us yet — flash with care and report back. Download .bin

New board, not yet hardware-tested — beta only. Please flash with care and report back.

Install a previous version
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.

Stable is the tested default; Beta gets new builds earlier. The download below follows this choice.

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

You're downloading version .
The file saves as wadamesh-tdeck.bin — rename it if you keep several.

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.

Community videos

Walkthroughs, demos and reviews from the community.

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