README

   1 ================================================================================
   2
   3                                  Checkmail @VERSION@
   4
   5                     (c) 2005--2007 Martin Mares <mj@ucw.cz>
   6
   7 ================================================================================
   8
   9 Checkmail is nothing more than a smart textual menu allowing easy browsing
  10 through a set of mailboxes, displayed together with numbers of all messages
  11 and new messages.
  12
  13 It can be freely used and distributed according to the terms of the GNU General
  14 Public License version 2, as published by the Free Software Foundation.
  15
  16 Build requirements: libncurses, locales and iconv and a decent C99 compiler
  17 (preferably GCC).
  18
  19 Usage:
  20         see `cm --help'
  21
  22 Keys:
  23         q / Ctrl-C                      quit
  24         arrow keys / vi-like movement   moves through the list
  25         ENTER                           invokes mutt (or a program specified
  26                                         with the -m option) on the current mailbox
  27         TAB                             jumps to the next mailbox with some new
  28                                         messages (mailboxes with higher priority
  29                                         are preferred)
  30         `                               TAB in reverse direction
  31         Ctrl-R                          forces full reload of the list (otherwise,
  32                                         it gets updated incrementally)
  33         Ctrl-L                          redraw screen
  34         0...9                           sets minimum priority of mailboxes to show
  35                                         (0=show all)
  36         b, B                            enable/disable beeping
  37         <hotkey>                        activate a specific mailbox and invoke mutt
  38                                         on it (hotkeys are defined as mailbox options
  39                                         and they override the default key bindings)
  40
  41 Examples:
  42
  43         cm -i                           display just the inbox
  44         cm -i '~/Mail/*_list'           display inbox and all mailing lists
  45         cm -i '~/Mail/*_list' -oINBOX=1t  highlight the inbox and prefer it on TAB
  46
  47 Caveats:
  48
  49   - CheckMail currently does no mailbox locking, but the incremental update mechanism
  50     is able to recover from mailboxes caught in the middle of mail delivery.
  51
  52 Please send all bug reports and suggestions to mj@ucw.cz.
  53
  54                                 Have fun
  55                                                         Martin