PyGTK IMAP Checker v1.3
By Josh Holtrop

This script creates an undecorated window containing a number which tracks
the unread message count obtained for a particular mailbox folder via IMAP.
Only IMAP SSL is used.

Window Interaction:
    Middle Click: Disconnect/Reconnect to IMAP server
    Right Click: Exit program

Usage: pygtk-imap-chk.exe <config-file>

The config-file argument is required and should be the name of a configuration
file using python syntax. The file will be written to on application exit
to update parameters such as the window size and position.

The configuration file must set a few required parameters.
The required parameters are: 'server', 'port', 'user', and 'password'.
Here is an example barebones configuration file to get started with:
server = 'mailserver.domain.local'
port = '993'
user = 'JohnDoe'
password = 'j0hnnyb0y'

Available configuration parameters:

'bgcolor':      3-tuple of floats specifying the background color in (r, g, b)
                format. Each component can range from 0.0 to 1.0.
'bgcolor2':     Same format as 'bgcolor'. Specifies the secondary background
                color to be used when "flashing" the window.
'fgcolor':      Same format as 'bgcolor'. Specifies the foreground color
                for the unread message count text.
'flash_rate':   An integer specifying the number of milliseconds to use as
                the flash period.
'font_size':    Float specifying the font point size (ex: 18)
'height':       Integer specifying the height of the window.
                This value will be updated by the program when it closes.
'mailbox':      String giving the name of the mailbox directory to search for
                the unread message count (if unspecified, uses "Inbox").
'mouse':        A hash which configures the actions for the program to take
                in response to a mouse click. The keys of this hash can be
                'left', 'middle', or 'right'. The values of the hash can take
                the following forms:
                'exit' - the program will terminate
                'reconnect' - the program will reconnect to the IMAP server
                'cmd:COMMAND' - the command COMMAND will be executed
                The cmd:COMMAND form can be used to execute arbitrary processes
                in response to a mouse click. This can be used to raise a mail
                client window, for example:
                mouse = {
                    'middle': 'reconnect',
                    'right': 'exit',
                    'left': 'cmd:"C:\\Program Files\\Microsoft Office\\'
                        'Office12\\OUTLOOK.EXE" /recycle '
                        '/select "outlook:Sent Items"'
                }
'password':     String containing the password to use to connect to the server
'port':         String containing the port number of the IMAP SSL port on
                the mail server.
'server':       String containing the host name of the IMAP server
'updaterate':   Integer specifying the number of milliseconds between checks
                to the mail server for the unread message count.
'user':         String containing the user name to connect to the mail server
'width':        Integer specifying the width of the window.
                This value will be updated by the program when it closes.
'x':            Integer specifying the x coordinate of the top, left corner
                of the window.
                This value will be updated by the program when it closes.
'y':            Integer specifying the y coordinate of the top, left corner
                of the window.
                This value will be updated by the program when it closes.