https://github.com/yantonov/ntfd
notification daemon) yet another webhook
https://github.com/yantonov/ntfd
Last synced: 3 months ago
JSON representation
notification daemon) yet another webhook
- Host: GitHub
- URL: https://github.com/yantonov/ntfd
- Owner: yantonov
- License: apache-2.0
- Created: 2021-04-10T07:07:07.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-12-25T18:50:15.000Z (7 months ago)
- Last Synced: 2025-03-29T07:51:29.581Z (4 months ago)
- Language: Rust
- Homepage:
- Size: 218 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/yantonov/ntfd/actions)
### Notification daemon
It is a tiny HTTP server that provides interface to trigger notifications.
In other words: it is a launcher with minimalistic HTTP interface.
#### Idea
To abstract a client from the notification handling details
and to provide only the mechanism to trigger notifications.
By the way, it's something similar to [webhook](https://github.com/adnanh/webhook)
#### Usage
Application exposes HTTP API on default port 4242.
You can trigger a notification, for example, like that:
```
curl 'http://127.0.0.1/notify/key'
```
The key is used to find a notification handler inside the configuration directory:
conf/key/run - an executable script which can contain any logic that you want.
If there is no handler then the default handler will be used (conf/default/run).
Directory structure:
```
directory
ntfd
conf/
handler1/
run
handler2/
run
default/
run
```
#### Inspired by
1. [Paukan](https://youtu.be/n1Fsz-I8Qag?t=285)
2. [Napalm Death - You Suffer](https://www.youtube.com/watch?v=ybGOT4d2Hs8)
3. [AnyBar](https://github.com/tonsky/AnyBar)
#### Examples
1. [You suffer](https://github.com/yantonov/ntfd/tree/master/examples/you_suffer).
2. [JSON payload](https://github.com/yantonov/ntfd/tree/master/examples/json_payload).