#desktop-notifications #systemd #desktop #dbus #notify #generate

app sdshout

Desktop notifications for systemd service failures

1 unstable release

0.1.0 Aug 16, 2024

#930 in Command line utilities

Apache-2.0

18KB
90 lines

sdshout ("systemd shout")

sdshout is a simple service which generates desktop notifications on Linux systems when systemd services fail. It's useful for knowing when system updates, automated backups or other critical jobs aren't working.

sample notification

sdshout is intended to run a user systemd service. It connects to the system D-Bus to detect failed services.

Installation

Nix

On flake enabled Nix systems, sdshout can be run or installed from github:mjs/sdshout. For example, to just give it a try:

nix run github:mjs/sdshout

Integration as a NixOS flake input is also possible.

Cargo

If you have Rust toolchain available, sdshout can be installed with:

cargo install sdshout

Service Installation

  1. Copy the sample service file to ~/.config/systemd/user
  2. Edit the file and modify the ExecStart line to suit
  3. systemctl --user daemon-reload
  4. systemctl --user enable --now sdshout.service

Roadmap

See issues labeled with Enhancement on GitHub.

Dependencies

~5.5MB
~116K SLoC