status-notifier-item: A wrapper over the StatusNotifierItem/libappindicator dbus specification

[ bsd3, desktop, library, program ] [ Propose Tags ] [ Report a vulnerability ]
Versions [RSS] 0.1.0.0, 0.2.0.0, 0.2.1.0, 0.2.2.0, 0.2.2.1, 0.3.0.0, 0.3.0.1, 0.3.0.2, 0.3.0.3, 0.3.0.4, 0.3.0.5, 0.3.1.0, 0.3.2.0
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), byte-order, bytestring, bytestring-to-vector, containers, dbus (>=1.2.1 && <2.0.0), dbus-hslogger (>=0.1.0.1 && <0.2.0.0), filepath, hslogger, lens, optparse-applicative, status-notifier-item, template-haskell, text, transformers, vector [details]
License BSD-3-Clause
Copyright 2018 Ivan Malison
Author Ivan Malison
Maintainer IvanMalison@gmail.com
Uploaded by eyevanmalicesun at 2026-02-05T01:02:29Z
Category Desktop
Home page https://github.com/IvanMalison/status-notifier-item#readme
Bug tracker https://github.com/IvanMalison/status-notifier-item/issues
Source repo head: git clone https://github.com/IvanMalison/status-notifier-item
Distributions Arch:0.3.1.0, Debian:0.3.0.5, LTSHaskell:0.3.1.0, NixOS:0.3.1.0, Stackage:0.3.1.0
Reverse Dependencies 3 direct, 1 indirect [details]
Executables status-notifier-watcher, status-notifier-item-static, sni-cl-tool
Downloads 7725 total (30 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2026-02-05 [all 1 reports]

Readme for status-notifier-item-0.3.2.0

[back to package description]

status-notifier-item

Build Status Hackage Stackage LTS Stackage Nightly

The status-notifier-item package provides a haskell implementation of the status-notifier-item/app-indicator protocol.

StatusNotifierHost

The host server implementation provided is partial in the sense that it is headless (provides no graphical interface), and it is supposed to be used together with UI code that handles actually displaying a tray. The gtk-sni-tray provides a gtk tray widget that is implemented using the status-notifier-item library. taffybar Uses gtk-sni-tray to provide a tray widget that can be used with the many other widgets it offers.

StatusNotifierWatcher

This package provides a standalone status-notifier-watch binary that can be run on its own to handle the registration of status-notifier-items. By default, it is necessary to run this binary before starting either taffybar or gtk-sni-tray, becuase the trays provided in those binaries do not handle this responsibility. If this is not done, those binaries will fail at startup with this message:

MethodError {methodErrorName = ErrorName "org.freedesktop.DBus.Error.ServiceUnknown", methodErrorSerial = Serial 7, methodErrorSender = Just (BusName "org.freedesktop.DBus"), methodErrorDestination = Just (BusName ":1.549"), methodErrorBody = [Variant "The name org.kde.StatusNotifierWatcher was not provided by any .service files"]}

A client library is also provided for the StatusNotifierWatcher protocol

StatusNotifierItem

This package provides a client library for calling into status notifier items. It also provides a sample implementation of the server side of the StatusNotifierItem protocol as well as a status-notifier-item-static binary that uses this implementation. This binary can be used to test host and watcher implementations, but it mostly just serves as an example of how to implement the protocol using this library, as it does not really do anything useful.