blob: 9aab0e9b500716e9c8ba4c0865f6f8d5585ba06d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
# Introduction
This specification defines the management of visual items, usually icons used for reporting the status of an application to the user or provide a quick access to common actions performed by that application. It is intended to be complementary but not directly related with the Freedesktop's Desktop Notifications specification and is aimed as a replacement to the Freedesktop System tray specification.
This specification does not define what the aspect of the Notification Items will be, this is strictly implementation specific.
Example use cases will include:
* Mixer volume control.
* Battery indicator.
* Instant messenger on-line status.
* Generic application information and actions, like a media player controls.
# Basic Design
The Status Notifier Item system relies on inter-process communication via D-BUS and is composed by three parts:
* [[StatusNotifierItem|Specifications/StatusNotifierItem/StatusNotifierItem]]: each application that wants to utilize the system registers its own [[StatusNotifierItem|Specifications/StatusNotifierItem/StatusNotifierItem]] to the session bus.
* [[StatusNotifierWatcher]]: service used to keep track of every active instance of [[StatusNotifierItem]], used by [[StatusNotifierHost]] to get the list of all items. It also notifies it when items are added and removed.
* [[StatusNotifierHost]]: an application that wants to provide a visualization of the existing [[StatusNotifierItem]] instances must register a [[StatusNotifierHost]] in the session bus.
[[Markup]]
[[Specifications/StatusNotifierItem/Icons]]
# Previous Discussions:
* [[http://www.notmart.org/misc/statusnotifieritem/index.html|http://www.notmart.org/misc/statusnotifieritem/index.html]]
* [[https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators|https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators]]
|
