meshtastic/Meshtastic-Apple
1
0
Fork 0
mirror of https://github.com/meshtastic/Meshtastic-Apple.git synced 2026-04-20 22:13:56 +00:00
Code Issues Projects Releases Packages Wiki Activity
Apple iOS, iPadOS & macOS Clients For Meshtastic
3834 commits 36 branches 1 tag 78 MiB
Find a file
Copilot b9e6fa9106
fix: remove invalid ASSETCATALOG_OTHER_FLAGS causing dSYM upload CI failures (#1669) 
The flag '--enable-icon-stack-fallback-generation=disabled' is not recognized
by actool on Xcode 16.x, causing every run of the 'Upload dSYM Files' workflow
to fail at the build step with exit code 65. Remove it from both the Debug and
Release build configurations.

Agent-Logs-Url: https://github.com/meshtastic/Meshtastic-Apple/sessions/fa589034-4017-44ea-9130-123a396d2abd

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: garthvh <1795163+garthvh@users.noreply.github.com>
2026-04-16 17:54:50 -07:00
.github feat: automated bug report analyzer via GitHub Models API (#1666) 2026-04-16 13:03:12 -07:00
ci_scripts update prebuild paths 2025-02-07 09:20:51 -08:00
itak-example-data-package 2.7.8 Working Changes (#1589) 2026-02-13 16:06:29 -08:00
Meshtastic Tak server improvements (#1603) 2026-04-02 10:34:01 -07:00
Meshtastic.xcodeproj fix: remove invalid ASSETCATALOG_OTHER_FLAGS causing dSYM upload CI failures (#1669) 2026-04-16 17:54:50 -07:00
Meshtastic.xcworkspace 2.7.6 Working Changes (#1479) 2025-12-21 12:15:01 -08:00
MeshtasticProtobufs 2.7.8 Working Changes (#1589) 2026-02-13 16:06:29 -08:00
MeshtasticTests Migrate test project to Swift Testing and add connect view and router tests (#1643) 2026-04-01 18:55:59 -07:00
protobufs@c8d5047b63 2.7.7 Working Changes (#1551) 2026-01-15 14:13:40 -08:00
scripts Transports Interface to Support TCP for all Platforms and Serial on Mac (#1341) 2025-08-27 08:09:02 -07:00
Settings.bundle Add german translations (#1383) 2025-09-11 18:49:47 -07:00
Widgets Transports Interface to Support TCP for all Platforms and Serial on Mac (#1341) 2025-08-27 08:09:02 -07:00
.gitignore Update .gitignore 2025-03-28 14:02:41 -07:00
.gitmodules Add back submodule 2024-05-01 19:55:39 -07:00
.swiftlint-precommit.yml Transports Interface to Support TCP for all Platforms and Serial on Mac (#1341) 2025-08-27 08:09:02 -07:00
.swiftlint.yml Transports Interface to Support TCP for all Platforms and Serial on Mac (#1341) 2025-08-27 08:09:02 -07:00
CONTRIBUTING.md Update references to GitLab to GitHub instead 2025-03-22 15:29:26 -04:00
LICENSE Create LICENSE 2022-01-24 04:53:59 -08:00
Localizable.xcstrings Tak server improvements (#1603) 2026-04-02 10:34:01 -07:00
meshtastic-1080x1080.png Update readme 2022-11-19 11:12:40 -08:00
README.md Add deep link documentation to README (#1655) 2026-04-05 17:59:11 -07:00
RELEASING.md Adding documentation describing how the project is managed, and adding a few scripts to assist with this 2024-07-09 19:01:32 -05:00

README.md

Meshtastic Apple Clients

Overview

SwiftUI client applications for iOS, iPadOS and macOS.

Getting Started

This project always uses the latest release version of XCode.

  1. Clone the repo. 
    git clone git@github.com:meshtastic/Meshtastic-Apple.git
  2. Open the local directory. 
    cd Meshtastic-Apple
  3. Set up git hooks to automatically lint the project when you commit changes. 
    ./scripts/setup-hooks.sh
  4. Open Meshtastic.xcworkspace 
    open Meshtastic.xcworkspace
  5. Build and run the Meshtastic target.

Technical Standards

Supported Operating Systems

The last two major operating system versions are supported on iOS, iPadOS and macOS.

Code Standards

  • Use SwiftUI
  • Use SFSymbols for icons
  • Use Core Data for persistence

Updating Protobufs:

  1. run
./scripts/gen_protos.sh
  1. Build, test, and commit the changes.

Deep Links

The app supports deep links using the meshtastic:/// URL scheme, for use with shortcuts, intents, and web pages.

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

Mesh Map

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

Settings

Each settings item has an associated deep link. No parameters are supported for settings URLs.

URL Description
meshtastic:///settings/about About Meshtastic
meshtastic:///settings/appSettings App Settings
meshtastic:///settings/routes Routes
meshtastic:///settings/routeRecorder Route Recorder
Radio Config
meshtastic:///settings/lora LoRa Config
meshtastic:///settings/channels Channels
meshtastic:///settings/security Security Config
meshtastic:///settings/shareQRCode Share QR 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/cannedMessages Canned Messages
meshtastic:///settings/detectionSensor Detection Sensor
meshtastic:///settings/externalNotification External Notification
meshtastic:///settings/mqtt MQTT
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
TAK
meshtastic:///settings/tak TAK Config
Logging
meshtastic:///settings/debugLogs Debug Logs
Developers
meshtastic:///settings/appFiles App Files
meshtastic:///settings/firmwareUpdates Firmware Updates

Release Process

For more information on how a new release of Meshtastic is managed, please refer to RELEASING.md

License

This project is licensed under the GPL v3. See the LICENSE file for details.