NAME

       pop3browser -- small perl script to access POP3 mail accounts

DESCRIPTION

       pop3browser  is  a  perl script that uses libnet-perl to give access to POP3 mail accounts
       without fetching the messages.

       pop3browser can be used to delete unwanted mails (SPAM), especially when  they  come  with
       large  attachments,  before  downloading  them over low-bandwidth connections. The --limit
       option of fetchmail is very useful to filter such large mails which can then be  inspected
       with pop3browser.

       The program supports normal POP3 authentication and APOP.

USAGE

       pop3browser  welcomes  you  with  a  short  copyright  note and a command line prompt. The
       settings for a mailbox (host, password etc.) have to be specified in a configuration  file
       (similar to fetchmail).  pop3browser understands the following commands:

       hosts  list available hosts specified in .pop3browserrc

       login n
              log into host no. n, use 'hosts' to get a list of available hosts

       o(pen) n
              same as login

       apop n same as login but uses APOP

       c(lose)
              delete messages marked for deletion and close current connection

       list   list sizes and message numbers of the mails on the account

       s(how) n
              show header and some body lines of mail number n

       m(ailbox)
               list message number, size, sender and subject for each mail

       d(elete) n
              delete mail number n

       undel(ete) n
              undelete mail number n

       k(ill) expr
              delete mails matching expr in header

       u(nkill) expr
              undelete mails matching expr in header

       q(uit) delete messages marked for deletion and quit program

       exit   same as quit

       help   print a command summary

CONFIG FILE

       The  definitions  for  a mailbox are specified in ~/.pop3browserrc.  One line per mailbox.
       Lines starting with # are ignored.  Each definition must  be  in  the  following  form:.br
       hostname <tab or space> userid <tab or space> password <tab or space> protocol (optional)

       For example:
       #definition for bar@pop.foo.com
       #pop-server          UID passwd protocol
       pop.foo.com          bar s3cr3t apop
       #end of definition

       Recognised  options  for  the  protocol are pop3 and apop. If no protocol is specified the
       command login/open assumes pop3.  The command apop ignores the protocol option.

       To override the default header-filter of the show command you can specify a custom set  of
       keywords  in  ~/.pop3browserrc.   Lines  starting  with "@headpattern" or "@bodylines" are
       parsed by pop3browser. Settings for the header-filter must be in the following form:
       @headpattern <tab or space> = <tab or space> "<keyword1>","<keyword2>",....
       The filter keywords are matched against the start of a header line.
       Settings for the number of body lines to show, have to be in the following form:
       @bodylines <tab or space> = <tab or space> <Number>
       Example:
       @headpatterns = "From:","To:","Subject:","Date:","CC"
       @bodylines = 10

       The file ~/.pop3browserrc must only be readable for the owning user. pop3browser  corrects
       other file modes automatically.

SEE ALSO

       fetchmail(1)

AUTHOR

       Christoph Baumann <cgb@debian.org>

THANKS

       Jorrit 'J"o' Fahlke, for his overhaul of the config file parser
       Takeshi Hamasaki, for the headpattern patch