3 unstable releases
0.2.0 | Nov 2, 2019 |
---|---|
0.1.1 | Sep 4, 2019 |
0.1.0 | Sep 2, 2019 |
#13 in #systemd-unit
20KB
314 lines
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.
Dependencies
~5MB
~114K SLoC