MeshCore TEAM

MeshCore TEAM User Guide

MeshCore TEAM is an Android and iOS app for keeping a group together when there’s no cell signal. Your phone connects over Bluetooth to a MeshCore companion radio, and the radios carry your team’s positions, messages, waypoints and routes over a LoRa mesh. No accounts, no servers and no internet are needed.

This guide covers setting the app up, getting a team tracking each other on the map, and every screen after that. It describes version 1.2.


What you need

Stock or custom firmware

TEAM works with stock MeshCore companion firmware. Custom TEAM firmware adds a few extras:

Feature Stock firmware Custom firmware
Messaging, contacts, channels, map, tracking, Team Config ✓ ✓
Smart forwarding (radios relay team traffic automatically when someone is out of direct range) – ✓
Autonomous mode (the radio keeps sending your position using its own GPS, even with the phone off or out of range) – ✓

The app detects your firmware when you connect. Settings that need custom firmware are hidden when you’re on stock firmware.


1. First launch

The first time you open the app, it takes you through three steps.

  1. Choose your language. Pick English, Deutsch, Español, Français, Italiano, Nederlands or Português, or Use device language. You can change it later in App settings.
  2. Permissions. The app explains what it needs and why, including how your location is used, before any system prompt appears:
    • Bluetooth to connect to your mesh radio.
    • Location to show you on the map and share your position with your team.
    • Notifications to alert you when messages arrive.
    • Background to keep the radio connection and tracking running when the app isn’t on screen.

    Your location goes over your radio to your team only. It is never uploaded to a server.

  3. Set your name. This is the name your team sees. See Your two names before you answer. You can skip it and set it later.

On Android you’ll also be asked to turn off battery optimization for the app. Tap Allow. Otherwise Android may cut the Bluetooth link when the screen turns off, and tracking stops.

On iOS you’ll see the blue location indicator while tracking runs in the background. That’s expected.


2. Connect to your radio

Connection screen before scanning
Not connected
Scanning for radios
Scanning
Connected radio
Connected
  1. Open the Connection screen. Tap the Bluetooth icon in the top bar, or open the ☰ menu and choose Connection.
  2. Tap the search button. Nearby MeshCore radios appear in a list.
  3. Tap your radio. The app connects and syncs contacts, channels and waiting messages from it (Syncing Contacts… Syncing Channels… Syncing Messages…).
  4. The first time you connect a radio, you’re asked to Set Identity, which is the radio name. See the next section.

Once connected, the card at the top shows the radio’s name, ID, battery voltage and firmware. FW: Custom • FWD ✓ • AUTO ✓ means custom firmware with forwarding and autonomous mode available. The card also has two buttons:

Below the card:

The app reconnects to the same radio automatically if the link drops. To stop it trying, tap the Bluetooth icon and choose Stop reconnecting.


3. Your two names

Set Identity dialog
Setting the radio name
Set your name dialog
Setting your name

You have two names, and they’re seen by different people.

  Radio name Your name
Who sees it Everyone on the mesh, including people outside your team Only your team (people on your tracking channel)
Where to set it Asked the first time you connect a radio. Change it under Connection → Companion Settings → Device Name Asked on first launch. Change it under App Settings → General
Tip Consider something anonymous Use the name your team knows you by

Your team sees your name on the map, in contacts, in chat and in notifications, with your radio name underneath. Everyone else sees only the radio name. Replies and @mentions always use radio names, so your name is never sent into a public channel.

If you leave your name blank, your team sees your radio name instead.


4. Getting around

The app has three tabs along the bottom: Contacts, Channels and Map.

The top bar on every screen shows:


5. Set up your team (quick start)

This is the most important part. It gets everyone on your team showing on each other’s maps.

