Skip to content

Repository files navigation

GitHub commit activity GitHub Issues or Pull Requests GitHub Release

 

Inertia for iOS

An decentralised, cross-platform communication client for iOS.
Built by humans, for humans.

Inertia is a pure Swift client for Reticulum, LXMF, and NomadNet. It's designed to provide a simple entrypoint for privacy-conscious people to try out a truly decentralised network, without needing to buy new gear.

THIS IS ALPHA SOFTWARE. DO NOT RELY ON THIS FOR CRITICAL COMMUNICATION, AND EXPECT YOUR DATA TO BE LOST EVERY TIME A NEW VERSION IS INSTALLED.

Features

  • Send and receive encrypted messages without relying on traditional cloud providers
  • Communicate with users on other clients (Sideband, MeshChat, Columba)

Planned

  • First install/setup flow
  • Key importing/exporting
  • Accessibility and contrast in UI elements
  • Auto-interface support
  • Access pages on the Nomad Network
  • Use propagation nodes to stop messages from being lost in transit
  • Send/receive images and other files
  • Support for rnsh, RRC, RetiBBS, and other services
  • Calls via LXST
  • Paper messages
  • RNode/LoRa support
  • CI/CD flows
  • Reproducible builds & code-signing
  • Blocking/favouriting contacts
  • Bookmarking Nomad Network pages
  • NomadNet and LXMF URL scheme
  • iOS Shortcuts support
  • Getting a better logo

Contact

Building & Contributing

Requires iOS >26.0 and XCode >26.0. Dependencies are managed by SPM.

  1. Clone the repository
  2. brew install xcodegen
  3. cd into the repository
  4. xcodegen generate
  5. Open the generated Inertia.xcodeproj in XCode.
  6. Set signing team
  7. Run build

Pull requests are more than welcome (please look at the project board if you want to contribute but don't know what's needed), but AI usage in any manner will result in the PR being ignored and immediately closed.


Inertia is powered by Reticulum, LXMF, and NomadNet.


FAQ

Why "Inertia"?

Coming from Meshtastic and MeshCore, the idea of a more powerful decentralised protocol that allows for files and hosted pages was extremely appealing. However, my primary device was an iPhone, and no Reticulum client existed for iOS. Thus, the inertia of not having support on my primary device delayed my use of the platform. This project exists so that nobody else has to consider changing their workflow or device to use Reticulum.

AI?

No thanks. See AI.md for more information.

Why isn't [feature] implemented yet?

Unfortunately, writing code by hand still takes longer than getting AI to do it. While AI would probably massively speed up development on this project, it also introduces security and trust issues between the developer and the end user.

Development bounties are something I might consider if the project grows in popularity, but for now I'm mainly focused on getting the basics working correctly.

Can I give you money?

Many options are available:

Licensing

All contents of the repository are licensed under the MIT license.

Content which are considered artistic works, such as icons, are dual-licensed under MIT and CC-BY-4.0. This covers any files in the assets/ folder, and any copies of those files elsewhere in the project.

Upstream packages

  • Swift-Sodium is licensed under the ISC licence, which is considered compatible with the MIT license.

About

Reticulum/LXMF client for iOS

Resources

Stars

30 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages