MeshPunk

Firmware for LoRa handhelds, built on LVGL and Lua

Mesh messaging, maps, an app library and a shelf of games. The interface is LVGL and the apps are Lua scripts, so the device is yours to change.

Flash MeshPunk Source on GitHub

Supported devices

Releases are built per device. The flasher asks which one you have.

LilyGo T-Deck

Keyboard, trackball and touchscreen.

Heltec V4 + Expansion Kit V2

Touchscreen, with an on-screen keyboard and on-screen game pads.

Seeed Wio Tracker L2

Touchscreen, with an on-screen keyboard and on-screen game pads.

What it does

Everything below runs on the device itself. A phone is optional: BLE companion apps work too.

Mesh messaging

MeshCore comes preinstalled: direct messages, channels, and room server and repeater logins with admin commands, all from the Messenger app.

Swappable LoRa protocols

The LoRa protocol is an installable package. MTLite, a Meshtastic-compatible protocol, installs from the App Library next to MeshCore.

Map

Offline tile caching, message path animations and replay, and sender triangulation.

App Library

Install and update apps, themes and protocols over WiFi, straight from GitHub. No reflash needed.

Updates on the device

New firmware installs over WiFi or from the SD card under Settings > Firmware. No computer needed after the first install.

Apps are Lua

Lua scripts on the filesystem show up as apps. Write one, copy it over, and it runs.

Games and emulators

Doom, PICO-8, Game Boy with link-cable play, NES, SNES, Neo Geo Pocket, Sega 8-bit and a 386 DOS PC. Bring your own ROMs, WADs and carts.

USB host

Plug in a gamepad, keyboard, mouse, thumb drive or USB-C audio adapter.

And the rest

An MP3 player that keeps playing in the background, themes, a file manager, emoji, and a text-mode web browser from the App Library.

On a T-Deck

Menus, the Messenger, games and a few of the themes.

MeshPunk home menu on a T-Deck
Home
Messenger conversation list
Messenger
A channel in the Messenger
A channel
Flappy Bird title screen
Flappy Bird
Scorched Earth menu
Scorched Earth
Theme list with the Doom theme applied
Doom theme
Theme list with the Garden theme applied
Garden theme
Theme list with the Sacred Geometry theme applied
Sacred Geometry theme

Getting started

A first install takes a USB cable and Chrome, or another compatible Chromium browser, on a computer.

  1. Flash itConnect the device and use the flasher. The first start unpacks the bundled files, which takes about a minute.
  2. Set the radioOpen the radio settings and set them to your local defaults. An SD card is recommended: it keeps your mesh and firmware settings.
  3. Add appsJoin WiFi and open the App Library for apps, themes and protocols.