Wadamesh
ForkA touch-UI MeshCore firmware for the LilyGo T-Deck / T-Deck Plus and Heltec V4 TFT (ESP32-S3), built with LVGL. Split out from meshcomod. Provides a full touch-driven companion experience with on-screen keyboard and WiFi connectivity.
Fork of MeshCore (Official)
- Maintainer
- ALLFATHER-BV ↗
- Status
- active
- Maturity
- beta
- Lifecycle
- active
- Latest version
- beta_9
- Released
- 2026-06-20
- Runtime
- Arduino · C++
- Distribution
- community
- License
- GPL-3.0
Capabilities
Transports
- ✓ BLE
- ✓ USB serial
- ✓ Native TCP
- ✓ Wi-Fi AP
Operations
- ✕ Web flasher
- ✕ OTA updates
Networking
- ✕ Repeater
- ✕ Room server
- ✕ Observer
- ✕ KISS modem
Hardware
- ✓ GPS
- ✓ Display
- ✕ Sensors
- ✕ Low-power RX
Protocol
- ✓ MeshCore compatible
Node roles
Features
- LVGL touch UI
- On-screen keyboard
- WiFi companion connectivity
- USB + TCP transports
- Split from meshcomod (same maintainer)
Releases
from GitHub · updated 2026-06-21beta_9 # Latest 21 hours ago · 2026-06-20 13:18 UTC
wadamesh beta_9
A reliability-focused drop — Wi-Fi recovery, a self-healing chat-history fix, crash-report export, plus room-server, map, contacts and app-drawer improvements.
Install / update: flash from flasher.wadamesh.com, grab it in LauncherHub, or use the on-device update check (Settings → About).
Stability
- Wi-Fi now reconnects on its own after the link drops — no more rebooting to get back online.
- Fixed reboot-on-every-received-message: a corrupted chat-history file could make the device reboot whenever a message arrived (and hide your messages). The bad file is now detected and reset automatically, so it recovers on its own.
- Boot hardening: NULL-guards on the display draw buffer so a unit with quirky/limited memory degrades gracefully instead of getting stuck on the boot logo.
Crash reports
- After a crash, Settings → About shows an "Export crash report" button that saves the crash dump to the microSD card — so you can send it to the devs and get the bug fixed.
Chat & room servers
- Room-server messages now show the time each message was actually sent, not when it arrived.
- Room-server messages now show who sent them.
- Sharing your contact QR now produces a valid
meshcore://contact/add?…code that the MeshCore phone app can scan and import. - Unread counts show "99+" instead of an alarming raw number on busy channels.
Map
- The reload button for corrupt tiles now actually clears the cached tiles — including when you're offline — and the missing/blank "twilight zone" tiles re-download on their own.
- Fixed tiles not re-fetching at zoom levels 13–15.
Contacts
- Favourited contacts always appear in the contact list now, even with hundreds of similarly-named contacts (they used to stay hidden until you searched).
App drawer
- New icon-size setting — tap the cog at the top-right of the app drawer to switch between Compact and Large (bigger icons + labels, easier to read).
- Smoother scrolling through the app list and the other scrollable lists.
Assets:
*-merged.bin= full image (flash at 0x0 / erase). Plain*.bin= app-only (OTA / Launcher side-load). T-Deck =wadamesh-tdeck*, Heltec V4 TFT =wadamesh-heltec-v4-tft*.beta_8 # 2 days ago · 2026-06-19 12:39 UTC
wadamesh beta_8
Polish + fixes for the touch UI — a faster chat acknowledgement, map readout controls, and an internal-memory trim.
Install / update: flash from flasher.wadamesh.com, grab it in LauncherHub, or use the on-device update check (Settings → About).
Chat
- Quick replies insert at the cursor instead of replacing whatever you'd already typed.
- New one-tap "Ack" — long-press any message and tap Ack. It drops a ready-to-send reply into the composer with that message's signal strength (SNR/RSSI) and the route it took (hop codes), so you can instantly confirm someone's test came through. On a channel it
@-mentions the sender. You review and send — it's never auto-sent. - Fixed the message action menu (Ack / Copy / Info / Mention / Block) running off the bottom of the screen — it now fits, and scrolls if it ever needs to.
Map
- The zoom button now shows a clear "+/-" icon.
- Show or hide each on-map readout independently in Map settings — the coordinates line, the tile x/y/z line, and the contact markers.
- Map settings reorganised: the microSD-tiles switch sits at the top under its own heading, separated from the new visibility toggles.
- New auto-refresh button — turn it on and the map re-centres on you automatically whenever your position changes, with an on-screen Auto-refresh on/off confirmation.
- Fixed the close (X) in Map settings overlapping the switches when the panel was scrolled.
Performance
- Reclaimed ~19 KB of internal RAM (scratch buffers moved to PSRAM), leaving more headroom for Wi-Fi and trimming the idle-memory growth seen in recent betas.
Assets:
*-merged.bin= full image (flash at 0x0 / erase). Plain*.bin= app-only (OTA / Launcher side-load). T-Deck =wadamesh-tdeck*, Heltec V4 TFT =wadamesh-heltec-v4-tft*.beta_7 # 3 days ago · 2026-06-18 10:25 UTC
wadamesh beta_7 for the LilyGo T-Deck and Heltec V4 TFT.
🔧 Flash in your browser: https://flasher.wadamesh.com — or update on-device (Settings → check for update), or side-load
wadamesh-tdeck.binthrough Launcher.🙌 Most of this release was built by the community. @Vybo (Dan Vybiral) contributed the lion's share in #12 — the Snake game, battery & telemetry history, map night mode, the PNG/BMP image viewer, and the entire status-bar toolkit. @tun0 (Ruben Laban) fixed unread badges and chat-history persistence in #15. Thank you both. 🎉
🐍 Snake game — by @Vybo (#12)
A Snake game in the app drawer — steer by swiping the screen or with the T-Deck trackball, with pause/resume and restart after a game over. (Touch now stays inside the game and doesn't leak to the screen behind it.)
🔋 Battery & telemetry — by @Vybo (#12)
- Tap the battery in the status bar for a 24-hour history chart with an estimated time-left readout (logged every 5 minutes).
- Per-node telemetry window — poll a node's battery, temperature and humidity, watch them on a live chart, and keep a per-node log.
🗺️ Map — by @Vybo (#12)
- Night mode — the status bar and tab bar invert to match the dark map.
- Live zoom-level readout above the zoom slider, and a proper magnifier icon on the zoom button.
- New "Show on map" contact action that centres the map on that node.
📊 Status bar & tools — by @Vybo (#12)
- A microSD activity LED that lights on card access (including file-manager reads/copies).
- An activity spinner while a telemetry / admin / ping / trace / range / sightline request is in flight.
- Option to hide the device name and move the clock left.
- Hold the status bar to save a full-screen screenshot to SD.
🖼️ Files & images — by @Vybo (#12)
The file browser now previews PNG and BMP images (not just JPEG), with no stale image when opening several in a row.
💬 Chat reliability
- Fixed garbled / duplicated messages — chat text is no longer corrupted in transit, so messages arrive intact and duplicates are filtered out correctly. Thanks to @marcelverdult for the precise report (#13).
- Accurate unread badges and more chat history kept across reboots — by @tun0 (#15).
✨ Also in this release
- Lock-screen wallpaper from Files — view any JPEG on your SD card and tap "Set as wallpaper".
- Set your own Bluetooth pairing code in Settings.
- The app drawer fits all the apps again (no clipped bottom row) and shows a scrollbar when there's more to scroll.
- Fixed map-tile caching (false "storage full"); black/missing tiles re-download.
@-reply no longer overwrites text you were typing. Fixed an out-of-memory crash and made notification audio more reliable.
Contributors: @Vybo (Dan Vybiral) · @tun0 (Ruben Laban) · @marcelverdult (reported #13).
Boards: T-Deck →
wadamesh-tdeck*.bin· Heltec V4 TFT →wadamesh-heltec-v4-tft*.bin. Use-merged.binfor a full flash at 0x0 (web flasher / esptool), or the plain.binfor on-device update / Launcher.
Device compatibility (2)
| Device | MCU | Radio | Status | Notes |
|---|---|---|---|---|
| LilyGo T-Deck | esp32-s3 | Semtech SX1262 | ✓ Supported | |
| Heltec V4 | esp32-s3 | Semtech SX1262 | ✓ Supported |