Popkill
Back home

If you frequently receive mail which you do not want, this application may save time and money for you by deleting those messages on the pop3 server without retrieving the whole body of the message. Therefore it just downloads the headers and matches them against rules you specify. The headers are still being retrieved completely.

Be warned: This implementation of the pop3 protocol does not support encrypted transmission of the password! The password is sent over the network completely unprotected! Thus it can be intercepted by malicous people who have control over the path between client and server!

Download

popkill-0.1.3.tar.gz

Description

The application reads ~/.popkillrc and processes the pop3 account specified there. Help regarding invocation syntax can be obtained with popkill --help.

History

Version new / changed
0.1.3 Edgar Fehlinger (1999/02/28): Additionally delete messages on the server with size > maxsize (in kBytes) which can be set up in the .popkillrc file
For e.g. T-online it is not necessary to send user and password after once having logged in via PPP. "nologin" als login and "nopass" as password prevent popkill from sending user and password. So it is not necessary to have the delicious data in the .popkillrc file.
0.1.2 bug fixed; progress indication every 20 messages processed in verbose mode
0.1.1 created man page, sample.popkillrc added to archive
0.1.0 initial version

Sample of the configuration file ~/.popkillrc

#######################################################################
# Sample configuration file for popkill                               #
# To use this file, copy it to your home and name it ~/.popkillrc     #
# !! DO NOT FORGET TO 'chmod 600 ~/.popkillrc', SINCE IT MIGHT     !! #
# !! CONTAIN YOUR POP3 - PASSWORD                                  !! #
#######################################################################
# General information:
# 1. Lines with first character '#' are ignored (no indentation!!!)
# 2. Strings containing whitespace must be double-quoted
# 3. Multiple kill-lines are ORed
# 4. Order of keywords is insignificant
# 5. Keywords are accepted case-insensitive
# 6. You can query just one server per configfile
#
# For a kill-line to match a mail, the first argument must match
# the beginning of a mailheader-line (case-sensitive) AND
# the second argument must be contained in the rest of the line
# (case-sensitive substring match).
#
# New in version 0.1.3:
# 1. Additional parameter maxsize. If set to n, mails with
# more than n kBytes lenght are deleted on the server.
# If maxsize is omitted or set to 0, no size filtering is 
# performed.
# 2. If Your POP3 server does not require explicit
# login (such as e.g. T-Online in Germany) use "nologin"
# as login and "nopass" as password. So you do not need to store
# those data in the .popkillrc file.
#
# I hope you succeed!
# Tilman Vogel 
#

# Account specification if explicit login is required:
server       pop.bla.fasel.de
login        mylogin
password     mypassword

# Account specification if no explicit login is required:
# uncomment the three lines below and comment out the 
# three lines above.

# server       pop.bla.fasel.de
# login        nologin
# password     nopass

# You can have multiple kill-lines
kill	Subject:	"Scall: Fehler Report"
kill	From:		spammailer@we.suck.com

# Kill messages that are larger than one megabyte
maxsize	1024

In other words:
  1. Lines starting with # are treated as comments.
  2. Strings containing white space must be surrounded by ".
  3. Multiple kill lines are "or"ed together.
  4. Order of keywords does not matter.
  5. Keywords are accepted case-insensitive.
  6. Only one pop3 account can be processed per configuration file.

For a kill line to match a header line the first argument must match the beginning of the header line (case-sensitive) AND the second argument must be included in the rest of the header line (case-sensitive substring match).


Tilman
Visits since 2000/04/17:
Last changed: 2006/05/29 - 10:45:00 CEST Counter