/airmessage-server

AirMessage's native message relay server for Mac

Primary LanguageSwiftApache License 2.0Apache-2.0

AirMessage Server

AirMessage for Android and AirMessage for web connected to AirMessage Server

AirMessage lets people use iMessage on the devices they like. AirMessage Server functions as the bridge between AirMessage client apps and iMessage by running as a service on a Mac computer.

Other AirMessage repositories: Android | Web | Connect (community)

Getting started

As AirMessage Server runs on OS X 10.10, this repository targets Xcode 13. To compile with Xcode 14, change the deployment target to macOS 10.13.

To generate a universal OpenSSL binary to link, run Configure.command in the OpenSSL directory.

AirMessage Server uses a configuration file to associate with online services like Firebase and Sentry. The app will not build without valid configuration files, so to get started quickly, you can copy the provided default file to use a pre-configured Firebase project, or you may provide your own Firebase configuration file:

  • AirMessage/Secrets.default.xcconfig > AirMessage/Secrets.xcconfig

Building and running for AirMessage Connect

In order to help developers get started quickly, we host a separate open-source version of AirMessage Connect at connect-open.airmessage.org. The default configuration is pre-configured to authenticate and connect to this server. Since this version of AirMessage Connect is hosted in a separate environment from official servers, you will have to connect client apps to the same AirMessage Connect server.

We kindly ask that you do not use AirMessage's official Connect servers with any unofficial builds of AirMessage-compatible software.


Thank you for your interest in contributing to AirMessage! You're helping to shape the future of an open, secure messaging market. Should you have any questions, comments, or concerns, please shoot an email to hello@airmessage.org.