Deep Links

The app registers the meshtastic:/// URL scheme. Use Router.route(url:) to handle incoming URLs. Deep links work from Safari, Shortcuts, Siri Intents, and other apps.

Adding a New Deep Link

1. Add a case to the appropriate *NavigationState enum in Meshtastic/Router/NavigationState.swift.
2. Update Router's routing helpers in Meshtastic/Router/Router.swift.
3. Document the URL in the table below.

Messages

URL	Description
meshtastic:///messages	Messages tab
meshtastic:///messages?channelId={channelId}&messageId={messageId}	Channel messages (messageId is optional)
meshtastic:///messages?userNum={userNum}&messageId={messageId}	Direct messages (messageId is optional)

Connect

URL	Description
meshtastic:///connect	Connect tab

Nodes

URL	Description
meshtastic:///nodes	Nodes tab
meshtastic:///nodes?nodenum={nodenum}	Selected node

Map

URL	Description
meshtastic:///map	Map tab
meshtastic:///map?nodenum={nodenum}	Node on map
meshtastic:///map?waypointId={waypointId}	Waypoint on map

Settings

Settings URLs take no query parameters. The only path variant is localMeshDiscovery/history, which opens Local Mesh Discovery directly to its history view.

URL	Description
meshtastic:///settings/about	About Meshtastic
meshtastic:///settings/appSettings	App Settings
meshtastic:///settings/helpDocs	Help & Documentation
meshtastic:///settings/localMeshDiscovery	Local Mesh Discovery
meshtastic:///settings/localMeshDiscovery/history	Local Mesh Discovery (history view)
meshtastic:///settings/routes	Routes
meshtastic:///settings/routeRecorder	Route Recorder
Radio Config
meshtastic:///settings/lora	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. Config
meshtastic:///settings/channels	Channels
meshtastic:///settings/security	Security Config
meshtastic:///settings/shareQRCode	Share QRQRA scannable square code. In Meshtastic it encodes the Channel URL, which carries the channel and LoRa settings needed to join a mesh. Code
Device Config
meshtastic:///settings/user	User Config
meshtastic:///settings/bluetooth	Bluetooth Config
meshtastic:///settings/device	Device Config
meshtastic:///settings/display	Display Config
meshtastic:///settings/network	Network Config
meshtastic:///settings/position	Position Config
meshtastic:///settings/power	Power Config
Module Config
meshtastic:///settings/ambientLighting	Ambient Lighting
meshtastic:///settings/audio	Audio (Codec2, requires LORA_24 region)
meshtastic:///settings/cannedMessages	Canned Messages
meshtastic:///settings/detectionSensor	Detection Sensor
meshtastic:///settings/externalNotification	External Notification
meshtastic:///settings/mqtt	MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other.
meshtastic:///settings/neighborInfo	Neighbor Info
meshtastic:///settings/paxCounter	Pax Counter
meshtastic:///settings/rangeTest	Range Test
meshtastic:///settings/ringtone	Ringtone
meshtastic:///settings/serial	Serial
meshtastic:///settings/storeAndForward	Store & Forward
meshtastic:///settings/telemetry	Telemetry
meshtastic:///settings/trafficManagement	Traffic Management
TAKTAK (Team Awareness Kit). A situational awareness ecosystem. Meshtastic bridges to it by converting mesh messages to and from Cursor on Target format.
meshtastic:///settings/tak	TAKTAK (Team Awareness Kit). A situational awareness ecosystem. Meshtastic bridges to it by converting mesh messages to and from Cursor on Target format. Server
meshtastic:///settings/takConfig	TAKTAK (Team Awareness Kit). A situational awareness ecosystem. Meshtastic bridges to it by converting mesh messages to and from Cursor on Target format. Module Config
Logging
meshtastic:///settings/debugLogs	Debug Logs
Developers
meshtastic:///settings/backupManagement	Backup Management
meshtastic:///settings/coreDataBrowser	Data Browser (DEBUG only)
meshtastic:///settings/deviceLinks	Device Links
meshtastic:///settings/appFiles	App Files
meshtastic:///settings/tools	Tools (iOS 18+)
meshtastic:///settings/firmwareUpdates	Firmware Updates