Tracking works over a private channel. Everyone on the team joins the same private channel and sends their position on it. Only people with that channel’s key can read those positions. Public and hashtag channels can’t be used for tracking, because anyone can work out their key.

  1. One person creates the channel. Go to Channels, tap + and choose Create Private Channel. Give it a name, for example Alpha Team.
  2. Share it with the team. Open the channel, tap its share button, and show the QR code or send the link. Everyone else goes to Channels → + → Add via Link / QR Code and scans or pastes it.
  3. Everyone turns on tracking. Tap the location-sharing icon in the top bar, or go to App Settings → Location → Location Tracking, and switch it on. If you have only one private channel it’s picked automatically. Otherwise you’re asked which channel to share your location on.
  4. Check the map. Within a couple of update intervals, teammates appear on the Map tab. The app adds team members as contacts for you. You don’t need to swap keys by hand.

Faster option: the team leader can put the channel, radio settings, waypoints and offline maps into a single Team Config file that everyone imports in one step.

Treat channel links and QR codes like passwords. Anyone who has one can join the channel and see your team’s positions and messages.


6. Location tracking

Location tracking settings
App Settings → Location

Tracking settings are in App Settings → Location.

The channel you’re sharing on is marked Location sharing on in the Channels list.

When tracking is off, your position isn’t sent and teammates are hidden from your map.


7. Contacts and direct messages

Heard nearby

Your radio no longer stores every device it hears. Devices it hears but doesn’t add appear under Heard nearby at the top of Contacts, with Add and Dismiss buttons. Team members sharing location on your tracking channel are always added for you. Entries you ignore disappear after 7 days.

Repeaters, room servers and sensors are still added to the radio as normal.

Note: this setting stays on the radio. If you stop using TEAM, turn contact auto-add back on from any MeshCore app.


8. Channels and messaging

Tap + on the Channels tab to:

Other channel features:

Messages

Team channels

A team channel is a private channel that belongs to your phone rather than to one radio. Your tracking channel becomes a team channel automatically, and you can make any private channel one with the Team channel switch in its long-press menu.

Switching to a different radio

Your team is remembered by the app, not the radio. When you pair a new radio, the app copies your team contacts onto it and sends an advert so the team learns the new radio. Team channels, chat history and last known positions stay on the phone. Your teammates keep seeing you as the same person, even if you swap radios with one of them.


9. The map

Topographic map
Map
Satellite map
Satellite view
Map settings menu
Map settings menu

The map shows you, your teammates, waypoints and routes.

Top bar

Buttons on the right

Teammates on the map

Teammates appear when they’ve sent a position in the last 12 hours. Each marker’s color shows how recently and how directly they were heard:

Color Meaning
🟢 Green Heard directly in the last 5 minutes
🟡 Yellow Heard through 1–3 relays in the last 5 minutes
🟠 Orange Heard through more than 3 relays in the last 5 minutes
🔴 Red Not heard for 5–10 minutes
⚪ Grey Not heard for over 10 minutes

Tap a marker to see the person’s hop count, last heard time, coordinates and battery (radio and phone). From there you can Show/Hide Path, Navigate to them, Direct message them, or Remove from group to hide them from your map. Double-tap a marker for a quick summary.

Offline maps

Download map areas before you lose signal.

  1. Pan and zoom the map so the area you want fills the screen.
  2. Choose Gear → Download Map Area.
  3. Give it a name, set the zoom range (higher zoom means more detail and a bigger download) and tap Download.

Tiles are saved from the base map you have selected. Saved areas work with no connection at all. You can manage or delete them, and see how much storage they use, from Manage Offline Maps. They can also go into a Team Config.

Imported maps (KMZ and MBTiles)

Manage Imported Maps → Import Map accepts:

They’re drawn on top of the base map in the right place. Show or hide each one from the Layers menu or the Imported Maps screen.

Waypoints

Add waypoint dialog
Add waypoint
  1. Tap + and choose Create Waypoint.
  2. Move the map so the + crosshair in the middle sits on the spot, then tap ✓.
  3. Enter a name, pick a type (Camp, Meetup, Danger, Game Area, Deer Stand, Water, Vehicle or Custom), and add an optional description.
  4. Turn on Share with team when saved to send it to your team. It appears on their maps automatically.

Tap a waypoint on the map to Navigate to it, Share via Mesh, edit it or delete it.

Manage Waypoints & Routes lists everything, split into local (yours) and received (from teammates). From there you can:

Routes

Drawing a route
Drawing a route

