Skip to main content
Version: 2.8

Messages sharing extension

The MeshtasticMessages target is an iMessage app extension embedded in the main iOS app. It supports three share types:

  • Contact exchange cards using Meshtastic /v/ contact URLs.
  • Channel cards using the existing /e/ channel URL format.
  • Static original Chirpy and official Meshtastic design-repository stickers.

All bundled sticker and Messages icon artwork comes directly from the official meshtastic/design repository. The extension does not use AI-generated or redrawn brand artwork.

Screenshots​

Contact and channel cards in MessagesContact exchange composer
Received Meshtastic contact card and stickers in MessagesContact exchange composer
Received selected-channel card and contact card in MessagesChannel-sharing composer with Replace selected

Recent radio snapshot​

After configuration or node-database synchronization completes, the main app serializes the active radio's own contact, LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. configuration, and active channels into MeshShareSnapshot. MeshShareStore keeps that snapshot in the device-only Keychain access group shared by the app and extension. This lets Messages share the most recently connected radio while the radio is offline.

Snapshots older than 30 days remain usable but display a warning.

Contact exchange​

Initial contact cards include exchange=true. Selecting one in Messages offers Add & Reply with Mine. That action inserts the local contact reply into the same conversation, without the exchange flag, and then opens the main app to confirm the incoming contact import. Removing the flag from replies prevents an endless exchange prompt.

Legacy contact links without the query remain supported.

Channel behavior​

All active channels start selected and can be deselected. Replace is the default and includes the sender's LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. configuration. Add mode uses the existing ?add=true URL behavior and omits LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. configuration. Encrypted channel PSKsPSK (Pre-Shared Key). A secret code or passphrase used in Meshtastic channels for encryption, ensuring that only devices with the matching PSK can communicate within that specific channel. are preserved, and the extension warns the sender before sharing.

Security notes​

  • Snapshot Keychain accessibility is kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly.
  • The snapshot does not sync through iCloud.
  • Raw contact or channel payloads are not logged.
  • Incoming contacts still require confirmation in the main app.