Foghorn

Foghorn is a UnifiedPush distributor for Sailfish OS. It supports the Mozilla push service or ntfy.sh (either the public instance or a self-hosted one). With this app installed, other applications can register for push notifications. It does nothing by itself. Unleash the toot toot.

• Sailfish OS Apps: Can be used to provide push notifications for any supported app, which currently includes Livewire, Doomsday, and xmatic.
• Android Apps (Experimental): If enabled, Foghorn can be used as a UnifiedPush distributor for compatible Android apps. See more below.

Push Services

UnifiedPush supports arbitrary push notification services as the transport for receiving push notifications on-device. Foghorn can currently receive push notifications via:

• Mozilla Autopush: This is the default mode of operation, and recommended if you don't want to fiddle with anything.
• ntfy (public instance or self-hosted): This is recommended if you want more control over where push notifications actually travel.
• Nextcloud: An alternative to ntfy. If a Nextcloud account on your Sailfish OS device supports UnifiedPush, it will show up in Foghorn. Requires authenticating Foghorn with Nextcloud separately.

Android App Support (Experimental)

If enabled, Foghorn will expose itself to the running Android container, and Android apps supporting UnifiedPush (Fennec, Ironfox, Element X, among others) can register with Foghorn to provide push notifications. This is accomplished by a service running on the Sailfish OS side that listens for the setting being enabled. When enabled, an APK is installed in Android App Support. This APK communicates with foghornd (Foghorn's actual notification service) via a local network socket. Communication between foghornd and the APK is secured with a shared secret.

Note that the service that manages the setting sync with Android AppSupport runs as root. This is used to install or remove the APK required for Android to see Foghorn. foghornd itself is a user service, and notifications are dispatched to the Android APK via this user service.

Please update to 0.6.1 ASAP if you are on 0.6.0. 0.6.0 causes a boot lock-up due to a circular systemd service dependency. To immediately fix this on 0.6.0, please run:

devel-su rm /etc/systemd/system/multi-user.target.wants/foghorn-appsupport-sync@*.path

And turn off the Android Apps setting. This problem is fixed in 0.6.1.

Integrating Your App

The app exposes a custom UnifiedPush permission and a guide to integration is available.

For Rust apps, you can use Leghorn.

Information

• License: AGPLv3.0+
• Code: https://git.agnos.is/projectmoon/foghorn