kdbusnotification/README

 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/

To test the implementation use following: 

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"

To test hypertext

gdbus call \
    --session \
    --dest org.freedesktop.Notifications \
    --object-path /org/freedesktop/Notifications \
    --method org.freedesktop.Notifications.Notify \
    "<b>Identifier</b>" \
    "5" \
    "/usr/share/icons/hicolor/72x72/mimetypes/virtualbox-vbox.png" \
    "<b>Notification title</b>" \
    "<b>Notification:</b><br/>Some Text here" \
    "[]" \
    "{}" \
    "2000"