ntfy - PUT/POST to your phone

ntfy - PUT/POST to your phone

Send notifications to your phone from any script using PUT/POST requests

Philipp C. Heckel Push

Screenshots

Screenshot of ntfy - PUT/POST to your phone Screenshot of ntfy - PUT/POST to your phone Screenshot of ntfy - PUT/POST to your phone Screenshot of ntfy - PUT/POST to your phone Screenshot of ntfy - PUT/POST to your phone Screenshot of ntfy - PUT/POST to your phone

Description

Send notifications to your phone from any Bash or PowerShell script, or from your own app using PUT/POST requests, e.g. via curl on Linux or Invoke-WebRequest.

ntfy is an Android client for https://ntfy.sh, a free and open source HTTP-based pub-sub service. You can subscribe to topics in this app, and then publish messages via a simple HTTP API.

Uses:
* Notify yourself when a long-running process is done
* Ping your phone when a backup has failed
* Alerts when someone logs into your server

Example:

$ curl -d "Your backup is done" ntfy.sh/mytopic

Find more examples and usage instructions here:
* Website: https://ntfy.sh
* GitHub (server): https://github.com/binwiederhier/ntfy
* GitHub (Android app): https://github.com/binwiederhier/ntfy-android

What’s new (1.25.2)

Features:
* Add configurable "Alert when connection is lost" setting, turned off by default (#1665, #1662, #1652, #1655, thanks to @tintamarre, @sjozs, @TheRealOne78, and @DAE51D for reporting)
* Handle "no network" gracefully: stop retrying when offline or in airplane mode, keep the foreground service alive with a "Waiting for network" notification, and resume automatically when connectivity returns (ntfy-android#165, thanks to @tintamarre, and #1709, thanks to @isaitgirl for reporting)
* Impro

Versions

Version Date Size Requires Android Download
1.25.2 current
b4baa6f668bd57ad…
2026-07-26 8.9 MB API 26
1.24.0
637c4cc5bb76bd1c…
2026-03-11 8.8 MB API 26
1.23.0
4c661ee7c8ca34d6…
2026-02-23 8.8 MB API 26

Permissions

What the app asks the system for. Android only grants sensitive access after you confirm it.

  • Internet accessSend and receive data over the internet.
  • Network stateCheck whether and how the device is connected.
  • Foreground serviceKeep running in the background, visible in the status bar.
  • FOREGROUND_SERVICE_SPECIAL_USE
  • Prevent sleepingKeep the device from going to sleep.
  • Run at startupStart automatically after the device is switched on.
  • VibrationControl the vibration alert.
  • Write storageCreate and change files on the device storage.
Show 5 more permissions
  • Exact alarmsTrigger actions at a precise time.
  • NotificationsShow notifications.
  • REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
  • ntfy.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • Read storageRead files on the device storage.

Comments