Setup and Usage

There are two basic tasks working with JunkBroom:

Training
The filter has to be trained on legitimate and on junk messages.
Classification/Filtering
Messages (mostly incoming messages) must be filtered using the learned classifications.

Basically, this is done either via the supplied AppleScripts or via the commands in JunkBrooms menus. Either way, training and classification are always done on the current messages, which mostly means (when you do something manually) the currently selected messages.

The AppleScripts reside in Entourage's scripts menu (the strange unnamed menu item that looks like a white scroll). They are called:

The corresponding items in JunkBroom's menus are named accordingly. However, the dock menu does not have a "Filter" entry.

Training

Before JunkBroom can be sensibly used to classify messages as either junk or legitimate messages, it must first learn about what makes your email legitimate and about what you consider spam.

You tell it about one or several messages by selecting those messages in Entourage and then either running the appropriate "Mark as..." script from Entourage's script menu or by using the equivalent menu command in either of JunkBrooms menus. (It is probably easiest to use the dock menu items because they are easily accessible - unlike the often cluttered scripts menu.)

You should not overdo training. Add ten to twenty messages of each kind to the database and then try the filter. If it doesn't work well, the messages are too homogenous and don't cover your email well enough and you'll have to continue training.

Classification

The "JunkBroom - Filter" script (and the corresponding menu entries) finds out if a selected message is spam and, if it is, marks it thus and moves it to the "Junk" folder (that folder was created during installation if it didn't exist).

You should call this script from a message rule. (Entourage can apply rules to incoming messages; if you do not know about this, consult Entourage's help.) This rule should cover all messages and apply the "JunkBroom - Filter" script to them.

Note that this rule should come last in your rule set bacause rules that apply AppleScripts will not allow any further rules to be processed.