Introduction

What is MeshDisplay?

Meshtastic radios form a long-range, off-grid text network over LoRa. Most radios are small and have, at best, a tiny screen; to read and write messages you normally pair a phone with them.

MeshDisplay replaces the phone with a dedicated 7-inch touchscreen that sits on your desk, in the shack, at an event control point or in a vehicle. It connects to your radio over Bluetooth Low Energy, using the same interface as the official Meshtastic apps, and shows everything the radio knows:

  • your channels and direct-message conversations, with unread counts

  • every node your radio has heard, with when it was last heard, how many hops away it is and its battery level

  • a map of the nodes that share their position

You type replies on a full on-screen keyboard. Each message shows whether it was sent, delivered or failed, and a pop-up tells you when a new message arrives.

A channel conversation

A channel conversation. Your messages are on the right, with ✓ when the mesh accepted them and ✓✓ when the other end confirmed delivery.

How It Works

+--------------+   Bluetooth LE   +-----------------+   LoRa   +-------------+
| MeshDisplay  | ---------------> | Meshtastic radio| -------> | The mesh    |
| (this unit)  | <--------------- | (your node)     | <------- | other nodes |
+--------------+                  +-----------------+          +-------------+
       |
       | Wi-Fi (optional): map tiles, software updates, clock, MQTT gateway
       v
   The internet
  • MeshDisplay does not have a LoRa radio. All mesh traffic goes through your Meshtastic radio, which must be within Bluetooth range (a few metres, through a wall or two).

  • Wi-Fi is optional. Messaging works without it. Wi-Fi adds map backgrounds, software updates, an accurate clock and the MQTT gateway.

  • A radio can only be connected to one Bluetooth client at a time. While MeshDisplay is connected, disconnect your phone app from the radio (and vice versa).

Key Features

Messaging

  • Channel and direct messages, up to 200 characters each, with emoji

  • Sent / delivered / not-delivered status on every message you send

  • Message history stored on the display — it survives restarts and is kept separately for each radio

  • Pop-up alerts for new messages, with separate switches for direct and channel messages, and optional screen wake

Radios

  • Scan for nearby Meshtastic radios and pair with the radio's Bluetooth PIN

  • Up to 8 paired radios; switch between them in a couple of taps

  • Reconnects automatically at start-up and if the Bluetooth link drops

Map

  • Nodes with a position drawn over OpenStreetMap, with your own radio highlighted

  • Tap a node for its distance and bearing from you, when it was last heard, signal and battery, and a button to message it

  • Map tiles are cached on the display; without Wi-Fi the nodes are still shown at their true distances on a plain grid

MQTT Gateway

  • Carries your radio's MQTT traffic over the display's Wi-Fi (Meshtastic client proxy mode), so a radio without Wi-Fi can still be linked to an MQTT broker or appear on public mesh maps

Display

  • Four themes: Classic, Neon, Console and Guide

  • Screen-off timeout, 180° rotation and time zone

  • Software updates over Wi-Fi

What You Need

  • A Meshtastic radio with Bluetooth enabled (ESP32- or nRF52-based nodes such as Heltec, LILYGO T-Beam / T-Echo, RAK WisBlock and similar), running current Meshtastic firmware

  • A 5 V USB-C power supply, at least 1 A

  • Optionally, a 2.4 GHz Wi-Fi network for the map, updates and the gateway

Themes at a Glance

Neon theme

Neon — a futuristic heads-up display in cyan and magenta.

Console theme

Console — a retro control console with coloured blocks and pill buttons.

Guide theme

Guide — a friendly galactic travel guide. Don't panic.

See Theme to change theme.