Reference

asmail(1x)

AfterStep Mail

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 ([email protected])

Gyula Matics ([email protected])

Steve Martin ([email protected])

Christopher Seawood ([email protected])

MAINTAINER

Martin Domig ([email protected])

History