Provided by: asmail_2.1-4_amd64 bug

NAME

       asmailrc - the asmail resource file

SYNOPSIS

       $HOME/.asmailrc

DESCRIPTION

       The asmailrc is a resource file that describes the configuration of the asmail(1) program.

RESOURCE FILE SYNTAX

       The  syntax  is  based  on  grouping  relevant options with {} (curly braces). The keyword
       before the opening brace tells asmail what this section is related to. The keywords in one
       section may be invalid or have different semantics in another section.

       All  keywords  are  case-insensitive,  so  there  is  no  difference between "mailbox" and
       "Mailbox". However, the values you give to the file names, user names and so on are  case-
       sensitive as is usual on Unix systems. Comments start with the # (hash sign) and run until
       the end of the line. Comments and blank lines are ignored.

       There are two main sections within the resource file.  Each  of  them  may  be  completely
       omitted,  as  well  as  other sections and settings may be omitted. asmail will try to use
       default values for everything you do not specify.

       The later values overwrite earlier values. It  is  perfectly  acceptable  to  specify  any
       option  twice  and  the  last value will be used. One exception from this is the animate{}
       section where pixmap files are added to the list by multiple occurences of the keywords.

       Section name must be followed by { (opening brace) on the same line. The end of a  section
       is signalled by } (closing brace) alone on a line.

       x11
              The top-level section describing the GUI settings.

       mailbox
              The top-level section describing the mailboxes to be monitored

       stat
              The  section  may  appear  within  the  x11{} section.  This section describes what
              statistics should be shown on the screen.

       animate
              The section may appear within  the  x11{}  section.   This  section  describes  the
              pixmaps  that  will  be  used  instead of the default ones and the settings for the
              animation.

x11 section

       The x11 section specifies how the application looks on the screen.  There may be  multiple
       x11{}  sections,  the  settings  from  all of them are merged and later settings overwrite
       earlier settings.

       beep [yes|no]
              When beep is on, the tool will signal arrival of new e-mail by the system beep  via
              the system speaker.

              Default is yes.

       shape [yes|no]
              Specifies  whether the Shape extensions of X11 will be used for drawing the pixmaps
              that are specified by frame, nomail, old and new keywords in the settings file.

              When the Shape extensions are used, the tool will use the transparency settings  of
              the  pixmaps. That is, when a pixmap contains transparent pixels, those pixels will
              become actually transparent on the screen. With the Shape extensions disabled,  the
              transparent pixels will show up filled with the background color.

              The Shape extension is rather expensive on the CPU power and may slow down things a
              lot on a slow machine.

              Default is no.

       on_mouse_left comand &
              The command will be executed when the application window is clicked with  the  left
              mouse button.

              Default is none.

       on_mouse_middle comand &
              Same as on_mouse_left for the middle mouse button.

       on_mouse_right comand &
              Same as on_mouse_left for the right mouse button.

       on_new_mail command &
              The  command will be executed once for each mailbox when the e-mail arrives to that
              mailbox.

              Default is none.

