Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
apps:notifyd:spec [2016/10/03 23:54] – ochosi | apps:notifyd:spec [2020/08/11 23:34] – kevinbowen |
---|
| {{ :apps:xfce4-notifyd.png?nolink|}} |
| ~~NOTOC~~ |
===== Freedesktop.org Notifications specification ===== | ===== Freedesktop.org Notifications specification ===== |
| |
For the most part, xfce4-notifyd is compliant with the fd.o notifications specification. However there are also some features which it lacks, e.g. persistency or sound. The following section will try to give an overview. | For the most part, xfce4-notifyd is compliant with the [[https://developer.gnome.org/notification-spec|freedesktop.org's notifications specification]]. However, there are also some features which are not currently supported (e.g. sound). Another example is "urgency", which is only implicitly supported by checking the expire-timeout. |
| |
| The following table provides an overview of the features of the specification supported by the xfce4-notifyd service. |
| |
| <note>Please note that the [[https://developer.gnome.org/notification-spec/#basic-design|"default action"]], which is usually triggered by clicking a notification bubble **is not implemented** in xfce4-notifyd. Clicking a notification instead closes it. If applications want to provide actions they have to specify the tuple of action-id and action for a button to be shown in the bubble.</note> |
| |
^ Hint ^ Value Type ^ Description ^ Spec Version ^ Supported by notifyd ^ | ^ Hint ^ Value Type ^ Description ^ Spec Version ^ Supported by notifyd ^ |
| "sound-name"|string|A themeable named sound from the freedesktop.org sound naming specification to play when the notification pops up. Similar to icon-name, only for sounds. An example would be "message-new-instant". | | No | | | "sound-name"|string|A themeable named sound from the freedesktop.org sound naming specification to play when the notification pops up. Similar to icon-name, only for sounds. An example would be "message-new-instant". | | No | |
| "suppress-sound"|boolean|Causes the server to suppress playing any sounds, if it has that ability. This is usually set when the client itself is going to play its own sound. | | No | | | "suppress-sound"|boolean|Causes the server to suppress playing any sounds, if it has that ability. This is usually set when the client itself is going to play its own sound. | | No | |
| "transient"|boolean|When set the server will treat the notification as transient and by-pass the server's persistence capability, if it should exist. |>= 1.2 | No | | | **"transient"**|**boolean**|**When set the server will treat the notification as transient and by-pass the server's persistence capability, if it should exist.** |**>= 1.2** | **Yes** | |
| "x"|int|Specifies the X location on the screen that the notification should point to. The "y" hint must also be specified. | | No | | | "x"|int|Specifies the X location on the screen that the notification should point to. The "y" hint must also be specified. | | No | |
| "y"|int|Specifies the Y location on the screen that the notification should point to. The "x" hint must also be specified. | | No | | | "y"|int|Specifies the Y location on the screen that the notification should point to. The "x" hint must also be specified. | | No | |
| **"urgency"**|**byte**|**The urgency level.** | |**Yes** | | | "urgency" | byte | The urgency level. | | No | |
| |
===== Other Notifications specifications ===== | ===== Other Notifications specifications ===== |
| |
| * Ubuntu's [[https://wiki.ubuntu.com/NotifyOSD|Notify-OSD]] and its [[https://wiki.ubuntu.com/NotificationDevelopmentGuidelines|Development Guidelines]] |
| * KDE's [[https://api.kde.org/frameworks/knotifications/html/classKNotification.html|KNotification API]] |
| |
| [[|Back to Top]] |
| ---- |
| [[:apps:notifyd:start:|Back to xfce4-notifyd main page]] |
| |