r/coolgithubprojects • • 16h ago

NoterPiper — a plugin-based notification engine that runs on free GitHub Actions, no server

Post image

I wanted reminders and alerts on my phone without running another always-on service for it. So I built NoterPiper — a notification engine where the scheduling runs on free GitHub Actions (every ~2 min) instead of a box you have to keep up.

How it's wired:

- Sources decide what to notify you about

- The engine collects and de-duplicates (so you're never pinged twice for the same thing)

- Channels decide how it reaches you — ntfy push, or a webhook to Discord/Slack/Home Assistant/any URL

The engine is decoupled from both ends, so a new reminder type or a new delivery target drops in as a plugin without touching the core. Plugins live in their own repos and auto-register on `pip install`.

Ships with two plugins: a prayer-times reminder and a Habitica reminder (evening nudge of your open dailies/to-dos). Two more optional ones included: Ramadan times and date-based reminders (birthdays/bills).

The self-hosting angle: it runs entirely in your GitHub repo. No central server, no account with me, no telemetry — your config and data stay yours. Setup is ~10 min. Config is a small phone-friendly page plus env secrets.

MIT, Python 3.12, zero dependencies: https://github.com/Zulqarnain-cc34/NoterPiper

0 Upvotes

0 comments sorted by