asmail(0.55)

NAME
asmail - AfterStep Mail

SYNOPSIS
asmail [file] [options ...]

DESCRIPTION
The asmail is a "mail-checker" like xbiff, but with the Afterstep look 'n feel. It indicates the status of your mailbox. It can be put in the Wharf, execute program on incoming mail, execute program on mouse click, show XPM icon's, show animations and more...

FILE
But default asmail uses ~/.asmailrc as configuration file, but if want to use another file you just specify the name on the command-line.

OPTIONS

-help
    Prints a help message

-geometry <geom>
    Specifies the geometry of the asmail window.

-display <disp>
    Specifies the display to use.

-title <string>
    Specifies the title string of the asmail window.

-name <string>
    Specifies the client instance, icon and title string of the asmail window.

CONFIGURATION FILE
Here is a list of the keywords that can be used in the configuration file.

NoBeep
    Do not signal when new mail is found.

NoShape
    Truns off shaped window. Shaped window is often usefull if your would like to place asmail in your Wharf.

LockShape
    Use this option if all icons have the same shape and size, this will save some CPU time if you are using animations.

MailFiles
        [ mbox ]
        [ Maildir/ ]
        [ ::popserver username passwd <port> ]
        [ >>imapserver username passwd <port> <mailbox> ]

End
    Specifies which mailfile(s) and pop-account(s) to use. You can define multiple mailboxes. If this option is left out $MAIL will be used as mailfile. When using pop or IMAP mailboxes make sure that your configfile is not world readable, it contains usernames and passwords which really should not be readable to anyone. Ports and the mailbox name for IMAP boxes are optional. If the mailbox is in Maildir format, end the directory name with a slash.

Update <sec>
    Specifies the update frequency. Default is 5 seconds.

Execute <program>
    Specifies the program to execute when left mousebutton click is invoked on the asmail window.

NewMailExecute <program>
    Specifies the program to execute when new mail is found.

AlwaysNewMailExecute
    Always execute when new mail is found. If this option is revomed asmail will only execute when new mail is found when the status is changed from "nomail/oldmail" to "newmail".

ExecuteOnUpdate <program>
    This option is useful if you want to "pop" your mail from a mailserver. Asmail will execute a specified program (i.e. popclient, get_mail, ...) just before every update of the mailbox status.

NumOfMsgMode <mode>
    With this option you can get asmail to display the number of messages and/or new messages in the mailbox.
       Mode can be set to:
       0 = Disable feature (default)
       1 = NumOfNewMail/NumOfMail
       2 = NumOfNewMail
       3 = NumOfMail

NumOfMsgPosition <x> <y>
    Position of the text, must be inside the icon mask.

NumOfMsgFont <font>
    Font to use.

NumOfMsgColor <color>
    Color to use.

TimeStampMode
    This option is useful if you are using utilities like procmail. Asmail will change status to "New Mail" when the time-stamp of the last modification of the mailfile is changed.

AnimationSpeed <nomail> <oldmail> <newmail>
    Sets the delay between two images in an animation.

NoMail / OldMail / NewMail
       <xpm-icon>
       <...>

End
    Assign icons and/or animations. Just list the icons in the order you want them to be shown. If you don't wnat an animation just list one icon and if you want to use the asmail default icons leave this option out.

#
    Comment.

EXAMPLES
Here is an example of how to start asmail from the command line. It will use myconfig.asmailrc for configuration instead of ~/.asmailrc.
asmail myconfig.asmailrc &

Here is an example of how to start asmail from afterstep and put it in the Wharf. Place the following line in your .steprc file in your home directory.
*Wharf - - Swallow "asmail" asmail &
Here is an example of a configuration file.
#########################################################
# .asmailrc - asmail configuration file                 #
#########################################################
NoBeep
MailFiles
	/var/spool/mail/per
	/home/per/mail/mbox
	::pop.foo.org joe.doe abraxas 10110
	::pop.isp.com josef SecretWord423
End
Update 10
Execute xterm -T Pine -e pine -i &
NewMailExecute cat message.au > /dev/audio &
AlwaysNewMailExecute
AnimationSpeed 10 10 5
LockShape
NoMail
	/usr/include/X11/pixmaps/nomail.xpm
End
OldMail
	/usr/include/X11/pixmaps/oldmail.xpm
End
NewMail
	/usr/include/X11/pixmaps/newmail1.xpm
	/usr/include/X11/pixmaps/newmail2.xpm
	/usr/include/X11/pixmaps/newmail3.xpm
End

COPYRIGHT
This program is Copyright (c) 1996, 1997 by Per Liden. No guarantees or warranties are provided, use this program at your own risk. It may be freely copied and used as long as this copyright-notice is left intact. Modifications and extensions after 1998 are done by Martin Domig.

AUTHOR
Per Liden

SPECIAL THANKS TO
Stephan K. Zitz (zitz@io.com)
Gyula Matics (mgyula@eik.bme.hu)
Steve Martin (smartin@henge.com)
Christopher Seawood (cseawood@qualcomm.com)

MAINTAINER
Martin Domig (martin.domig@gmx.net)