mailbox section

       The resource file should contain as many mailbox{} sections as the number of mailboxes you
       want to monitor. Each section will create a separate monitor for the given mailbox.

       type [ mbox | maildir | mh | pop3 | imap ]
              The  type  of  the  mailbox. mbox is the standard UNIX mailbox file. maildir is the
              newer Maildir format.  mh is the  mH  mail  directory  format.   pop3  is  for  the
              mailboxes on POP3 servers.  imap is a mailbox on the IMAP server.

              Depending  on  the  type of the mailbox, some settings may take effect while others
              will be silently ignored.

              The following keywords are useful for the mbox:
                  file update unread-is-new

              The following keywords are useful for the maildir:
                  file update

              The following keywords are useful for the mh:
                  file update unread-is-new use-mh-sequences

              The following keywords are useful for the pop3:
                  update auth server user password timeout

              The following keywords are useful for the imap:
                  update server user password mailbox ssl trustedCaDir timeout persistent

       file file-name
              For mbox, mh and maildir, specifies the location of the mailbox in the filesystem.

              Default: none.

              Note:  if  no  mailbox  section  is  present  in  the  configuration  file  or   no
              configuration  file  is  found, the value of the environment variable $MAIL will be
              used as the location of the UNIX mailbox format mail file.

       update period
              Specifies the period between two updates of  this  mailbox.  The  mailbox  will  be
              updated period seconds after the previous update is finished.

              Default: 10.

       unread-is-new [ yes | no ]
              For  mbox  and  mh,  specifies whether the messages which are flagged as unread are
              counted as new messages.

              Default: no.

       use-mh-sequences [ yes | no ]
              For mh, specifies whether asmail should parse the .mh_sequences  file  in  this  mH
              mail  directory  to  count new messages. If this option is set to "no", then asmail
              will parse every message in the mH directory searching for "Status" headers.

              Default: no.

       auth plain md5
              Specifies the type of authentication allowed for the POP3  service.   plain  stands
              for  the  cleartext password authentication, md5 stands for the APOP authentication
              using MD5 hashes.  You can specify either of them or both.

              If both are allowed and the server supports APOP, first APOP will be tried.

              Default: plain md5.

       server server-name
              The server name to connect to.

              Default: none.

       user user-name
              Your user name on the server.

              Default: none.

       password your-password
              Your password on the server.

              Default: none.

       mailbox mailbox-name
              Your mailbox on the server. This is only useful with IMAP servers, you can  specify
              an alternative to the standard "INBOX" value.

              Default: INBOX for IMAP, none for the rest.

       timeout server-timeout
              The connection to the server will time out after server-timeout seconds waiting for
              the answer.

              Default: 60.

       ssl [ yes | no ]
              Use an encrypted connection to the IMAP server.

              Default: no.

       trustedCaDir directory
              A directory that contains trusted certificate authorities. This is used to verify a
              server's certificate when negotiating an encrypted connection.

              Default: none.

       persistent [ yes | no ]
              The  connection  to  the  server  can  be  either  opened once and kept open or the
              connection can be opened and closed every time we need  to  check  for  the  e-mail
              status,  i.e. every update period seconds. If you do not want the connection set-up
              and login procedure to execute every time, set this to yes.

              Default: no.

stat section

       This section relates to the representation on the screen of mailbox status  and  counters.
       There are the following elements in this representation:

           mailbox state
           A letter R appears whenever the mailbox is
           being updated.

           error state
           A letter appears that shows the error state of
           the mailbox.
           The letters may be folowing:
             L - login procedure failed
             T - timeout while waiting for server response
             C - connection problem
             F - general fault indication
           When an error is indicated, asmail prints a
           descriptive message on the standard output.

           number of messages
           The number of messages is represented by two numbers,
           for the number of new messages and the total number
           of messages.

       The  statistics  may  be displayed for each of the mailboxes separately as well as for the
       total of all mailboxes. When the total is displayed, the indicators of the  mailbox  state
       and the error state will report if any of mailboxes are updated or have errors.

       each [ yes | no ]
              Whether  the  tool  should  display  a line of statistics for each of the mailboxes
              separately.

              Default: no.

       total [ yes | no ]
              Whether the tool should display the summary line for the total number  of  messages
              in all mailboxes.

              Default: yes.

       status [ yes | no ]
              Whether  the  status  indicator  should preceed every line describing the number of
              messages in a mailbox and the total.

              Default: yes.

       old [ yes | no ]
              Whether the status indicator should display the number of old  (read)  messages  in
              the mailbox.

              Default: yes.

       new [ yes | no ]
              Whether  the status indicator should display the number of new (unread) messages in
              the mailbox.

              Default: yes.

       delimiter characters
              The characters are used to separate the number of new messages from the  number  of
              old messages in the display.

              Default: "/".

       x pixels
              Start the status indicator at pixels offset horizontally from the top left corner.

              Default: 0.

       y pixels
              Start the status indicator at pixels offset vertically from the top left corner.

              Default: 52.

       font font-specification
              Use the font-specification for the status indicator.

              Default: -*-*-medium-r-normal--10-*-*-*-*-*-*-*.

       color name
              Use the specified color for the status indicator. The color may be a single word or
              multiple words surrounded by quotes.

              Default: black.

