Enotify: a networked notification system for emacs
Enotify provides some sort of system tray for emacs.
It is born as a vehicle for TDD notifications, as the writer does not like annoying popups floating around his tiled workspace.
An application can connect to enotify and send a notification message, that will discreetly appear in the emacs mode-line.
Get the code from the github repository, add the enotify directory to your emacs load-path and require enotify:
(add-to-list 'load-path "path/to/enotify") (require 'enotify) (enotify-minor-mode t)
or grab it from here as a single file.
Enotify uses the TCP port 5000 by default. You can customize
‘enotify-port’ if you want.
Messages are sent as strings and have this format:
|<message size>|<message body>
Message bodies have the form of a keyword argument list, like
The message size is intended as the length in characters of the message body. In the last example, this would be
An application that wants to send notifications should register a slot - the equivalent of an icon in a system tray - before sending any notification message.
The message used to register a slot
(:register <slot-name> :handler-fn <message-data-processing-funcion>)
The function passed as :handler-fn is of the form
(handler-fn slot-id data)
whose purpose of the :handler-fn parameter will be clarified in the following section.
The message used to send a notification has the form
(:id <slot-name> :notification (:text <slot text> :face <slot face> :help <tooltip text> :mouse-1 <mouse-1 handler>) :data <additional-data>)
---- (m1-handler event) ----
It's possible to retrieve the slot id with
---- (enotify-event->slot-id event) ----
As of now, laynor/espectator this is the only application for enotify. If you are interested, you can look at the code and see how does it work.
It’s best used together with Rspec Org Formatter, that provides org-mode formatted text for rspec results.