aboutsummaryrefslogtreecommitdiffstats
path: root/notifications/README.md
blob: e71237a82d8c8d39200db9bb661aaef0022d42d0 (plain)
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
# notifications

The balloon renderer for the notification daemon (`notifyd`, a separate repo).
It reads the daemon's published files through the `Notify` singleton and draws
one balloon per live notification, bottom-right of `DP-1`.

## Suppression lives here

The daemon does not know about DND or snooze. This component withholds
balloons: `status.dnd` suppresses low and normal, `notifyd/snooze` suppresses
everything. The drawer's reserved space lists every live notification anyway.

## The files are the interface

    $XDG_RUNTIME_DIR/notifyd/queue.json      the live queue
    $XDG_RUNTIME_DIR/notifyd/history.json    the ring of 20
    $XDG_RUNTIME_DIR/notifyd/drawer          "1" while the drawer holds the space
    $XDG_RUNTIME_DIR/notifyd/snooze          an epoch second while snoozing

`notifyctl` and `notify-snooze.sh` are in `~/bin`; without them the balloons
draw but close and actions do nothing.

## Blur

Hyprland blurs a layer surface only when a rule names its namespace. This
component sets `quickshell-notifications`; the rule is in
`~/.config/hypr/sections/decorations.lua`.