Skip to content

Getting started

MeshClient is a mesh radio client for handhelds. It lets you read and send messages, see who is on the mesh and change your radio’s settings from a TrimUI Brick, without a phone. It works with Meshtastic radios and also with MeshCore companion radios.

The Brick is the main target. Builds for the Miyoo Mini Plus, macOS, Windows and a Linux command line also exist, running the same client.

  • Something to run it on. A TrimUI Brick running NextUI, a Miyoo Mini Plus running Onion (network radios only), a Mac or Windows PC, or a Linux machine for the command line. See Installing.
  • A radio. A Meshtastic or MeshCore node, such as a Heltec, a RAK or a T-Echo. The client reaches it over Bluetooth LE, a USB cable, or the network. See Connecting a radio.

You don’t need a phone at any point, including for setup. You can pair, set your region and choose your channels from the client.

  1. Install MeshClient from the Pak Store, then open it from Tools → MeshClient.
  2. Switch your radio on. If it’s plugged in over USB, the client connects straight away. If it’s a Bluetooth radio you’ve used before, the client finds it on its own.
  3. For a new Bluetooth radio, go to the Radio tab, press A on devices and pick the radio. If the radio shows a PIN on its screen, type it in.
  4. Go to Settings → LoRa and check that the region is set for your country. A radio that has never been set up transmits nothing until it has one.
  5. Open Messages, choose a channel and press Y to write a message.

The Miyoo has no Bluetooth or USB radio support, so the start is different:

  1. Install the app from the zip, and turn on network time in Onion under Apps → Tweaks → Network.
  2. Turn on Wi-Fi on your radio: Meshtastic’s network setting, or MeshCore’s Wi-Fi companion firmware.
  3. Open MeshClient from Apps → MeshClient, go to the Radio tab, press A on devices, and type the radio’s address on the last row, such as 192.168.1.50 or, for MeshCore, 192.168.1.50:5000.
  4. Carry on from step 4 above: check the region, then send a message.
  • Controls lists what every button does.
  • Messages, Nodes and Map cover the main tabs.
  • Settings explains how changing your radio’s configuration works, and why the radio reboots afterwards.
  • Troubleshooting is the place to look when something doesn’t connect.