https://github.com/esiqveland/notify

notify is a go dbus implementation for delivering desktop notifications over dbus
https://github.com/esiqveland/notify

dbus deliver-notifications gnome

Last synced: 6 months ago
JSON representation

notify is a go dbus implementation for delivering desktop notifications over dbus

• Host: GitHub
• URL: https://github.com/esiqveland/notify
• Owner: esiqveland
• License: bsd-3-clause
• Created: 2015-07-28T18:05:48.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2024-06-09T13:52:01.000Z (about 2 years ago)
• Last Synced: 2024-06-18T15:19:48.262Z (about 2 years ago)
• Topics: dbus, deliver-notifications, gnome
• Language: Go
• Homepage:
• Size: 650 KB
• Stars: 68
• Watchers: 4
• Forks: 14
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# notify

[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/github.com/esiqveland/notify?tab=doc)

[![Go Report Card](https://goreportcard.com/badge/github.com/esiqveland/notify)](https://goreportcard.com/report/github.com/esiqveland/notify)

![Build](https://github.com/esiqveland/notify/actions/workflows/go.yml/badge.svg?branch=master)

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