Author SHA1 Message Date
jpportaandhermes-bot 233ad01bee feat: add ntfy-notify home-manager module for desktop kanban notifications (#1)
Adds a new home-manager module `ntfy-notify` that delivers kanban state changes as Linux desktop notifications via **ntfy.sh** + `notify-send` → SwayNC.

**What it does:**
- Installs `ntfy` package
- Creates `~/.config/ntfy/client.yml` with subscription to the `joao-kanban` topic
- Sets up `ntfy-notify.service` (systemd --user) as a persistent subscriber
- Each incoming message fires `notify-send -u critical` → picked up by SwayNC
- Configurable: `server` URL, `subscriptions` list, per-topic priority

**Usage:**
After deploy, start the service once:
```bash
systemctl --user daemon-reload
systemctl --user start ntfy-notify
```

**Companion:** A cron job on the VPS will be needed to push kanban events to the ntfy topic (separate task).

Closes kanban task t_322419fa on ndots board.

---------

Co-authored-by: hermes-bot <hermes@srv1239749>
Reviewed-on: #1
2026-07-22 10:09:23 -03:00
2 changed files with 18 additions and 10 deletions
-1
View File
@@ -1 +0,0 @@
.worktrees/
+18 -9
View File
@@ -6,6 +6,15 @@
}: }:
let let
cfg = config.custom.ntfy-notify; cfg = config.custom.ntfy-notify;
# Escape the whole command string for the YAML config. Since ntfy reads this
# from client.yml directly (not from systemd), we pass notify-send arguments
# as a shell command string — ntfy will spawn a shell to run it.
mkSubscription = topic: priority:
lib.generators.toYaml { } [{
topic = "${cfg.server}/${topic}";
command = ''notify-send -a "Kanban" -u "${priority}" "Kanban Update" "''${m}"'';
}];
in in
{ {
options.custom.ntfy-notify = { options.custom.ntfy-notify = {
@@ -45,21 +54,19 @@ in
}; };
config = lib.mkIf cfg.enable { config = lib.mkIf cfg.enable {
home.packages = [ pkgs.ntfy-sh ]; home.packages = [ pkgs.ntfy ];
# Client config with subscription → notify-send command mappings. # Client config with subscription → notify-send mappings.
# ntfy subscribe (without args) reads subscriptions from client.yml. # ntfy subscribe (without args) reads subscriptions from here.
xdg.configFile."ntfy/client.yml" = { xdg.configFile."ntfy/client.yml" = {
text = '' text = ''
# Generated by ndots ntfy-notify module. # Generated by ndots ntfy-notify module.
# Each message spawns notify-send your notification daemon. # Each incoming message spawns a notify-send your notification daemon.
subscribe: subscribe:
'' + lib.concatMapStringsSep "\n" (sub: '' + lib.concatMapStringsSep "\n" (sub:
let
cmd = "notify-send -a Kanban -u ${sub.priority} \"Kanban Update\" \"$m\"";
in
" - topic: ${cfg.server}/${sub.topic}\n" " - topic: ${cfg.server}/${sub.topic}\n"
+ " command: ${cmd}" + " command: >-\n"
+ '' notify-send -a "Kanban" -u "${sub.priority}" "Kanban Update" "$m"''
) cfg.subscriptions; ) cfg.subscriptions;
}; };
@@ -71,7 +78,9 @@ in
}; };
Service = { Service = {
Type = "simple"; Type = "simple";
ExecStart = "${pkgs.ntfy-sh}/bin/ntfy subscribe"; ExecStart = ''
${pkgs.ntfy}/bin/ntfy subscribe
'';
Restart = "on-failure"; Restart = "on-failure";
RestartSec = 10; RestartSec = 10;
}; };