1. About

   pynotif is an extension for ekg2. It sends dbus notifications about status
   changes and incoming messages. You will also need some sort of notification
   daemon that will recive and display notifications as pop-up windows. If you
   use a complex desktop environment like KDE or GNOME, most probrably you
   have notification running.

2. Dependencies

   * ekg2 + plugin python
   * pynotify python library
   * notification daemon

3. How to use it

   Just copy pynotif.py to your .ekg2/scripts directory and load it using:
   /script:load pynotif

   If you copy it to .ekg2/scripts/autorun, it will be loaded automatically at
   ekg2 startup.

4. Configuration

   pynotif declares and uses following variables:

   * notify:catch_url = "0"
     - if set to "1", pynotif will replace urls with html "a href" clickable
       tags. You may want it if your notification daemon supports basic HTML.

   * notify:catch_url_timeout = "5000"
   * notify:icon_msg = "dialog-warning"
   * notify:icon_status = "dialog-warning"
   * notify:ignore_sessions_regexp = "^irc:"
     - ignore notifications from matching sessions.

   * notify:ignore_uids_regexp = "^xmpp:.*@conference."
     - ignore notifications from matching uids. Note that conference.DOMAIN is
       default JID of MUC service, so default value of this variable causes
       pynotif to drop notifications from MUC chatrooms.

   * notify:message_notify = "1"
     - set "0" to disable message notifications.

   * notify:message_notify_unknown = "1"
   * notify:message_timeout = "3500"
   * notify:show_timestamps = "1"
     - set "0" to disable timestamps in message notifications.

   * notify:status_notify = "0"
     - set "1" to enable status change notifications.

   * notify:status_timeout = "3500"
   * notify:urgency_critical_regexp = "^$"
   * notify:urgency_normal_regexp = "^$"
     - before sending notification, pynotif mathes title&message against these
       regexp. If "critical_regexp" mathes, urgency is set to CRITICAL.
       Otherwise, if "normaln_regexp" mathes, urgency is set to NORMAL.
       Otherwise notification is send as LOW.
       Note '&' was chosen as separator, as this character is forbiden in
       JIDs, so it should not appear in notification title. Default values of
       these regexps is "^$". Note that these regexps are never matched,
       because string contain at least single "&" character.

5. Authors

   Paweł Tomak <satherot (at) gmail (dot) com>
   Paweł Zuzelski <pawelz (at) pld-linux (dot) org>

6. Copying

   You are free to use it, redistribute, modify, distribute modified version
   according to GPL version 3 or any later.