killjoy Notifier: Notification

Generate desktop notifications on behalf of killjoy.

killjoy is a systemd unit monitoring application. It discovers systemd units and tracks their states. When a unit changes to a state of interest, killjoy contacts notifiers. This application is a notifier which, upon being contacted by killjoy, will generate a desktop notification.

Concepts

First, read the concepts section in the killjoy documentation.

This application is short-lived, so as to reduce RAM usage. When properly installed, this application will be auto-started whenever a D-Bus message is sent to it. When started, this application will consume all messages (presumably from killjoy) in its message queue, and then idle. If no messages arrive for more than a few seconds, this application quits.

Installation

Arch Linux users may use the killjoy-notifier-notification-git AUR package. A stable package will be created when this application further matures.

Rust developers may install this app from source. Note that libdbus must be installed. (On Ubuntu, this is provided by the libdbus-1-dev package.)

git clone https://github.com/Ichimonji10/killjoy-notifier-notification.git
cd killjoy-notifier-notification
scripts/install.sh

Configuration

No configuration is necessary or possible.

Usage

Define a notifier in killjoy's configuration file:

"notification": {
    "bus_type": "session",
    "bus_name": "name.jerebear.KilljoyNotifierNotification1"
}

Then, list it in a rule's list of notifiers.

When this application receives a message, it will generate a desktop notification.

Changelog

See annotated git tags.

License

This application is licensed under the GPLv3 or any later version.