stumpwm.stumpwm-contrib/minor-mode/notifications

• Usage

Usage

This StumpWM module acts as notification monitor for external applications. They can send messages via `stumpish' which will be displayed in the mode-line. (Thus `stumpish' has to be in your PATH.)

To use it add this to your ~/.stumpwmrc.lisp:

(load-module "notifications")

Then add the formatter %N to your mode-line spec, i.e. like this:

   (setf *screen-mode-line-format* "[%W] {%g} (%N)")

You might want to bind notifications-map to a key:

   (define-key *root-map* (kbd "N") '*notifications-map*)

With this map you can add notifications with a, reset them with r, delete the first/last with d/D or show them in a popup with s.

External applications can add notification messages using stumpish:

   $ stumpish notifications-add 'Foo Bar Baz'

For example this is the elisp code that I use to let rcirc (an Emacs IRC client) notify me when a message with my nickname or a IM message arrives:

 (defun th-rcirc-notification (process sender response target text)
   (let ((my-nick (rcirc-nick process)))
     (when (and (string= response "PRIVMSG")
                (not (string= sender my-nick))
                (or
                 ;; BitlBee IM messages
                 (string-match "localhost" (format "%s" process))
                 ;; Messages that mention my name
                 (string-match my-nick text)))
       (th-notifications-add (concat "rcirc: " target)))))

 (add-hook 'rcirc-print-hooks 'th-rcirc-notification)

 (defun th-notifications-add (str)
   (interactive "sNotification: ")
   (start-process "notifications-add" nil
                  "stumpish" "notifications-add" str))