Skip to content

About

A native MeshCore client for Apple devices

Resources

Contributing

Stars

212 stars

Watchers

4 watching

Forks

Repository files navigation

MeshCore One (MC1)

A MeshCore client built for Apple devices in Swift.
Disclaimer: Decisions are made by a human, but almost all code is created with AI.

Download from the App Store or sideload using unsigned IPA files under Releases.

Download on the App Store

Features

Messaging

  • Direct messages with delivery status and flood retry
  • Channels (public, private, and hashtag)
  • Room Server connections with guest/participant modes
  • Heard repeats tracking
  • Message reactions (emoji)
  • View Path Hops (list and map)
  • Link/gif previews and inline images
  • Coordinate map previews
  • @Mentions
  • Per-conversation notification levels
  • Hashtag channel deep links
  • Filtering and blocking

Contacts

  • Auto-discovery on the mesh
  • QR code and advert sharing
  • Favorites
  • Zero-hop ping
  • Telemetry fetch
  • Edit Out Path

Map

  • Contact positions
  • Map layers (standard, satellite, topography)
  • Offline download

Network Tools

  • Trace Path - Route through specific repeaters with option to save paths
  • Line of Sight - Terrain analysis with Fresnel zone and RF parameters
  • RX Log - Live packet capture
  • Noise Floor Monitor - Live dBm chart with signal quality stats
  • CLI Terminal - Remote command-line access to repeaters and rooms

Remote Node Management

  • Node status (telemetry such as battery and uptime. Neighbors for repeaters)
  • Remote repeater/room configuration (radio, behavior, identity, reboot)
  • Telemetry history charts
  • Admin and guest authentication for repeaters/rooms

Companion Device

  • Bluetooth and WiFi pairing
  • Radio presets and manual tuning (frequency, TX power, spreading factor, bandwidth)
  • Battery monitoring with OCV curves
  • Repeat mode

General

  • Live Activity
  • Themes
  • Offline mesh networking (no internet required)
  • Push notifications with quick reply
  • Location sharing controls
  • Config import/export
  • App data backup/restore

Requirements

  • iOS/iPadOS 18.0+, or Apple Silicon Mac
  • MeshCore-compatible hardware

Getting Started

  1. Install XcodeGen.
  2. Run make generate (creates a gitignored dev.yml — set your Apple team ID there for local signing).
  3. Open MC1.xcodeproj.

For more details, see the Development Guide.

Acknowledgements

Thank you to the MeshCore dev team and all its contributors for contributing their time, money, and energy. This project would not exist without their hard work and dedication.

This project uses a fork of swiftui-messaging-ui which has helped tremendously with the chat view experience.

Maps use MapLibre Native. Emoji data comes from Emojibase, through the emojibase-bindings package.

License

MeshCore One - GNU General Public License v3.0
Swift MeshCore - MIT

About

A native MeshCore client for Apple devices

Resources

Contributing

Stars

212 stars

Watchers

4 watching

Forks

Releases

Sponsor this project

Contributors

Languages