stumpwm.stumpwm-contrib/util/notify/README.org

• Usage
• Dependencies
• Testing
• Footnotes

Notifications server for StumpWM.

Implements org.freedesktop.Notifications interface¹. Shows notifications using stumpwm:message by default.

Usage

Add

  (load-module "notify")
  (notify:notify-server-toggle)

to .stumpwmrc

Now you can run default server using notify-server-toggle. In order to get your own notifications handler you can define on function

  (defun notification-handler (app icon summary body)
    "Does things with incoming notifications"
    ...)

Dependencies

On Debian/Ubuntu² there's a dependency on libfixposix-dev. If you get an error such as the following:

~/quicklisp/dists/quicklisp/software/iolib-v0.8.3/src/syscalls/ffi-types-unix.c:14:10: fatal error: lfp.h: No such file or directory

Then you need to install the dev package:

  apt-get install -y libfixposix-dev

Testing

You can test notifications (if you have notify-send installed) with:

notify-send 'Hello world!' 'This is an example notification.'

Footnotes

---

¹

D-BUS Notifications Protocol Spec

²

…and possibly other distributions too