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.
101 lines
2.7 KiB
101 lines
2.7 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:
|
|
|
|
Arguments:
|
|
application name = identifier
|
|
id - if 0 or not existing will create new notification, otherwise
|
|
icon - local path if provided - the text is not displayed
|
|
title
|
|
desctiotion
|
|
actions
|
|
hints
|
|
expire time (milisec) - if -1 server default (5sec), if 0 - no expiration
|
|
|
|
gdbus call \
|
|
--session \
|
|
--dest org.freedesktop.Notifications \
|
|
--object-path /org/freedesktop/Notifications \
|
|
--method org.freedesktop.Notifications.Notify \
|
|
"identifier" \
|
|
"0" \
|
|
"" \
|
|
"Notification title" \
|
|
"Notification description" \
|
|
"[]" \
|
|
"{}" \
|
|
"2000"
|
|
|
|
In d-feet
|
|
"identifier", 0, "", "Notification title", "Notification description", [], {}, 30000
|
|
|
|
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:
|
|
(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"
|