diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 70 |
1 files changed, 70 insertions, 0 deletions
@@ -0,0 +1,70 @@ + + kdbusnotification - a DBUS notification service for TDE. + + +Kdbusnotification is a small program for the Trinity Desktop that +displays DBUS notifications via passive popups. + + + + + CONTRIBUTING +============== + +If you wish to contribute to Kdbusnotification (TDE), you might do so: + +- TDE Gitea Workspace (TGW) collaboration tool. + https://mirror.git.trinitydesktop.org/gitea + +- TDE Weblate Translation Workspace (TWTW) collaboration tool. + https://mirror.git.trinitydesktop.org/weblate + + DOCUMENTATION +=============== + +https://specifications.freedesktop.org/notification-spec/latest/ar01s09.html +https://sylvaindurand.org/update-notifications-with-libnotify/ + +gdbus call \ + --session \ + --dest org.freedesktop.Notifications \ + --object-path /org/freedesktop/Notifications \ + --method org.freedesktop.Notifications.Notify \ + "identifier" \ + "1" \ + "" \ + "Notification title" \ + "Notification description" \ + "[]" \ + "{}" \ + "2000" + +The second identifier (here 1) concerns the id of the notification we wish to replace, +we will come back to this shortly. +The next identifier allows you to define an icon. +"[]" allows you to define actions, "{}" to define hints, +and finally the last argument 2000 presents the time during which the notification +must remain visible (in milliseconds). + +Once this command is executed, the system returns a response that looks like : + +(uint32 13,) + +This number, here 13, is the id of the notification that we will be able to replace. + +This means that the following command will not create a new notification, but will +replace the one we just created: + +gdbus call \ + --session \ + --dest org.freedesktop.Notifications \ + --object-path /org/freedesktop/Notifications \ + --method org.freedesktop.Notifications.Notify \ + "identifier" \ + "13" \ + "" \ + "My updated title" \ + "My updated description" \ + "[]" \ + "{}" \ + "2000" |