ntfy/README.md

58 lines
3.8 KiB
Markdown
Raw Normal View History

2021-11-03 15:38:46 +00:00
![ntfy](server/static/img/ntfy.png)
2021-12-05 21:28:12 +00:00
# ntfy.sh | Send push notifications to your phone or desktop via PUT/POST
2021-11-26 22:09:41 +00: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 20:39:42 +00: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-12-10 00:44:59 +00:00
[![Discord](https://img.shields.io/discord/874398661709295626)](https://discord.gg/cT7ECsZj9w)
2021-12-09 18:53:47 +00:00
[![Healthcheck](https://healthchecks.io/badge/68b65976-b3b0-4102-aec9-980921/kcoEgrLY.svg)](https://ntfy.statuspage.io/)
2021-10-23 01:26:01 +00:00
2021-11-20 21:02:05 +00: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 15:36:09 +00: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 15:33:34 +00:00
It's also open source (as you can plainly see) if you want to run your own.
2021-11-25 13:58:26 +00: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 15:33:34 +00:00
too.
2021-10-23 01:26:01 +00:00
2021-11-09 15:51:21 +00: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 21:28:12 +00:00
## **[Documentation](https://ntfy.sh/docs/)**
2021-10-23 01:26:01 +00:00
2021-12-05 21:28:12 +00: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 03:37:30 +00:00
2021-10-23 19:22:17 +00:00
## Contributing
I welcome any and all contributions. Just create a PR or an issue.
2021-11-26 22:09:41 +00:00
## Contact me
2021-12-10 00:44:59 +00:00
You can directly contact me **[on Discord](https://discord.gg/cT7ECsZj9w)**, or via the [GitHub issues](https://github.com/binwiederhier/ntfy/issues),
2021-11-26 22:09:41 +00:00
or find more contact information [on my website](https://heckel.io/about).
2021-10-23 19:22:17 +00:00
## License
2021-11-20 01:21:16 +00: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 18:51:49 +00: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 15:33:34 +00:00
* [GoReleaser](https://goreleaser.com/) (MIT) is used to create releases
2021-12-28 16:36:12 +00:00
* [go-smtp](https://github.com/emersion/go-smtp) (MIT) is used to receive e-mails
* [stretchr/testify](https://github.com/stretchr/testify) (MIT) is used for unit and integration tests
2021-11-03 15:33:34 +00:00
* [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
* [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 15:46:47 +00:00
* [Lightbox with vanilla JS](https://yossiabramov.com/blog/vanilla-js-lightbox)
2021-11-21 01:18:40 +00:00
* [Statically linking go-sqlite3](https://www.arp242.net/static-go.html)