Man Linux: Main Page and Category List


       CheckGmail - system tray applet to check a Gmail account for new mail


       checkgmail [-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  with  Crypt::Simple(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 Crypt::Simple(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 accounts.

       -hosted=[Gmail hosted domain]
              Allows checkgmail to work for Gmail  hosted  domains.   E.g.  if
              your   hosted   domain   is,  run  the  program  with
       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.

       -h     Prints a usage message.


              Setting   the   HTTPS_PROXY   environment  variable  will  cause
              CheckGmail to use the specified proxy server when  checking  for
              new mail.


              User configuration file

              Language translations


       Owen Marshall <owenjm at the email provider which this utility checks>