The simplest method is to use the Bogofilter plugin, see the [[Plugins]] FAQ Page for further information. If you use that plugin, the following will not be needed

+

+

===== Filtering/Actions method =====

First of all, make sure you have trained bogofilter; for different training methods, see [http://bogofilter.sourceforge.net/faq.shtml#training http://bogofilter.sourceforge.net/faq.shtml#training]. Method 4 is recommended, but requires a large number of ham and spam messages.

First of all, make sure you have trained bogofilter; for different training methods, see [http://bogofilter.sourceforge.net/faq.shtml#training http://bogofilter.sourceforge.net/faq.shtml#training]. Method 4 is recommended, but requires a large number of ham and spam messages.

Line 14:

Line 17:

<pre>move "#mh/Mailbox/Spam"</pre>

<pre>move "#mh/Mailbox/Spam"</pre>

−

After having added the filtering rule you probably want to create two Sylpheed-Claws Actions: one for marking messages as spam, and one for marking messages as ham. These actions can be used to correct bogofilter and/or to train it with additional messages. For example, if the above filtering rule did not detect a spam message correctly, delivering it to your inbox, you can manually correct this by invoking a "Mark As Spam" action. As an added bonus, Actions are automatically added to the main menu (under Tools|Actions), and can also be added to the main toolbar.

+

After having added the filtering rule you probably want to create two Claws Mail Actions: one for marking messages as spam, and one for marking messages as ham. These actions can be used to correct bogofilter and/or to train it with additional messages. For example, if the above filtering rule did not detect a spam message correctly, delivering it to your inbox, you can manually correct this by invoking a "Mark As Spam" action. As an added bonus, Actions are automatically added to the main menu (under Tools|Actions), and can also be added to the main toolbar.

Open the Actions dialog (Configuration | Actions...). In the Menu name field, enter the following:

Open the Actions dialog (Configuration | Actions...). In the Menu name field, enter the following:

Line 35:

Line 38:

And add the action by clicking the Add button.

And add the action by clicking the Add button.

−

This gives you a basic setup for bogofilter and Sylpheed-Claws.

+

This gives you a basic setup for bogofilter and Claws Mail.

−

+

=== How can I use Claws Mail with Popfile? ===

−

=== How can I use Sylpheed-Claws with Popfile? ===

+

You can reclass messages received trough a Popfile filter with a header link or a button in Claws Mail.

−

You can reclass messages received trough a Popfile filter with a header link or a button in Sylpheed-Claws.

+

Popfile lives @ http://getpopfile.org/

−

Popfile lives @ http://popfile.sourceforge.net/

+

First read the Popfile documentation on how to set up the mail client to use Popfile.

First read the Popfile documentation on how to set up the mail client to use Popfile.

Line 49:

Line 51:

* Open the Popfile control center, go to the "Buckets" tab, and make sure ALL buckets have the ''X-POPFile-Link Header'' turned on.

* Open the Popfile control center, go to the "Buckets" tab, and make sure ALL buckets have the ''X-POPFile-Link Header'' turned on.

* All messages received via Popfile will have a header link (just above the message body) called ''X-POPFile-Link'', something like this: ''X-POPFile-Link: http://127.0.0.1:7070/jump_to_message?view=6491'' - you can click on it and Claws will open the link with the browser you set up in preferences.

* All messages received via Popfile will have a header link (just above the message body) called ''X-POPFile-Link'', something like this: ''X-POPFile-Link: http://127.0.0.1:7070/jump_to_message?view=6491'' - you can click on it and Claws will open the link with the browser you set up in preferences.

Line 57:

Line 59:

You will need 3 things:

You will need 3 things:

* a bash script

* a bash script

−

* a Sylpheed-Claws action

+

* a Claws Mail action

* change Popfile configuration a bit.

* change Popfile configuration a bit.

Line 80:

Line 82:

You will be able to reclass messages that were received with the above option turned ON.

You will be able to reclass messages that were received with the above option turned ON.

−

=== How can I use Sylpheed-Claws with SpamAssassin? ===

+

=== How can I use Claws Mail with SpamAssassin? ===

+

The simplest method is to use the SpamAssassin plugin, see the [[Plugins]] FAQ Page for further information.

−

To train spamassassin in Sylpheed-Claws (>=1.9.6):

+

===== Filtering/Actions method =====

+

+

To train spamassassin in Claws Mail (>=1.9.6):

<br>

<br>

Menu > Configuration > Actions

Menu > Configuration > Actions

<br> In 'Menu Name' add "Mark as Spam"

<br> In 'Menu Name' add "Mark as Spam"

−

<br> In 'Command line' add -sa-learn --spam %F-

+

<br> In 'Command line' add "sa-learn --spam %F"

<br> click the Add button

<br> click the Add button

<br>

<br>

Menu > Configuration > Actions

Menu > Configuration > Actions

<br> In 'Menu Name' add "Mark as Ham"

<br> In 'Menu Name' add "Mark as Ham"

−

<br> In 'Command line' add -sa-learn --ham %F-

+

<br> In 'Command line' add "sa-learn --ham %F"

<br> click the Add button

<br> click the Add button

<br> then select a message, <b>Menu Tools > Actions</b>

<br> then select a message, <b>Menu Tools > Actions</b>

will have the new actions to mark your email as Spam/Ham. Once you click one of the buttons spamassassin will process your request - this takes time so be patient and dont click on the 'cancel' button.

will have the new actions to mark your email as Spam/Ham. Once you click one of the buttons spamassassin will process your request - this takes time so be patient and dont click on the 'cancel' button.

−

[[Note:]]

+

Note:

<br>

<br>

If you want to have the mail learned on a remote mail server, that's possible with a 'Command line' like this:

If you want to have the mail learned on a remote mail server, that's possible with a 'Command line' like this:

Line 104:

Line 109:

It works best if you have already setup ssh to use keys for authentication.

It works best if you have already setup ssh to use keys for authentication.

See [http://kb.mozillazine.org/Command_line_arguments Firefox's Command line arguments] for more information.

+

+

See also: [http://www.claws-mail.org/faq/index.php?title=Installation_and_Configuration#How_can_I_tell_my_browser.2Fnewsclient.2Fother_program_to_use_Claws_Mail_as_e-mail_program.3F How can I tell my browser/newsclient/other program to use Claws Mail as e-mail program?]

+

+

=== How can I use Claws Mail with mairix? ===

+

+

In addition to the quicksearch, that allows filtering out messages in folders

+

recursively, you can use mairix in Claws Mail in order to perform message searches across a wide range of folders.

+

+

To illustrate this topic, we'll detail the necessary steps to make a global search in a MH config (in our example, ~/Mail).

+

+

- install mairix from http://www.rpcurnow.force9.co.uk/mairix/ or get it from your packages repository. mairix is a program for indexing and searching email messages stored in Maildir, MH or mbox folders. We recommend to avoid using version 0.20 (0.17 to 0.19 are fine).

+

+

- create a folder in Claws Mail where the search results will be stored in (in

+

our example: ~/Mail/Search).

+

+

- create a mairix config file (~/.mairixrc for instance):

+

+

<pre>

+

base=~/Mail

+

mh=*...

+

omit=draft:queue:trash:Junk:Search

+

database=~/.mairix_db

+

mfolder=Search

+

mformat=mh

+

</pre>

+

+

in that example, the base directory is ~/Mail, the search will be performed across all folders and sub-folders (mh=*...) in the base directory. Search will omit drafts, queue, trash, Junk and Search folders located in the base directory, and will place results into the Search folder. If you're in the search folder prior to starting the search, you'll have to select click "View/Update summary" to refresh the messages list.

+

+

See `man mairix` for more information about the mairix configuration file.

+

+

- add an action in Claws Mail to start the mairix search:

+

+

<pre>

+

> ~/.claws-mail/tools/mairix.sh ~/.mairixrc

+

</pre>

+

+

make sure that you've installed mairix.sh from the Tools pages (http://www.claws-mail.org/tools/claws-mail-mairix.tar.gz) into ~/.claws-mail/tools or wherever you want, provided that you set the correct path in the action text.

+

+

Now call the action. You'll be asked for the text to search for. Search results - symlinks to the existing message files, will be placed into the target folder, making it like a virtual folder. Removing messages from that folder will NOT remove the original message files. The text to search for is an expression to pass to mairix. See `man mairix` for all search

+

patterns.

+

+

+

You can create as many mairix config files as you want (be sure that you set a different database value in each of them), then create the corresponding actions that call mairix.sh with the config filename in parameter.

+

+

+

=== How can I use Claws Mail with httppc? ===

+

+

If you need to use Claws Mail behind an HTTP proxy that supports "CONNECT" method (RFC 2616), you may want to use [http://httppc.sourceforge.net/ httppc library]: it's a simple and fast way to achieve this goal.

+

+

An step-by-step example of how to set up version 0.8.5 follows.

+

+

First we need to get the source archive from the SourceForge repository and unpack it:

'''''Note:''''' By default, the package's files are installed in `/usr/local/bin', `/usr/local/man', etc. If you wish to specify another location for these files, you can specify an installation prefix other than `/usr/local' by giving `configure' the option `--prefix=PATH'. Please refer to the INSTALL file for further information.

+

+

Finally we build and install it:

+

<pre>

+

make

+

make check #optional

+

make install

+

</pre>

+

+

'''''Note:''''' You may encounter an error while compiling driver.c, stating

+

<pre>

+

driver.c: In function 'getaddrinfo':

+

driver.c:557:13: error: 'EAI_NODATA' undeclared

+

</pre>

+

In this case, just insert the "-D_GNU_SOURCE" option in the Makefile, for instance in the "DEFS" line:

* Then the httppc configuration file (located at /usr/local/etc/httppcrc by default). Define at least the proxy parameter, and most probably the ldns parameter if you have a local DNS server behind the HTTP proxy as well.

+

+

We should be all set. The script should be in our path and can be launched with

+

<pre>

+

proxed claws-mail

+

</pre>

+

+

'''''Tip:''''' We can add a shell alias to launch typing less (example for ~/.bashrc):

Add a new filtering rule: you need a filtering condition which runs bogofilter on incoming messages; and an action that has to be performed if the message was recognised as spam.
Go to the Filtering Configuration dialog, and type the following in the condition entry field:

test "bogofilter -u < %F"

Note 1: this assumes that bogofilter is in your path!
Note 2: the -u parameter of bogofilter registers the message automatically as either spam or ham.

Next add an action in the Action field. The best way is to use the Define... button next to the field. As an example, if you wanted to move a spam messages to a directory called Spam, then the final action, put in the field, could look like this:

move "#mh/Mailbox/Spam"

After having added the filtering rule you probably want to create two Claws Mail Actions: one for marking messages as spam, and one for marking messages as ham. These actions can be used to correct bogofilter and/or to train it with additional messages. For example, if the above filtering rule did not detect a spam message correctly, delivering it to your inbox, you can manually correct this by invoking a "Mark As Spam" action. As an added bonus, Actions are automatically added to the main menu (under Tools|Actions), and can also be added to the main toolbar.

Open the Actions dialog (Configuration | Actions...). In the Menu name field, enter the following:

Mark As Spam

This is just the text as it would appear in the Tools|Actions submenu.

The accompanying command line for Mark As Spam should be:

bogofilter -Ns -B %F

(Don't forget to use the Add button!)

Likewise, the same thing you should do for marking messages as ham. Select "New" in the Current actions list, and enter the following in the Menu name:

Mark As Ham

The command line for this action should be:

bogofilter -Sn -B %F

And add the action by clicking the Add button.

This gives you a basic setup for bogofilter and Claws Mail.

How can I use Claws Mail with Popfile?

You can reclass messages received trough a Popfile filter with a header link or a button in Claws Mail.
Popfile lives @ http://getpopfile.org/

First read the Popfile documentation on how to set up the mail client to use Popfile.

You have 2 options to reclass received messages: a simple one (header link) and a difficult one (toolbar button).

1) Simple method

Open the Popfile control center, go to the "Buckets" tab, and make sure ALL buckets have the X-POPFile-Link Header turned on.

All messages received via Popfile will have a header link (just above the message body) called X-POPFile-Link, something like this: X-POPFile-Link: http://127.0.0.1:7070/jump_to_message?view=6491 - you can click on it and Claws will open the link with the browser you set up in preferences.

You will be able to reclass messages that were received with the above option turned ON.

How can I use Claws Mail with SpamAssassin?

The simplest method is to use the SpamAssassin plugin, see the Plugins FAQ Page for further information.

Filtering/Actions method

To train spamassassin in Claws Mail (>=1.9.6):
Menu > Configuration > Actions
In 'Menu Name' add "Mark as Spam"
In 'Command line' add "sa-learn --spam %F"
click the Add button
Menu > Configuration > Actions
In 'Menu Name' add "Mark as Ham"
In 'Command line' add "sa-learn --ham %F"
click the Add button
then select a message, Menu Tools > Actions
will have the new actions to mark your email as Spam/Ham. Once you click one of the buttons spamassassin will process your request - this takes time so be patient and dont click on the 'cancel' button.

Note:
If you want to have the mail learned on a remote mail server, that's possible with a 'Command line' like this:
ssh host.domain sa-learn --ham < %f
It works best if you have already setup ssh to use keys for authentication.

How can I use Claws Mail with mairix?

In addition to the quicksearch, that allows filtering out messages in folders
recursively, you can use mairix in Claws Mail in order to perform message searches across a wide range of folders.

To illustrate this topic, we'll detail the necessary steps to make a global search in a MH config (in our example, ~/Mail).

- install mairix from http://www.rpcurnow.force9.co.uk/mairix/ or get it from your packages repository. mairix is a program for indexing and searching email messages stored in Maildir, MH or mbox folders. We recommend to avoid using version 0.20 (0.17 to 0.19 are fine).

- create a folder in Claws Mail where the search results will be stored in (in
our example: ~/Mail/Search).

in that example, the base directory is ~/Mail, the search will be performed across all folders and sub-folders (mh=*...) in the base directory. Search will omit drafts, queue, trash, Junk and Search folders located in the base directory, and will place results into the Search folder. If you're in the search folder prior to starting the search, you'll have to select click "View/Update summary" to refresh the messages list.

See `man mairix` for more information about the mairix configuration file.

Now call the action. You'll be asked for the text to search for. Search results - symlinks to the existing message files, will be placed into the target folder, making it like a virtual folder. Removing messages from that folder will NOT remove the original message files. The text to search for is an expression to pass to mairix. See `man mairix` for all search
patterns.

You can create as many mairix config files as you want (be sure that you set a different database value in each of them), then create the corresponding actions that call mairix.sh with the config filename in parameter.

How can I use Claws Mail with httppc?

If you need to use Claws Mail behind an HTTP proxy that supports "CONNECT" method (RFC 2616), you may want to use httppc library: it's a simple and fast way to achieve this goal.

An step-by-step example of how to set up version 0.8.5 follows.

First we need to get the source archive from the SourceForge repository and unpack it:

Note: By default, the package's files are installed in `/usr/local/bin', `/usr/local/man', etc. If you wish to specify another location for these files, you can specify an installation prefix other than `/usr/local' by giving `configure' the option `--prefix=PATH'. Please refer to the INSTALL file for further information.

We now need to edit the configuration a bit to make it fully functional:

First, the proxed shell script (located at /usr/local/bin/proxed by default). Define at least the $HTTP_PROXY variable.

Then the httppc configuration file (located at /usr/local/etc/httppcrc by default). Define at least the proxy parameter, and most probably the ldns parameter if you have a local DNS server behind the HTTP proxy as well.

We should be all set. The script should be in our path and can be launched with

proxed claws-mail

Tip: We can add a shell alias to launch typing less (example for ~/.bashrc):