Routes are multi-point paths, useful for trails, patrol routes or a planned line of travel.

  1. Tap + and choose Create Route.
  2. Tap the map to add points in order. The start is green and the end is red. To move a point, tap it and then tap its new position. Undo removes the last point.
  3. Tap ✓, then give the route a name, an optional description and a Route Color. Turn on Share with team when saved to send it to your team.

A route needs at least two points. To change the points later, tap the route on the map and choose Edit Route Points. To change its name, description or color, use Edit Route Info in Manage Waypoints & Routes. You can only edit waypoints and routes you created, not ones received from teammates.


10. Team Config: set everyone up at once

Team Config menu
Connection ⋮ menu
Create Team Config screen
Create Team Config

A Team Config is a single .teamcfg.zip file containing channels, radio settings, waypoints, routes, offline map areas and overlay maps. The team leader makes one, and everyone else imports it to be set up in one step.

Create a config

  1. Connect to your radio and open the ⋮ menu on the Connection screen.
  2. Choose Create Team Config.
  3. Enter a Config Name (for example Team Alpha), then choose what to include: Radio Settings, Channels, Waypoints & Routes, Offline Map Areas and Overlay Maps. Each section has Select All.
  4. Tap Export Config and save or share the file (messaging app, email, USB and so on).

Import a config

  1. Connect to your radio. Importing needs a connection because channels have to be written to the radio.
  2. Open the ⋮ menu and choose Import Team Config.
  3. Pick From File, or From QR Code if someone is sharing offline (below).
  4. Check the preview and tap Import. The channels go onto your radio, the radio settings are applied, and waypoints and maps are added. Duplicates are skipped.

Note: transmit power isn’t included. Each radio keeps its own power setting.

Share a config with no internet

Share Config Offline sends a config directly from phone to phone over a Wi-Fi hotspot.

Sender

  1. ⋮ menu → Share Config Offline.
  2. Follow the on-screen steps (iPhone or Android) to turn on your phone’s hotspot, then tap Continue.
  3. Choose File to pick the .teamcfg.zip, check the details and tap Confirm. A QR code appears, with a manual download address underneath.
  4. Tap Finished when everyone has it. This stops sharing.

Each receiver

  1. Join the sender’s Wi-Fi hotspot.
  2. Connect to your own radio, then go to ⋮ menu → Import Team Config → From QR Code.
  3. Scan the sender’s QR code, check the preview and tap Import.

11. Radio settings

Radio settings dialog
Radio Settings

Open Connection → Companion Settings → Radio Settings.

Tap Apply to send the changes to the radio.


12. App settings

General and appearance settings
General & appearance
Data and Android settings
Data & Android
Red Light Discipline theme
Red Light Discipline

Open ☰ menu → App Settings.

General

Appearance

Location

Data

Android


13. Wiping data

Open the ⋮ menu on the Connection screen and choose Wipe Local Data. Tick any of:

Tap Wipe Selected and confirm. It can’t be undone.


Troubleshooting

Problem What to try
No radios found when scanning Check that Bluetooth and Location permissions are allowed. On Android 12 and later, also allow Nearby devices. Make sure Bluetooth is on, the radio is on, and it isn’t connected to another phone.
Connection drops when the screen is off (Android) Allow the battery optimization exemption, and let the app run in the background in your phone’s battery settings.
Tracking turns itself off with “Create a private channel first” You have no private channel to share on. Create or join one, then turn tracking on again.
Teammates don’t show on the map Check that tracking is on for everyone, everyone picked the same channel, and all radios use the same radio settings. People only appear after they’ve sent a position in the last 12 hours.
“Not on this radio” on a channel The connected radio doesn’t have that channel. Tap Add. If the radio is full, delete an unused channel first.
Can’t message a contact It’s a repeater. Repeaters can’t receive direct messages.
Autonomous mode won’t turn on It needs custom firmware and a radio with a GPS module. Error ERR 6 means the radio has no GPS.
Forwarding never activates It needs custom firmware and tracking turned on. In camp mode, also turn on Smart Forwarding.
Someone is out of range Use camp mode or smart forwarding so radios in between relay traffic, or add a MeshCore repeater.

Help and privacy