﻿1. About
2. Requirements
3. Configuration
4. Usage
5. Examples
6. Thankyous


1. About:
   InfoBox is a notification tool based on specifications from http://www.galago-project.org/.
   It waits for DBUS messages, and if they're correct it displays it.
   It was inspired by FVWM-Crystal's InformationBox, but since it was so limited I decided to write InfoBox. It's meant for FVWM-Crystal but should work on everything else.

2. Requirements
   GTK 2.6 (or higher)
   DBus 0.30 (or higher)

3. Configuration
   InfoBox looks for config file at ~/.infobox/infoboxd.cfg, and if it won't find it it uses the default config.
   But you are also able to setup InfoBox at runtime, using an InfoBox client – more in “4. Usage”. The configuration file is described in infoboxd.cfg.example.

4. Usage
   When you left-click on the window, it will be above all other windows, middle-click closes it, and right-click sends it below.
   If a program use this standard InfoBox will display its messages, but if not you could use InfoBox client instead (for example with Song Change plugin for XMMS):
   infobox [-a app_name] [-i app_icon] [-s summary] [-m msg] [-g image] [-c config]
    -a  name of the application sending the message
    -i  path to application's icon, or name of themed icon
    -s  short message
    -m  long message
    -g  image/animation that will be showed at left (path or name of themed icon)
    -c  config is in the same format that the config file, see "5. Examples"

5. Examples
    * Run time configuration:
      $ infobox -c “Alpha=128\
      TintColor=red\
      BorderColor=blue”

    * XMMS/BMP Song Change plugin
      set this as "Command": /usr/bin/infobox -a 'BMP'  -i 'bmp' -s "%s"

    * Ivman:
      Add to IvmConfigActions.xml:
      <ivm:Match name="hal.volume.disc.type" value="cd_r">
        <ivm:Match name="hal.volume.disc.has_data" value="true">
          <ivm:Option name="exec" value="infobox -a Ivman -s 'CDROM Status' -m 'Data CD inserted - &quot;$hal.volume.label$&quot;' -g 'gnome-dev-cdrom'" />
        </ivm:Match>
      </ivm:Match>


6. Thankyous
   Maciej "harnir" Delmanowski, for FVWM-Crystal and original InformationBox
   FBPanel Team for some of the code I borrowed ;)
   Galago-Project for their specification and notification-daemon

