1
0
Fork 0
forked from mirrors/ntfy
No description
Find a file
2021-10-23 15:22:17 -04:00
server Remove websockets, readme, better UI 2021-10-23 15:22:17 -04:00
.gitignore Initial commit 2021-10-22 18:54:02 -04:00
go.mod Works mostly 2021-10-22 21:26:01 -04:00
go.sum Works mostly 2021-10-22 21:26:01 -04:00
LICENSE Initial commit 2021-10-22 18:54:02 -04:00
main.go Works mostly 2021-10-22 21:26:01 -04:00
README.md Remove websockets, readme, better UI 2021-10-23 15:22:17 -04:00

ntfy

ntfy is a super simple pub-sub notification service. It allows you to send desktop and (soon) phone notifications via scripts. I run a free version of it on ntfy.sh. No signups or cost.

Usage

Subscribe to a topic

You can subscribe to a topic either in a web UI, or in your own app by subscribing to an SSE/EventSource or JSON feed.

Here's how to do it via curl see the SSE stream in curl:

curl -s localhost:9997/mytopic/sse

You can easily script it to execute any command when a message arrives:

while read json; do 
  msg="$(echo "$json" | jq -r .message)"
  notify-send "$msg"
done < <(stdbuf -i0 -o0 curl -s localhost:9997/mytopic/json)

Publish messages

Publishing messages can be done via PUT or POST using. Here's an example using curl:

curl -d "long process is done" ntfy.sh/mytopic

TODO

  • /raw endpoint
  • netcat usage
  • rate limiting / abuse protection
  • release/packaging

Contributing

I welcome any and all contributions. Just create a PR or an issue.

License

Made with ❤️ by Philipp C. Heckel, distributed under the Apache License 2.0.