ntfy Android app fork for CentralCloud oncall push notifications
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>
|
||
|---|---|---|
| .github/ISSUE_TEMPLATE | ||
| app | ||
| fastlane/metadata/android | ||
| gradle/wrapper | ||
| .envrc | ||
| .gitignore | ||
| build.gradle | ||
| flake.nix | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle | ||
| TESTING.md | ||
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.
License
Made with ❤️ by Philipp C. Heckel, distributed under the Apache License 2.0.
Thank you to these fantastic resources:
- RecyclerViewKotlin (Apache 2.0)
- Just another Hacker News Android client (MIT)
- Android Room with a View (Apache 2.0)
- Firebase Messaging Example (Apache 2.0)
- Designing a logo with Inkscape
- Foreground service
- github/gemoji (MIT) for as data source for an up-to-date emoji.json file
- emoji-java (MIT) has been stripped and inlined to use the emoji.json file