Skip to content

Latest commit

 

History

History
54 lines (33 loc) · 1.98 KB

README.md

File metadata and controls

54 lines (33 loc) · 1.98 KB

notify

go.dev reference Go Report Card Build

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:

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
  • v0.9.0: some breaking changes
  • 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.

Clone repo and go to examples folder:

go run main.go

TODO

  • 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 for great ideas on receiving signals.

Thanks to Merovius for fixing race during Close().

License

BSD 3-Clause