Installation - Windows
Compilation - Windows (this step is not necessary but could be important if you want change some features yourself)
Configuration of Spaxy
Using Spaxy
Configuration of email client - Outlook Express (for configuring the port then the message rules)

Installation / Compilation - Linux
Configuration of Spaxy
Using Spaxy
Configuration of email client - Netscape Navigator

1.1 - Go here and download the latest version of Qt for Windows. You have the choice of an evaluation version (during 30 days) or a non-commercial version but it is older. Prefer the evaluation version.

1.2 - Install Qt by following the instructions. You will have Qt DLL in the system directory.

2.1 Go here and download the latest version of Spaxy for Windows (win32).

2.2 Dezip the files in a folder then launch qtspaxy.exe

2.3 It's all ! Now you are ready for the configuration !

1.1 - When you launch Spaxy, it tries to connect and wait on the port 110, the default port for common POP servers. If you are a Linux user and are not root or if you don't want to use the port 110, you should change that in the configuration file. Edit ./config/config.cfg

1.2 - In this file, each line can be a parameter definition (begin with '$') or a comment (begin with '#'). The syntax of parameters definition is very simple but you must respect it. Syntax is :

$parameter_name = "parameter_value"

The first parameters (spaxy_version, spaxy_date, ...) are not important and are provided for information only. You can change theses parameters :

2.1 - Now you have to give some intelligence to your filter. In default settings, the SPAM detector is not activated, i.e. the mail pass into the filter without be changed in anything. If you want the filter catch the SPAM emails, you must configure the filter rules. Spaxy is based on a scoring method. A set of rules is applied on the incoming email and decide how much it is SPAM. Each time a rule is activated, a constant value is added to the email. At the end, if the note of the email exceed a fixed limit, it is considered as SPAM. A SPAM email is marked by adding a spam-mark at the beginning of the subject and a normal email (called it 'HAM') is not altered and it pass the filter as if there were no filter. Now you are ready to configure the following parameters :

2.2 - After the parameters, each line describes a rule. The syntax is :

note rule

The note can be positive or negative but must be an integer (only rounded value, not 0.51 for example). The format of the rule is very simple and powerful and is described in the section of the rules. You can add as many rules as you want, only by adding a new line. In the default config file, some rules have been already put :

+1 {subject:free|credit}&{from:hotmail@}
Increase the note by 1 if the subject contains "free" or "credit" and the email come from hotmail (from adress contains "hotmail@").

+1 {body:unsubscribe|click|sex}
Increase the note by 1 if the body of the message contains "unsubscribe" or "click" or "sex".

-1 {from:my-friend@domain.com}
Decrease the note by 1 if the email comes from the specified adress.

-1 {to|cc:my-adress@domain.com}
Decrease the note by 1 if the email is adressed (directly or by carbon copy) to the specified adress.

As you can see, the rule can be very powerful and many rules can be combined between them. See the section of the rules for more interesting rules.