2021-11-03 16:38:46 +01:00
![ntfy ](server/static/img/ntfy.png )
2021-12-05 22:28:12 +01:00
# ntfy.sh | Send push notifications to your phone or desktop via PUT/POST
2021-11-26 23:09:41 +01:00
[![Release ](https://img.shields.io/github/release/binwiederhier/ntfy.svg?color=success&style=flat-square )](https://github.com/binwiederhier/ntfy/releases/latest)
2021-12-07 21:39:42 +01:00
[![Go Reference ](https://pkg.go.dev/badge/heckel.io/ntfy.svg )](https://pkg.go.dev/heckel.io/ntfy)
[![Tests ](https://github.com/binwiederhier/ntfy/workflows/test/badge.svg )](https://github.com/binwiederhier/ntfy/actions)
[![Go Report Card ](https://goreportcard.com/badge/github.com/binwiederhier/ntfy )](https://goreportcard.com/report/github.com/binwiederhier/ntfy)
[![codecov ](https://codecov.io/gh/binwiederhier/ntfy/branch/main/graph/badge.svg?token=A597KQ463G )](https://codecov.io/gh/binwiederhier/ntfy)
2021-11-26 23:09:41 +01:00
[![Slack channel ](https://img.shields.io/badge/slack-@gophers/binwiederhier-success.svg?logo=slack )](https://gophers.slack.com/archives/C01JMTPGF2Q)
2021-12-09 19:53:47 +01:00
[![Healthcheck ](https://healthchecks.io/badge/68b65976-b3b0-4102-aec9-980921/kcoEgrLY.svg )](https://ntfy.statuspage.io/)
2021-10-23 03:26:01 +02:00
2021-11-20 22:02:05 +01:00
**ntfy** (pronounce: *notify* ) is a simple HTTP-based [pub-sub ](https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern ) notification service.
2021-11-03 16:36:09 +01:00
It allows you to **send notifications to your phone or desktop via scripts** from any computer, entirely **without signup or cost** .
2021-11-03 16:33:34 +01:00
It's also open source (as you can plainly see) if you want to run your own.
2021-11-25 14:58:26 +01:00
I run a free version of it at ** [ntfy.sh ](https://ntfy.sh )**, and there's an [open source ](https://github.com/binwiederhier/ntfy-android ) [Android app ](https://play.google.com/store/apps/details?id=io.heckel.ntfy )
2021-11-03 16:33:34 +01:00
too.
2021-10-23 03:26:01 +02:00
2021-11-09 16:51:21 +01:00
< p >
< img src = "server/static/img/screenshot-curl.png" height = "180" >
< img src = "server/static/img/screenshot-web-detail.png" height = "180" >
< img src = "server/static/img/screenshot-phone-main.jpg" height = "180" >
< img src = "server/static/img/screenshot-phone-detail.jpg" height = "180" >
< img src = "server/static/img/screenshot-phone-notification.jpg" height = "180" >
< / p >
2021-12-05 22:28:12 +01:00
## **[Documentation](https://ntfy.sh/docs/)**
2021-10-23 03:26:01 +02:00
2021-12-05 22:28:12 +01:00
[Getting started ](https://ntfy.sh/docs/ ) |
[Android/iOS ](https://ntfy.sh/docs/subscribe/phone/ ) |
[API ](https://ntfy.sh/docs/publish/ ) |
[Install / Self-hosting ](https://ntfy.sh/docs/install/ ) |
[Building ](https://ntfy.sh/docs/develop/ )
2021-10-24 05:37:30 +02:00
2021-10-23 21:22:17 +02:00
## Contributing
I welcome any and all contributions. Just create a PR or an issue.
2021-11-26 23:09:41 +01:00
## Contact me
You can directly contact me [on Slack ](https://gophers.slack.com/archives/C01JMTPGF2Q ), or via the [GitHub issues ](https://github.com/binwiederhier/ntfy/issues ),
or find more contact information [on my website ](https://heckel.io/about ).
2021-10-23 21:22:17 +02:00
## License
2021-11-20 02:21:16 +01:00
Made with ❤️ by [Philipp C. Heckel ](https://heckel.io ).
The project is dual licensed under the [Apache License 2.0 ](LICENSE ) and the [GPLv2 License ](LICENSE.GPLv2 ).
2021-10-24 20:51:49 +02:00
Third party libraries and resources:
* [github.com/urfave/cli/v2 ](https://github.com/urfave/cli/v2 ) (MIT) is used to drive the CLI
* [Mixkit sound ](https://mixkit.co/free-sound-effects/notification/ ) (Mixkit Free License) used as notification sound
* [Lato Font ](https://www.latofonts.com/ ) (OFL) is used as a font in the Web UI
2021-11-03 16:33:34 +01:00
* [GoReleaser ](https://goreleaser.com/ ) (MIT) is used to create releases
* [github.com/mattn/go-sqlite3 ](https://github.com/mattn/go-sqlite3 ) (MIT) is used to provide the persistent message cache
* [Firebase Admin SDK ](https://github.com/firebase/firebase-admin-go ) (Apache 2.0) is used to send FCM messages
2021-11-29 15:34:43 +01:00
* [github/gemoji ](https://github.com/github/gemoji ) (MIT) is used for emoji support (specifically the [emoji.json ](https://raw.githubusercontent.com/github/gemoji/master/db/emoji.json ) file)
2021-11-09 16:46:47 +01:00
* [Lightbox with vanilla JS ](https://yossiabramov.com/blog/vanilla-js-lightbox )
2021-11-21 02:18:40 +01:00
* [Statically linking go-sqlite3 ](https://www.arp242.net/static-go.html )