MeshPunk
ForkLVGL + Lua handheld firmware for the LilyGo T-Deck with full MeshCore support. Features offline OpenStreetMap tiles with mesh contact overlays and meshprint sender triangulation, themes, games (Doom, PICO-8, Flappy Bird, Snake, Scorched Earth), SD-card storage, WiFi, BLE, and GPS time sync.
Fork of MeshCore (Reference)
- Maintainer
- PhilMo6 ↗
- Status
- Active
- Maturity
- Alpha
- Lifecycle
- Active
- Latest version
- 0.2.7
- Released
- 2026-07-20
- Runtime
- Arduino · C++
- Distribution
- Community
- Licensing
- Open source
- License
- MIT
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 + Lua app framework
- Offline map with tile caching and meshprint triangulation
- Themes and custom UI styling
- Games (Doom, PICO-8, Flappy Bird, Snake, Scorched Earth)
- SD-card persistence for mesh and firmware settings
- BLE and WiFi companion connectivity
- GPS time sync
- Launcher-compatible build
- MeshCore protocol compatible
Project signals
- GitHub stars
- 13
- Forks
- 0
- Watchers
- 0
- Open issues
- 0
- Contributors
- 3
- Release downloads
- 302
- Latest downloads
- 4
- Source available
- Yes
- Releases available
- Yes
- CI builds
- No
Releases
from GitHub · updated 2026-07-20v0.2.7 # Latest 15 hours ago · 2026-07-20 06:06 UTC
Usb drivers are now separate from the main firmware and apps that need that automatically download them when needed. Gamepads and now supported and their drivers are downloaded with the Gamepad app found in the games category. The Gameboy emulator now includes a tdeck driver to allow device to device usb connection. The Gameboy emulator can now emulate a link cable connection via usb c cable to allow for 2 player link cable games! A readme app is now included that gives details on how to use the firmware.
v0.2.6 # 7 days ago · 2026-07-14 02:01 UTC
you can now add your own fonts! themes can have internal fonts as well. small gps improvements map memory fragmentation fixes
v0.2.5 # 8 days ago · 2026-07-12 16:13 UTC
This update focused on separating the app development from the firmware dev. Only system apps live with the firmware now and other apps are found in the app library. https://github.com/PhilMo6/meshpunk-apps The app library app can be used with wifi to download apps onto your tdeck or the sd card. the sd card is recommended since the filesystem gets erased on firmware flashing. Only the system apps are pre installed so you will have to redownload any others you want. Themes are also downloadable from the themes settings but the preinstalled ones are all still included. The BLE implementation was rewritten to better work with the android app. USB keyboard and USB thumb drive support with the correct 2 in 1 powered OTG y splitter cable Also includes a some error fixes and a security fix.
Device compatibility (1)
| Device | MCU | Radio | Status | Notes |
|---|---|---|---|---|
| LilyGo T-Deck | esp32-s3 | Semtech SX1262 | ✓ Supported | Primary target device. Use -merged.bin for first install, -firmware.bin for updates, or -launcher.bin with bmorcelli's Launcher. |