Send push notifications to your phone or desktop using PUT/POST

curl notifications ntfy ntfysh pubsub push-notifications rest-api

Go to file

Philipp Heckel d4fe2052c7 Release notes		2022-03-26 13:33:16 -04:00
.github/workflows	Re-embed fonts	2022-03-05 21:15:40 -05:00
assets	Styling	2021-10-24 14:22:53 -04:00
auth	Reduce bcrypt cost to 10	2022-02-07 22:09:31 -05:00
client	Add support for auth in client config	2022-02-17 20:38:33 +01:00
cmd	Remove urfave/cli workaround	2022-03-16 14:50:00 -04:00
docs	Release notes	2022-03-26 13:33:16 -04:00
examples	Python examples; that's all; closes #50	2021-12-15 20:37:21 -05:00
scripts	Emojis, formatting, clear all	2022-02-24 12:26:07 -05:00
server	Add Allow-Origin: *, because YOLO	2022-03-25 17:17:24 -04:00
test	Do not print ugly WS error; tests	2022-01-15 22:33:35 -05:00
tools/fbsend	Webhooks (#55 ), more tests (#35 ) and python examples (#50 )	2021-12-15 16:12:40 -05:00
util	Gzip static responses	2022-03-10 21:55:56 -05:00
web	Fix date formatting issue in example	2022-03-24 13:17:04 -04:00
.gitignore	Embed new web UI into server	2022-03-05 20:24:10 -05:00
.goreleaser.yml	Lots of development instructions, Makefile things	2022-03-18 13:53:52 -04:00
Dockerfile	Makefile, Dockerfile, GoReleaser, config.yml, systemd service	2021-10-23 21:29:45 -04:00
LICENSE	Update LICENSE	2021-12-05 12:51:08 -05:00
LICENSE.GPLv2	Update LICENSE.GPLv2	2021-12-05 12:52:20 -05:00
Makefile	Refinement	2022-03-18 17:18:52 -04:00
README.md	Update README.md	2022-03-25 18:56:22 -04:00
go.mod	Update deps	2022-03-22 19:54:20 -04:00
go.sum	Update deps	2022-03-22 19:54:20 -04:00
main.go	Remove urfave/cli workaround	2022-03-16 14:50:00 -04:00
mkdocs.yml	Docs, release notes	2022-02-27 15:45:43 -05:00
requirements.txt	Try it a better way	2022-03-24 19:27:07 -04:00

README.md

ntfy.sh | 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 or cost. It's also open source (as you can plainly see) if you want to run your own.

I run a free version of it at ntfy.sh, and there's an open source Android app too.

Documentation

Getting started | Android/iOS | API | Install / Self-hosting | Building

Contributing

I welcome any and all contributions. Just create a PR or an issue. To contribute code, check out the build instructions for the server and the Android app. Or, if you'd like to help translate 🇩🇪 🇺🇸 🇧🇬, you can start immediately in Hosted Weblate.

Contact me

You can directly contact me on Discord or on Matrix (bridged from Discord), or via the GitHub issues, or find more contact information on my website.

License

Made with ❤️ by Philipp C. Heckel.
The project is dual licensed under the Apache License 2.0 and the GPLv2 License.

Third party libraries and resources:

github.com/urfave/cli/v2 (MIT) is used to drive the CLI
Mixkit sounds (Mixkit Free License) are used as notification sounds
Sounds from notificationsounds.com (Creative Commons Attribution) are used as notification sounds
Roboto Font (Apache 2.0) is used as a font in everything web
React (MIT) is used for the web app
Material UI components (MIT) are used in the web app
MUI dashboard template (MIT) was used as a basis for the web app
Dexie.js (Apache 2.0) is used for web app persistence in IndexedDB
GoReleaser (MIT) is used to create releases
go-smtp (MIT) is used to receive e-mails
stretchr/testify (MIT) is used for unit and integration tests
github.com/mattn/go-sqlite3 (MIT) is used to provide the persistent message cache
Firebase Admin SDK (Apache 2.0) is used to send FCM messages
github/gemoji (MIT) is used for emoji support (specifically the emoji.json file)
Lightbox with vanilla JS as a lightbox on the landing page
HTTP middleware for gzip compression (MIT) is used for serving static files
Regex for auto-linking (MIT) is used to highlight links (the library is not used)
Statically linking go-sqlite3
Linked tabs in mkdocs