73 lines
3.7 KiB
Plaintext
Executable File
73 lines
3.7 KiB
Plaintext
Executable File
PyGTK IMAP Checker v1.2
|
|
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.
|