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 (Reference)
- Maintainer
- ALLFATHER-BV ↗
- Status
- Active
- Maturity
- Beta
- Lifecycle
- Active
- Latest version
- beta_18
- Released
- 2026-06-26
- Runtime
- Arduino · C++
- Distribution
- Community
- Licensing
- Open source
- 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 role
Features
- LVGL touch UI
- On-screen keyboard
- WiFi companion connectivity
- USB + TCP transports
- Split from meshcomod (same maintainer)
Releases
from GitHub · updated 2026-06-26beta_18 # Latest 1 day ago · 2026-06-26 17:55 UTC
wadamesh beta_18
A unified release across all three boards — LilyGo T-Deck, Heltec V4 TFT, and the Tanmatsu (ESP32-P4).
Flash it the easy way at https://flasher.wadamesh.com, or grab a bin below. On a normally-flashed device you can also update straight from Settings → About.
✨ New
- Topographic maps — turn on Map → Options → Topographic map for terrain-relief tiles; OpenStreetMap stays the default. Thanks to @samuelcoustet for the proxy work (#52).
- More emoji in the picker: ⚽ 🏈 🗿 🏳️⚧️.
- Contacts sorting gained ascending/descending and a new Nearest first distance sort; the Discovered list gets the same sort options.
- The Chats header is tidied up — add / mark-read / share grouped on the left, with a proper QR icon for sharing your contact.
🐛 Fixed
- The USB/PC companion connection no longer drops or throws "bad state" errors — also fixes repeater admin mode disconnecting and member-room login (#25, #54, #23).
- Map edge/corner tiles now fill in as you pan instead of needing a manual reload (#20).
- ~41 KB of memory reclaimed (moved a large buffer to PSRAM) — fixes the Heltec V4 rebooting when loading map tiles, and frees headroom on every board.
- The map's Show link lines toggle now survives a reboot. Thanks to @Yazutsu (#61).
- Settings category names fit on one line (no more mid-word splits); keyboard-nav toggling no longer jumps the list to the top (#45).
- Heltec V4: node name no longer covers the clock (#47a). T-Deck: keyboard backlight no longer stuck on after flashing (#33).
- More reliable crash reporting and fewer stray reboots while saving settings.
- Tanmatsu: LoRa radio changes (frequency, etc.) now take effect immediately without a reboot, and the app's settings drive the radio.
Everything from beta_16 (and the Tanmatsu's beta_17) is included.
beta_16 # 3 days ago · 2026-06-24 13:45 UTC
wadamesh beta_16 — Heltec V4 Expansion Kit support, European keyboards, and Wi-Fi updates (with rollback) are back.
Flash or update at https://flasher.wadamesh.com, or grab it on-device under Settings → About if you're on a normally-flashed board.
New
Heltec V4 Expansion Kit · thanks @samuelcoustet (#29)
If you've got the sensor expansion board on a Heltec V4, there's finally a proper home for it: a dedicated Sensors tab (temperature, humidity, pressure, GPS and battery, each with a small history chart), an environment readout on the Home screen, and an on-device mesh console for poking at the radio directly. None of it shows up on a bare V4 — it only appears when a sensor board is actually detected, so nothing changes for everyone else.
Worth being honest about this one: it was a real grind to land. It came in as a big pull request built against an old beta, so getting it in cleanly meant re-doing most of it by hand against current code and carefully gating every piece so it can't bloat or destabilise the T-Deck and Tanmatsu builds. The original work is @samuelcoustet's — thank you.
European keyboards · thanks @samuelcoustet (#29)
French, Dutch, German, Spanish and Italian layouts, both on-screen and on the T-Deck's physical keyboard. Choose one of those as your interface language and the matching layout is selected automatically.
Wi-Fi updates are back — and you can roll back
On a normally-flashed device (not installed through the Launcher), firmware updates over Wi-Fi return: Settings → About, no cable needed. New this round: Install a previous version — pick one of the last few betas and reinstall it over Wi-Fi, with an "are you sure?" first since it's a downgrade.
Fixed · thanks @tun0
- Closing a dialog no longer lets a scroll carry through to the page behind it (#50).
- The contact action sheet no longer overflows the screen in landscape (#49).
- The per-channel region field now shows your default region as the hint, instead of a generic placeholder (#48).
- The status-bar clock no longer overlaps the node name on the V4.
Everything from beta_15 is included. Thanks to @samuelcoustet and @tun0 for the contributions this round.
beta_15 # 4 days ago · 2026-06-24 09:02 UTC
wadamesh beta_15 ✨
Two new touches, a couple of satisfying fixes, and one sensible default change.
✨ New
- Amber power-save battery — idle power-saving now tints the status-bar battery amber, just like iPhone's Low Power Mode, instead of showing a separate moon icon. (T-Deck)
- @-mention picker — type
@in the message box to pick a contact from a list and drop their name in. Thanks @robinshizuyo-dev (#42).
🩹 Fixed
- Lists stay put — closing a settings item, menu or chat no longer snaps the list back to the top; it stays where you left it. Thanks @ZorkaTheDog (#45).
- App-sent messages appear on the device — a DM sent from the MeshCore companion app now also shows in the right conversation on-screen. Thanks @HonzaDandy (#46).
- Typing reliability (T-Deck / Tanmatsu) — tapping a text field, even one that's already highlighted, starts typing right away, and the accent pop-up no longer interrupts typing outside of chats.
- Cursor cue — the text cursor only appears when a field is actually ready for input, so it's a dependable "you can type now" hint.
- Smoother map panning — tile rendering no longer trips the watchdog and reboots during heavy scrolling.
⚙️ Changed
- Keyboard navigation is now OFF by default. Prefer driving the UI with the trackball / arrow keys? Turn it back on in Settings → Keyboard (your choice sticks until you change it). The Tanmatsu keeps it on, since it has no touchscreen.
Everything from beta_14 is included.
▶️ Flash in the browser: https://flasher.wadamesh.com — or install via the Launcher / on-device update. 🙏
Device compatibility (2)
| Device | MCU | Radio | Status | Notes |
|---|---|---|---|---|
| LilyGo T-Deck | esp32-s3 | Semtech SX1262 | ✓ Supported | |
| Heltec V4 | esp32-s3 | Semtech SX1262 | ✓ Supported |