https://github.com/gutenye/email-notification
An elegant email notification service
https://github.com/gutenye/email-notification
cloudflare-workers email-notification jellyfin komodo ntfy self-hosted selfhost service simple
Last synced: about 1 month ago
JSON representation
An elegant email notification service
- Host: GitHub
- URL: https://github.com/gutenye/email-notification
- Owner: gutenye
- License: other
- Created: 2025-09-02T06:45:55.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T03:09:18.000Z (2 months ago)
- Last Synced: 2026-05-23T05:37:45.118Z (about 1 month ago)
- Topics: cloudflare-workers, email-notification, jellyfin, komodo, ntfy, self-hosted, selfhost, service, simple
- Language: TypeScript
- Homepage:
- Size: 354 KB
- Stars: 5
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 💌 Guten Email Notification 💌
**An elegant email notification service**: Zero configuration, ntfy-like, supports popular apps out of the box, including: Jellyfin, Komodo, and more.
**Show your ❤️ and support by starring this project and following the author, [Guten Ye](https://github.com/gutenye)!**
[](https://github.com/gutenye/email-notification)
[](https://github.com/gutenye/email-notification/blob/main/LICENSE)
[](https://github.com/gutenye/email-notification#-contribute)
[](https://www.typescriptlang.org)
[](https://workers.cloudflare.com/)
## 🌠️ Screenshots
## ✨ The Most Elegant Way to Send Email Notifications
```sh
curl NOTIFICATION_URL -d 'Title\nBody'
```
That’s your email — delivered.
✅ Just a single HTTP request
✅ First line → your title
✅ Next line → your body
✅ That’s it
**Perfect for:** Deployment complete, Server alert, Backup finished, Github Actions, Shell script, Self-hosted apps, NAS systems, monitoring tools, CI/CD pipelines
## 🌟 Features
- **Email Notifications**: Keep your notification history in your email inbox - never lose important alerts
- **Simple to use**: REST API with just a title and body - simple and elegant
- **Zero configuration**: Deploy once, works everywhere - just add url and start sending
- **Custom Templates**: Write templates in JavaScript - no more Handlebars or Go templates needed
- **Universal App Support**: Get notified from everything on your NAS - Jellyfin, Komodo, and 20+ more apps
- **Human-friendly messages**: Clean, readable notifications that anyone can understand
- **Free & Unlimited Emails**: Send as many notifications as you want, no limits, no hidden fees
## 📖 Documentation
- [Send Messages](./docs/SendMessages.md): API usage, examples, and advanced features
- [Quick Deploy](./docs/Deployment.md): One-click deployment to Cloudflare Workers
- [Supported Apps](./src/templates/Apps.md): Pre-built templates for popular apps
- [Development](./docs/Development.md): Local setup and development guide
## 🤝 Contributing
We love contributions! Whether you're fixing bugs, adding features, or improving documentation, your involvement makes this project better.
**How to Contribute:**
1. **Fork** the Repository
2. **Make** your changes (bug fixes, features, docs)
3. **Test** your changes thoroughly
4. **Open** a Pull Request on GitHub
**Looking for ideas?** Check out our [issues](https://github.com/gutenye/email-notification/issues) for bugs and feature requests!
---
Thank you for using Guten Email Notification! If you found it helpful, please ⭐️ **star the project** ⭐ on GitHub.
**Need help?** Check our [documentation](#-documentation) or [report an issue](https://github.com/gutenye/email-notification/issues) if you encounter any problems.
**Special Thanks to All Contributors:**
[](https://github.com/gutenye/email-notification/graphs/contributors)
---
⬆ Back to top ⬆
Made with ❤️ by Guten Ye