Send push notifications to your phone or desktop via PUT/POST
-- ntfy (pronounce: notify) is a simple HTTP-based pub-sub notification - service. - It allows you to send notifications to your phone or desktop via scripts from any computer, - entirely without signup, cost or setup. It's also open source if you want to run your own. -
-
- 
-
- 
- 
- 
-
- Publishing messages
-- Publishing messages can be done via PUT or POST. Topics are created on - the fly by subscribing or publishing to them. - Because there is no sign-up, the topic is essentially a password, so pick something that's - not easily guessable. -
-- Here's an example showing how to publish a message using a POST request (via curl -d): -
-
- curl -d "Backup successful 😀" ntfy.sh/mytopic
-
- - There are more features related to publishing messages: You can set a - notification priority, a title, - and tag messages. - Here's an example using some of them together: -
-
- curl \
- -H "Title: Unauthorized access detected" \
- -H "Priority: urgent" \
- -H "Tags: warning,skull" \
- -d "Remote access to $(hostname) detected. Act right away." \
- ntfy.sh/mytopic
-
- - Here's what that looks like in the Android app: -
-
- Subscribe to a topic
-- You can create and subscribe to a topic either using your phone, - in this web UI, or in your own app by subscribing via the API. -
- -Subscribe from your phone
-- Simply get the app and start publishing messages. To learn more about - the app, - check out the documentation. -
-
- 
- 
- 
-
- Here's a video showing the app in action: -
-Subscribe via web app
-- Subscribe to topics in the web app and receive messages as desktop - notification. - It is available at ntfy.sh/app. -
-
- Subscribe using the API
-- There's a super simple API that you can use to integrate your own app. You can consume - a JSON stream, - an SSE/EventSource stream, - a plain text stream, - or via WebSockets. -
-- Here's an example for JSON. The connection stays open, so you can retrieve messages as they - come in: -
-
- $ curl -s ntfy.sh/mytopic/json
- {`{"id":"SLiKI64DOt","time":1635528757,"event":"open","topic":"mytopic"}`}
- {`{"id":"hwQ2YpKdmg","time":1635528741,"event":"message","topic":"mytopic","message":"Hi!"}`}
- {`{"id":"DGUDShMCsc","time":1635528787,"event":"keepalive","topic":"mytopic"}`}
- ...
-
- - Here's a short video demonstrating it in action: -
-Check out the docs!
-- ntfy has so many more features and you can learn about all of them in the - documentation - (I tried my very best to make it the best docs ever 😉, not sure if I succeeded, hehe). -
-
- 100% open source & forever free
-- I love free software, and I'm doing this because it's fun. I have no bad intentions, and I will - never monetize or sell your information. This service will always stay - free and open. - You can read more in the FAQs and in the privacy - policy. -
- -