tauler-notify 0.6.3

Desktop notification (D-Bus) data source for the tauler status bar
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# tauler-notify

A desktop notification data source for the [tauler](https://crates.io/crates/tauler)
status bar.

It is a real freedesktop notification daemon: it claims
`org.freedesktop.Notifications` on the session bus, so applications send it notifications
the usual way. Instead of drawing popups it emits the current notification list on
stdout, leaving the presentation entirely to your layout.

Because it takes the D-Bus name, it replaces daemons like dunst or mako rather than
running alongside them.

## Install

```sh
cargo install tauler-notify
```

## Use from a layout

```jsx
<Module bin="/home/you/.cargo/bin/tauler-notify">
  {(data, events) =>
    data?.notifications?.map(n => (
      <div class="flex flex-col px-2 py-1" on_click={events.dismiss({ id: n.id })}>
        <span class="text-[11px] opacity-60">{n.app_name}</span>
        <span class="text-[13px] text-white">{n.summary}</span>
      </div>
    ))
  }
</Module>
```

## Protocol

Emitted on stdout, one object per line, whenever the set of live notifications changes:

```json
{
  "notifications": [
    { "id": 1, "app_name": "Slack", "summary": "New message", "body": "…", "urgency": 1 }
  ]
}
```

`urgency` follows the freedesktop scale: `0` low, `1` normal, `2` critical.

Accepted on stdin:

| intent | effect |
|---|---|
| `{"type": "dismiss", "id": 42}` | close notification 42 and emit `NotificationClosed` |

Notifications expire on their own timeout (the spec's default of 5 s when the client
asks for the server default, never for a timeout of `0`).

When stdin closes the parent bar is gone, so the daemon exits rather than lingering and
holding the D-Bus name.

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or
[MIT license](LICENSE-MIT) at your option.