ntfy Android app fork for CentralCloud oncall push notifications
Find a file
Mikael Hugo 6d389ea6af sms: relay inbound SMS to centralcloud-ops (Phase 2)
Whitelisted incoming SMS are forwarded to the centralcloud-ops
phone-relay endpoint as a redundant inbound path alongside Twilio.

  io.heckel.ntfy.sms.SmsRelayPreferences
    SharedPreferences-backed config — enabled flag, base URL, device id,
    sender whitelist (Set<String>). Strict opt-in: forward nothing unless
    explicitly enabled AND a non-empty whitelist matches the sender.

  io.heckel.ntfy.sms.SmsRelayReceiver
    BroadcastReceiver bound to SMS_RECEIVED_ACTION. Extracts the sender +
    concatenated body of multi-part SMS, applies the whitelist, and
    enqueues a OneTimeWorkRequest for forwarding. Wraps everything in
    try/catch so a failure on this hot path can never crash the device's
    SMS handling.

  io.heckel.ntfy.sms.SmsForwardWorker
    CoroutineWorker that POSTs to {baseUrl}/api/sms/inbound/phone-relay
    with X-Device-Id auth. Uses HttpUtil.defaultClient and JSONObject
    (no new deps). 4xx -> permanent drop, 5xx/network -> WorkManager
    exponential backoff retry. WorkManager constraints require a
    connected network so retries don't fire while offline.

  Manifest registration (uses-permission RECEIVE_SMS / READ_SMS, receiver
  declaration) is left as WIP in the working tree pending the broader
  managed-config / branding changes also in progress on the manifest.
  Commit those together (or in a follow-up) to make the receiver actually
  bind.

  No settings UI yet — set values via SharedPreferences directly or wait
  for the Phase 2.1 settings screen.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 18:34:31 +02:00
.github/ISSUE_TEMPLATE Block new issues 2025-09-24 20:10:35 -04:00
app sms: relay inbound SMS to centralcloud-ops (Phase 2) 2026-05-11 18:34:31 +02:00
fastlane/metadata/android Bump, review; update 5->3min 2026-04-10 21:45:01 -04:00
gradle/wrapper Bump Gradle wrapper 2025-12-18 01:00:21 +01:00
.envrc sms: relay inbound SMS to centralcloud-ops (Phase 2) 2026-05-11 18:34:31 +02:00
.gitignore .gitignore update 2025-09-21 19:35:17 -04:00
build.gradle Update gradle 2026-01-16 13:45:55 -05:00
flake.nix sms: relay inbound SMS to centralcloud-ops (Phase 2) 2026-05-11 18:34:31 +02:00
gradle.properties Gradle props update 2026-01-16 14:44:48 -05:00
gradlew Bump Gradle wrapper 2025-12-18 01:00:21 +01:00
gradlew.bat Bump Gradle wrapper 2025-12-18 01:00:21 +01:00
LICENSE Initial commit based on original flower example 2021-10-25 09:01:10 -04:00
README.md Remove broken version warning for ntfy 1.17.0 2025-09-23 12:34:09 -04:00
settings.gradle Move repository definitions to settings.gradle 2025-12-18 01:12:54 +01:00
TESTING.md Testing 2021-11-29 15:36:41 -05:00

ntfy Android App

This is the Android app for ntfy (ntfy.sh). You can find the app in F-Droid or the Play Store, or as .apk files on the GitHub releases page.

If you're downloading the APKs from GitHub, they are signed with a certificate with the following SHA-256 fingerprint: 6e145d7ae685eff75468e5067e03a6c3645453343e4e181dac8b6b17ff67489d. You can also query the DNS TXT records for ntfy.sh to find this fingerprint.

Build

For up-to-date building instructions, please see the official docs.

Translations

We're using Weblate to translate the ntfy Android app. We'd love your participation.

Translation status

License

Made with ❤️ by Philipp C. Heckel, distributed under the Apache License 2.0.

Thank you to these fantastic resources: