gitwtfhub

wtf is meshdeck?

meshdeck-os/meshdeck — explained in plain English

Analysis updated 2026-05-18

7C++Audience · generalLicenseSetup · easy

TL;DR

Free open source firmware for the LilyGo T-Deck that adds offline chat, mapping, and mesh radio tools built on MeshCore.

Mindmap

mindmap
  root((MeshDeck OS))
    What it does
      Firmware for T-Deck
      Built on MeshCore
      Offline mesh communication
    Tech stack
      C++
      ESP32
      LoRa radio
    Use cases
      Off-grid chat
      Offline mapping
      SOS beacon
    Audience
      Mesh radio hobbyists
      Off-grid communicators
    Setup
      One click web flasher
      First boot preset picker

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Flash a LilyGo T-Deck to chat with nearby mesh nodes without cell service or internet.

REASON 2

Use the offline vector map to see contacts, repeaters, and your own position while off-grid.

REASON 3

Broadcast an SOS beacon with your GPS location during camping or emergencies.

REASON 4

Monitor radio signal, trace routes, and manage repeaters through the built-in diagnostics tools.

What's in the stack?

C++MeshCoreESP32LoRa

How it stacks up

meshdeck-os/meshdeck0x-shadow/crewtrackjingmatrix/libxposed-example
Stars777
LanguageC++C++C++
Last pushed2025-11-08
MaintenanceQuiet
Setup difficultyeasymoderatemoderate
Complexity3/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires the physical LilyGo T-Deck hardware and a USB-C data cable.

Wtf does this do

MeshDeck OS is free, open source firmware for the LilyGo T-Deck, a small handheld device with a keyboard, trackball, and screen. It is built on top of MeshCore, an existing MIT licensed mesh radio stack, and gives that hardware a full set of apps for chatting and navigating without needing internet or cell service. The project describes itself as a free alternative to a similar commercial firmware called MeshOS, with no license fee and full freedom to modify the code. Installing it is meant to be simple. There is a one click web flasher that runs in Chrome or Edge: you plug the T-Deck in with a USB-C cable, open the flasher page, and pick the serial port, with no separate software to install or build. A first-boot setup screen then lets a new user pick a node name and choose a radio preset for their region, with the UK and Europe preset chosen by default. Once running, the firmware offers a chat app with channels, direct messages, delivery confirmation, emoji, and message history that survives a reboot. There is also an offline map covering the whole world, with extra detail for the UK and Europe, that shows contacts, repeaters, and your own position, and can be extended with downloadable map packs for other regions. A set of mesh tools lets a user see recently heard stations, monitor radio noise, trace routes, and manage repeaters, plus a full terminal that streams every mesh event and can also be used over a USB connection to a computer. For safety, the firmware includes an SOS beacon that repeatedly broadcasts a device's location on the public channel until it is cancelled, and it will not turn on without a GPS fix or a manually set position. GPS support comes from plugging in an external module. The firmware can also pair with the official MeshCore phone app over Bluetooth, and updates can be applied straight from an SD card. The project is written in C++ and is aimed at people who build or use mesh radio hardware for off-grid communication, camping, or emergency preparedness, and who want firmware they can inspect and change freely.

Yoink these prompts

Prompt 1
Walk me through flashing MeshDeck OS onto a LilyGo T-Deck using the web flasher.
Prompt 2
Explain how MeshDeck's radio preset picker and first-boot setup work.
Prompt 3
Help me build a custom SD map pack for MeshDeck using tools/gen_sdmap.py.
Prompt 4
How does MeshDeck's SOS beacon decide when it is allowed to arm?

Frequently asked questions

wtf is meshdeck?

Free open source firmware for the LilyGo T-Deck that adds offline chat, mapping, and mesh radio tools built on MeshCore.

What language is meshdeck written in?

Mainly C++. The stack also includes C++, MeshCore, ESP32.

How hard is meshdeck to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is meshdeck for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.