phosphor-services

D-Bus and platform-integration primitives for desktop shells.

A grab-bag of small D-Bus and spec-driven services every desktop shell needs, exposed under a single namespace so a shell can pull them in piecewise. Three service families ship today: StatusNotifierItem (system tray) host + watcher with full XDG icon-theme spec lookup and com.canonical.dbusmenu menus; MPRIS2 media-player discovery and control; and UPower battery and power-supply state. NetworkManager, logind, and ext-session-lock-v1 remain on the roadmap.

Full API →

Key types

StatusNotifierHost
Per-shell host that registers as a watcher and tracks live items.
StatusNotifierWatcher
Implements org.kde.StatusNotifierWatcher so apps discover the host.
StatusNotifierItem
Live proxy for one tray item; surfaces icon, tooltip, status, and menu.
StatusNotifierItemModel
QAbstractListModel over the host's items for QML binding.
DBusMenuModel
QAbstractItemModel over com.canonical.dbusmenu for context-menu rendering.
IconThemeResolver
XDG icon-theme lookup with size and theme fallbacks.

Dependencies

See also

phosphor-shell
QML shell infrastructure that consumes these services.

References