Through the additional of a secondary signalling channel, whenever there are sufficient messages in the queue to fill a "batch", the processing goroutine will be immediately woken. Because the buffered channel has double that capacity, requests should never be delayed unless the server is actually overloaded. This preserves the improvements of the previous commit, meaning that, even when a batch size of 10 and a batch delay of 1s is used: - there is no background load; if no messages are received, the server is dormant; - if no message was received in the last second, a new message will be immediately processed; - if a small number of messages are received after the first, the additional messages will be collected and processed in a single transaction after the configured delay; - if enough new messages arrive to fill a batch (ie 10 in this example), they will be immediately processed, freeing up capacity for more messages; - if up to double the configured number of messages arrive in a burst, there will be sufficient capacity to cache them immediately, regardless of how slowly the mysql server commits each transaction |
||
---|---|---|
.github | ||
assets | ||
auth | ||
client | ||
cmd | ||
docs | ||
examples | ||
log | ||
scripts | ||
server | ||
test | ||
tools/fbsend | ||
util | ||
web | ||
.gitignore | ||
.gitpod.yml | ||
.goreleaser.yml | ||
CODE_OF_CONDUCT.md | ||
docker-compose.yml | ||
Dockerfile | ||
go.mod | ||
go.sum | ||
LICENSE | ||
LICENSE.GPLv2 | ||
main.go | ||
Makefile | ||
mkdocs.yml | ||
README.md | ||
requirements.txt |
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. There's also an open source Android app (see Google Play or F-Droid), and an open source iOS app (see App Store).
Documentation
Getting started | Android/iOS | API | Install / Self-hosting | Building
Chat / forum
There are a few ways to get in touch with me and/or the rest of the community. Feel free to use any of these methods. Whatever works best for you:
- Discord server - direct chat with the community
- Matrix room #ntfy (+ Matrix space) - same chat, bridged from Discord
- Reddit r/ntfy - asynchronous forum (new as of October 2022)
- GitHub issues - questions, features, bugs
- Email - reach me directly (I usually prefer the other methods)
Announcements / beta testers
For announcements of new releases and cutting-edge beta versions, please subscribe to the ntfy.sh/announcements topic. If you'd like to test the iOS app, join TestFlight. For Android betas, join Discord/Matrix (I'll eventually make a testing channel in Google Play).
Contributing
I welcome any and all contributions. Just create a PR or an issue. For larger features/ideas, please reach out on Discord/Matrix first to see if I'd accept them. 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.
Sponsors
I have just very recently started accepting donations via GitHub Sponsors. I would be humbled if you helped me carry the server and developer account costs. Even small donations are very much appreciated. A big fat Thank You to the folks already sponsoring ntfy:
I'd also like to thank JetBrains for providing their awesome IntelliJ IDEA to me for free, and DigitalOcean for supporting the project with $60/yr:
Code of Conduct
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
Please be sure to read the complete Code of Conduct.
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 (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