You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kdbusnotification/README

89 lines
2.3 KiB

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"