ntfy Android app fork for CentralCloud oncall push notifications
Find a file
Mikael Hugo 52809f6ed4 sms: device heartbeat + last-forward tracking (Phase 2 Slice B)
So centralcloud-ops can SEE that this phone is alive and the SMS relay
is working. Server side (POST /api/devices/heartbeat + /devices LiveView)
landed in centralcloud_ops commit 6a7f22e.

  DeviceHeartbeatWorker
    Periodic CoroutineWorker (15min, the WorkManager floor) that POSTs
    sms_relay state + device_state to /api/devices/heartbeat.

    sms_relay summary: enabled, whitelist_size, last_forward_at,
                       failure_count_24h.
    device_state:      battery_level, is_charging, network_type,
                       low_power_mode, dnd_active, ringer_mode.
    DND read via NotificationManager.currentInterruptionFilter — works
    on API 23+ without notification policy access permission.

    Skips (Result.success) when relay isn't configured yet — no point
    spamming the server, but the schedule stays alive so it picks up
    automatically as soon as config lands.

  SmsRelayInit
    One-liner bootstrap. Call from Application.onCreate when your
    managed-config / branding WIP merges:
        SmsRelayInit.start(this)
    Idempotent (WorkManager KEEP policy) so safe across cold starts.

  SmsRelayPreferences (extended)
    Tracks lastForwardAtMs (epoch-ms, set by SmsForwardWorker on 200)
    and failureCount24h (rolling, reset by heartbeat on success).

  SmsForwardWorker (extended)
    On 200 → record lastForwardAtMs. On 4xx/5xx/exception → bump
    failureCount24h. Heartbeat then reports both up to the server,
    which renders them on the /devices LiveView.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 18:41:57 +02:00
.github/ISSUE_TEMPLATE Block new issues 2025-09-24 20:10:35 -04:00
app sms: device heartbeat + last-forward tracking (Phase 2 Slice B) 2026-05-11 18:41:57 +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: