---
name: "asmail"
section: "1x"
platform: "linux"
package: "asmail"
version: "0.56-4"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/asmail/1x"
---

# 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 (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)