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
|
# notify
[](https://pkg.go.dev/github.com/esiqveland/notify?tab=doc)
[](https://goreportcard.com/report/github.com/esiqveland/notify)
Notify is a go library for interacting with the dbus notification service defined by freedesktop.org:
https://developer.gnome.org/notification-spec/
`notify` can deliver desktop notifications over dbus, ala how libnotify does it.
Please note `notify` is still in motion and APIs are not locked until a 1.0 is released.
More testers are very welcome =)
Depends on:
- [godbus](https://github.com/godbus/dbus).
## Changelog
- v0.11.2: Introduce helpers ExpireTimeoutSetByNotificationServer, ExpireTimeoutNever
- v0.11.1: Fix a race during Close() #11
- v0.11.0: re-release under BSD license
- v0.10.0: stricter types: [some breaking changes](https://github.com/esiqveland/notify/releases/tag/v0.10.0)
- v0.9.0: [some breaking changes](https://github.com/esiqveland/notify/releases/tag/v0.9.0)
- v0.2.1: dbus: gomod: lock to dbus v5
- v0.2.0: `Notifier.Close()` no longer calls `.Close()` on the underlying `dbus.Conn`
## Quick intro
See example: [main.go](https://github.com/esiqveland/notify/blob/master/example/main.go).
Clone repo and go to examples folder:
``` go run main.go ```
## TODO
- [x] Add callback support aka dbus signals.
- [ ] Tests. I am very interested in any ideas for writing some (useful) tests for this.
## See also
The Gnome notification spec https://developer.gnome.org/notification-spec/.
## Contributors
Thanks to user [emersion](https://github.com/emersion) for great ideas on receiving signals.
Thanks to [Merovius](https://github.com/Merovius) for fixing race during Close().
## License
BSD 3-Clause
|
