CheckGmail - system tray applet to check a Gmail account for new mail
[-profile] [-hosted] [-popup_delay] [-no_cookies] [-private]
[-v | -verbose] [-nocrypt] [-h]
CheckGmail is an alternative Gmail Notifier for Linux and other *nix systems. It
is fast, secure and uses minimal bandwidth via the use of Atom feeds.
CheckGmail is a system tray application that checks a Gmail account for new
mail. When new mail is present the tray icon changes, an optional animated
popup is displayed and a tooltip displays the number and details of new
messages. Configuration is GUI-based and the application is designed to be
simple, elegant and unobtrusive.
CheckGmail aims to be relatively secure in terms of password storage. Combined
(3pm) the program provides the option of either
encrypting the saved password information or - for maximum security -
re-entering your password each time the application is run. If you decide to
save the password, it is encrypted using a passphrase generated from
machine-unique information (the eth0 MAC address and/or uname system
information). Encrypting the password prevents both casual reading of plain
text passwords on your machine, but more importantly allows the CheckGmail
config file in your home directory to be stored securely on external backups.
For the password encryption function, CheckGmail depends on the Perl module
(3pm) CheckGmail will save passwords as plain text if this
module (or associated modules) is not present on the system.
- Using this switch causes CheckGmail to read preferences
from a file named prefs-[profile_name] in ~/.checkgmail - thus allowing
multiple instances of CheckGmail to be run to check different Gmail
- -hosted=[Gmail hosted domain]
- Allows checkgmail to work for Gmail hosted domains. E.g. if
your hosted domain is test.net, run the program with -hosted=test.net Once
run, the -hosted flag is not required again for that profile.
N.B: You will need to delete the Atom feed address from your preferences or
use a new profile before using this option for the first time. Following a
change in the Gmail login code for hosted domains, this option does not
appear to be compatible with the -no_cookies method of checking mail.
- -popup_delay=[time in millisecs]
- Sets the time taken between the mouse entering the system
tray icon and the tooltip being displayed. Default is 250 millisecs as of
version 1.10 (previous versions used no delay).
- Uses the old Atom feed retrieval method (default in
versions 1.7.2 and earlier) of sending the username and password across
https. The alternative, and currently default method, is to login to
Gmail, save the authentication cookies, and then retrieve the Atom feeds
without requiring any further authentication - this method has the benefit
of allowing various actions to be carried out upon new messages received,
such as deleting, marking as read, archiving or reporting spam.
- Prevents the display of message details in the popup - only
the number of new messages will be displayed.
- -v | -verbose
- Causes CheckGmail to print details of mail checking and
mail contents to STDOUT
- Disables the use of Crypt::Simple to encrypt saved password
information - passwords will be saved as plain text.
- Prints a usage message.
Setting the HTTPS_PROXY environment variable
will cause CheckGmail to use the specified proxy server when checking for new
User configuration file
Owen Marshall <owenjm at the email provider which this utility