killjoy Notifier: Notification
==============================

Generate desktop notifications on behalf of
[killjoy](https://github.com/Ichimonji10/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](https://wiki.archlinux.org/index.php/Desktop_notifications).

Concepts
--------

First, read the concepts section in the
[killjoy](https://github.com/Ichimonji10/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](https://aur.archlinux.org/packages/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.)

```bash
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:

```json
"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](https://wiki.archlinux.org/index.php/Desktop_notifications).

Changelog
---------

See annotated git tags.

License
-------

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