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. +
+ +