Skip to content

Do common tasks in the MeshCore app

Choose the task you need. These screenshots show one MeshCore mobile app layout; names and positions may move in another app version.

Before you start

  • Connect the app to your companion.
  • Confirm the companion can send and receive locally.
  • Do not post private keys, passwords, or precise private locations in a shared screenshot.

Use this when another person needs to add you as a contact.

  1. Open the MeshCore app and connect to your companion.

  2. Open the Signal screen.

    Signal control in the MeshCore app

  3. Select Advert, then To Clipboard.

    Advert menu with the To Clipboard action

  4. Paste the contact link into the conversation where you intend to share it.

The clipboard now contains a contact link that another MeshCore user can import.

Use this after another person sends you their MeshCore contact link.

  1. Copy only the contact link, then connect the app to your companion.

  2. Open the three-dot menu.

    Three-dot menu in the MeshCore app

  3. Select Add Contact.

    Add Contact action

  4. Select Import from Clipboard Link.

    Import from Clipboard Link action

  5. Wait for the success message and the new-contact notice.

    Successful contact import message

The named contact now appears in your contact list.

If the import fails, copy the original link again without extra words or punctuation. Ask the sender for a new link if it still fails.

Trace a path

A manual trace tests the repeater sequence you select. It does not guarantee that later messages will use the same path.

Open the trace tool

  1. Connect the app to your companion.

  2. Open the three-dot menu.

    Three-dot menu in the MeshCore app

  3. Select Tools.

    Tools action in the MeshCore app

  4. Select Trace Path - Manual.

    Manual trace-path action

  5. Select the plus button to add a repeater.

    Add-repeater button in the manual trace tool

Trace one repeater

  1. Add one repeater and make sure its identifier is correct.

    One repeater selected for a trace

    One-hop path ready to trace

  2. Select Trace Path.

Trace through several repeaters

  1. Add the repeaters in the forward order required by the path.

  2. Add the return sequence shown by your local path plan.

    Multiple repeaters selected for a trace

  3. Review the complete sequence, then select Trace.

    Multi-hop path ready to trace

  4. Read the result.

    Multi-hop trace result

If you do not know the forward and return sequence, ask the local community instead of guessing repeater identifiers.

Check heard repeats

A heard repeat means your companion received a repeated copy of a packet it sent. A missing repeat does not by itself show where the packet failed: the repeater may not have heard the packet, or your companion may not have heard the repeated copy.

  1. Send a message in the intended channel.

  2. When Heard n repeats appears below the message, press and hold the message.

    Message showing a heard-repeat count

  3. Select Heard Repeats.

    Heard Repeats action

  4. Review the repeaters your companion heard for that packet.

    List of repeaters heard by the companion

  5. Select a repeater to inspect the reported path.

Example: direct repeat

Diagram of a direct heard repeat

App view of a direct heard repeat

Example: multi-hop repeat

Diagram of a multi-hop heard repeat

App view of a multi-hop heard repeat

Need help?

If a result is missing or unclear, compare one known-good nearby node and then use Get help. Include the task and step where you stopped, but remove sensitive values before sharing a screenshot.