Desktop Notifications Specification
6 Categories #
Notifications can optionally have a type indicator. Although neither client or nor server must support this, some may choose to. Those servers implementing categories may use them to intelligently display the notification in a certain way, or group notifications of similar types.
Categories are in
class.specific form.
class specifies the generic type of notification, and
specific specifies the more specific type of
notification.
If a specific type of notification does not exist for your notification,
but the generic kind does, a notification of type
class is acceptable.
Third parties, when defining their own categories, should discuss
the possibility of standardizing on the hint with other parties, preferably
in a place such as the
xdg (http://freedesktop.org/mailman/listinfo/xdg)
mailing list at
freedesktop.org (http://freedesktop.org/). If it
warrants a standard, it will be added to the table above. If no
consensus is reached, the category should be in the form of
"x-vendor.class.name."
The following table lists standard notifications as defined by this spec. More will be added in time.
Table 2: Categories #
| Type | Description |
|---|---|
"device" | A generic device-related notification that doesn't fit into any other category. |
"device.added" | A device, such as a USB device, was added to the system. |
"device.error" | A device had some kind of error. |
"device.removed" | A device, such as a USB device, was removed from the system. |
"email" | A generic e-mail-related notification that doesn't fit into any other category. |
"email.arrived" | A new e-mail notification. |
"email.bounced" | A notification stating that an e-mail has bounced. |
"im" | A generic instant message-related notification that doesn't fit into any other category. |
"im.error" | An instant message error notification. |
"im.received" | A received instant message notification. |
"network" | A generic network notification that doesn't fit into any other category. |
"network.connected" |
A network connection notification, such as successful sign-on to a
network service. This should not be confused with
device.added for new network devices.
|
"network.disconnected" |
A network disconnected notification. This should not be confused with
device.removed for disconnected network devices.
|
"network.error" | A network-related or connection-related error. |
"presence" | A generic presence change notification that doesn't fit into any other category, such as going away or idle. |
"presence.offline" | An offline presence change notification. |
"presence.online" | An online presence change notification. |
"transfer" | A generic file transfer or download notification that doesn't fit into any other category. |
"transfer.complete" | A file transfer or download complete notification. |
"transfer.error" | A file transfer or download error. |