animate section

       The section describes the animation presented on the screen. Basically, you can  supply  a
       number  of  XPM  files in this section and the tool will happily cycle through them. There
       are three states: nomail, old, new. For each state, you add as many XPM files as you like.
       If  there  is  only  one file, asmail will not really cycle through it, only display once,
       saving thus the system resources.

       refresh refresh-rate
              The supplied XPM files are cycled through every refresh-rate number of 1/100th of a
              second.

              Default: 10.

       nomail xpm-file
              Add  this  xpm-file  to  the  animation  of display to represent the state of empty
              mailbox.

       old xpm-file
              Add this xpm-file to the animation of display to represent  the  state  of  mailbox
              with only read mail.

       new xpm-file
              Add  this  xpm-file  to  the animation of display to represent the state of mailbox
              when there is new e-mail in it.

       frame xpm-file
              Use  this  xpm-file  as  the  background  image.  The  background  image  may   use
              transparency. You can specify more than one but only the first one will be used.

              You can specify the keyword none instead of the name of the file to be used for the
              frame. The result will be no frame at all around the applet window.

EXAMPLE

        x11 {
           beep no
           on_mouse_left aterm -e bash -c pine &
           on_new_mail cat /usr/local/share/asmail/sounds/drip.au > /dev/audio &
           shape yes
           stat {
             each yes
             total yes
             delimiter " "
             x 5
             y 2
             font -*-helvetica-bold-r-*-*-10-*-*-*-*-*-*-*
             color black
           }
           animate {
             refresh 10
             nomail /usr/local/share/asmail/pixmaps/e-no.xpm
             old /usr/local/share/asmail/pixmaps/e0.xpm
             new /usr/local/share/asmail/pixmaps/e1.xpm
             new /usr/local/share/asmail/pixmaps/e2.xpm
             new /usr/local/share/asmail/pixmaps/e3.xpm
             new /usr/local/share/asmail/pixmaps/e4.xpm
             new /usr/local/share/asmail/pixmaps/e5.xpm
             new /usr/local/share/asmail/pixmaps/e6.xpm
             new /usr/local/share/asmail/pixmaps/e7.xpm
             new /usr/local/share/asmail/pixmaps/e8.xpm
             new /usr/local/share/asmail/pixmaps/e9.xpm
             new /usr/local/share/asmail/pixmaps/e10.xpm
             new /usr/local/share/asmail/pixmaps/e11.xpm
             new /usr/local/share/asmail/pixmaps/e12.xpm
             new /usr/local/share/asmail/pixmaps/e13.xpm
             new /usr/local/share/asmail/pixmaps/e14.xpm
             new /usr/local/share/asmail/pixmaps/e15.xpm
             new /usr/local/share/asmail/pixmaps/e16.xpm
             new /usr/local/share/asmail/pixmaps/e17.xpm
             new /usr/local/share/asmail/pixmaps/e18.xpm
             new /usr/local/share/asmail/pixmaps/e19.xpm
             new /usr/local/share/asmail/pixmaps/e20.xpm
             new /usr/local/share/asmail/pixmaps/e21.xpm
             new /usr/local/share/asmail/pixmaps/e22.xpm
             new /usr/local/share/asmail/pixmaps/e23.xpm
             new /usr/local/share/asmail/pixmaps/e24.xpm
             new /usr/local/share/asmail/pixmaps/e25.xpm
             new /usr/local/share/asmail/pixmaps/e26.xpm
             new /usr/local/share/asmail/pixmaps/e27.xpm
             new /usr/local/share/asmail/pixmaps/e28.xpm
             new /usr/local/share/asmail/pixmaps/e29.xpm
             new /usr/local/share/asmail/pixmaps/e30.xpm
           }
        }

        mailbox {
           type mbox
           file /var/spool/mail/albert
           update 5
           unread-is-new no
        }

        mailbox {
           type maildir
           file /home/albert/MailDir
           update 5
        }

        mailbox {
           type mh
           file /home/albert/mhmail
           update 5
           unread-is-new yes
           use-mh-sequences yes
        }

        mailbox {
           type pop3
           auth plain md5
           server example.com
           user yourname
           password yourpassword
           update 120
           timeout 30
        }

        mailbox {
           type imap
           server example.org
           user yourname
           password yourpassword
           update 60
           timeout 30
           ssl yes
           trustedCaDir /etc/openssl/certs/myCa/
        }

FILES

       ~/.asmailrc

SEE ALSO

       asmail(1)

COPYRIGHTS

       Copyright (c) 2002-2007  Albert Dorofeev <albert@tigr.net>

       Distributed under GNU General Public License v2 ; see LICENSE file for more informations.

AUTHORS

       Albert "Tigr" Dorofeev <albert@tigr.net>

       See the README file for credits.