Next Previous Contents

3. Usage

3.1 General Usage

Add some accounts in the "Options" config dialog. Connect to the internet. Now you may list the mails on the pop3 server by pressing the "Refresh" button. All other buttons and menu entries should explain themself. The Delete key can be used to delete mails. Have fun !

3.2 Command line parameters

You can provide the selected account on the command line. If the option --config is set on the command line, the configuration dialog is started immediatly. This can be helpful, if the function "Terminate kshowmail if no new mail" is activated. To get a complete list of all options, use --help.

3.3 External programs

To start external programs like fetchmail, add a entry in the commands menu. Command names show up in the same menu. If they contain the character '&', the following letter will be used as keyboard shortcut.

The following parameters are placeholders and will be substituted by the actual values:

<user> User name

<passwd> Password

<server> Server

<header> The mail header will be copied to a temporary file, the name of this file will be substituted here.

<body> The mail body will be copied to a temporary file, the name of this file will be substituted here.

3.4 Sending complain mails

The command to send complain mails is a special one. To keep flexibility, it has been implemented as an externel command too. I suggest to use the perl program "spam.pl" version 0.20 or better of Daniel Stenberg. It can be received at http://spam.sourceforge.net. To make it run with kshowmail, follow these steps:

1. Install spam.pl in a suitable directory, say /usr/local/bin.

2. Create the files ~/.spam/friends and ~/.spam/from. More details are available in the spam.pl documentation.

3. Create an entry in the kshowmail command menu. The name of the entry has to be "complain" ! Otherwise the command will not be recognized correctly. Enter this text as command line:

spam.pl -d < <body>

This causes the mail body to be piped into spam.pl.

The debug option -d may be removed later, if you are satisfied with the results. Only then the complain mails will be actually sent. Add other options as you like.

Be careful to choose the right entries in the ~/.spam/friends file. At least the local domain should be inserted. Use this feature at your own risk !

As you press the button "Send complain mail", for each highlighted mail there will be one or more complain mails generated and sent immediatly. The receiver of these mails are determined by spam.pl. As long as the option -d is activated, only a message will be displayed to show what would happen. To activate the feature, remove the debug flag.

If you prefer other anti spam programs, try to set them up in a similar way. Contact me if there are any problems.


Next Previous Contents