Difference between revisions of "Plugins"

From Claws Mail FAQ
Jump to: navigation, search
m (Reverted edit of Shrillcoffin86, changed back to last version by Claws)
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Levis Pants really are examples of the first born denim jeans yet provided currently.http://www.scontoabercrombie.com/ , The corporate was basically started in 1853 and additionally during the beyond a hundred and fifty a long time considering that its understanding, the company comes with uncovered easy methods to provide you with denim jeans to help every single consumer for merely any special occasion imaginable.http://www.linkslondonforsale.com/ , Levi's really are suitable for all occasions ranging from the care-free trip to household, dating shopping, through to dinner time, perhaps even released for the daytime with the help of contacts.http://www.linksjoyas.com/ , Used aided by the best suited finest and the correct shoes and boots along with accessories you could bring ones Levi's from very professional to be able to really informal.http://www.buymontblancs.com/ ,
+
=== What are plugins? ===
  
 +
Plugins are modules loaded (or unloaded) by Claws Mail at runtime. They provide a
 +
way to extend Claws Mail with new capabilities you really need without having all of them wasting memory.
  
 +
=== Where are plugins located? ===
  
Salad dressing off a Levi's is really straight forward simply because you won't complete everything. The perfect tee tee shirt additionally your favourite sandals or athletic shoes plus you will be commited to memory just about anywhere. Through shopping, in the kids hobbies, out on a typical moment with the help of contacts, and better you will find that a pair of Levi shorts takes a person quite some distance. If you have had a single two you will find which you can set of two them with all of the treasured shoes or boots as well as shirts and obtain which unconventional appear you really enjoy in a very great pair of shorts. Much better, an individual's shorts will be more comfortable sufficiently that anyone can truly rest.
+
Plugins are located in your <tt>$PREFIX/lib/claws-mail/plugins</tt>. Typical locations are
 +
<tt>/usr/lib/claws-mail/plugins</tt> if you installed a packaged plugin and <tt>/usr/local/lib/claws-mail/plugins</tt> if you're installing from source. (plugins have
 +
a suffix of '.so')
  
Keep in mind, you can actually always dress up any a pair of jeans " up ", much too. These kind of jeans give a loan independently to looking nicely put together when they consists of a considerable amount of different shapes indeed make sure they are entertaining in order to spice up just a little bit. You can take similar two of bluejeans for which you attire down or be dressed in during an every single day schedule to search driving while using loved ones, jog errands, spend money, or simply the rest and additionally binocular individuals with a various major. Binocular your favorite set of two Levi's shorts by having a dressy fashion footwear, an outdoor shirt, some belt, and some add-ons in addition to there are a unique hunting two of jeans as compared with you felt the need sooner on the day. It's awesome to be familiar with which are just one two of jeans on your closet which might enable you to get from the beginning on the afternoon on the conclusion, while looking terrific.
+
=== I have loaded plugin X but how can I configure it? ===
  
While you may well enable a considerable amount of completely different designs associated with trousers, Levi's are notable for their freedom. You can the right gifts shapes which you want during the course of diverse colours or washes you will in order to understandthat everyone always have something with your at home which could glance great with a t-shirt not to mention athletic shoes or possibly with all your dressiest material and a good pair of costume shoes. All the two of Levi's usually are maybe there merely bottoms inside your full clothing collection that anyone can pair with just about any girls, fashion accessories, together with finest not to mention be aware of that you can action from home shopping very good. If your primary Levi's are nice and clean, then chances are you will have an item excellent towards utilize!
+
Plugin configuration options can be found under '/Configuration/Preferences/Plugins/' and/or '/Configuration/[Account Preferences]/Plugins'.
 +
 
 +
Some plugins have a separate interface plugin which provides the
 +
configuration pane for the X plugin. If you have loaded plugin <tt>X.so</tt> typical name
 +
for the configuration plugin will be <tt>X_gtk.so</tt>, but this is not mandatory, read
 +
plugin's documentation in case of doubt.
 +
 
 +
=== What plugins are currently available? ===
 +
 
 +
The following plugins are included in the Claws Mail release tarballs
 +
 
 +
; Bogofilter
 +
: Enables the scanning of incoming mail received from a POP, IMAP or LOCAL account using bogofilter. It can optionally delete mail identified as spam or save it to a designated folder. Faster than Spamassassin.
 +
: Bogofilter is available from http://www.bogofilter.org/
 +
 
 +
; Clam AntiVirus
 +
: Enables the scanning of message attachments in mail received from a POP, IMAP or LOCAL account using Clam AntiVirus. It can optionally delete the mail or save it to a designated folder. Preferences can be found in '/Configuration/Preferences/Plugins/Clam AntiVirus'.
 +
: Clam AntiVirus is available from http://clamav.sourceforge.net/
 +
 
 +
; Dillo HTML Viewer
 +
: Enables the viewing of html messages using the Dillo web browser, version 0.7.0 or newer. It uses Dillo's --local option by default for safe browsing. Preferences can be found in '/Configuration/Preferences/Plugins/Dillo Browser'.
 +
: Dillo is available from http://www.dillo.org/
 +
 
 +
; PGP/Core
 +
: Handles core PGP functions and is required by the PGP/Inline and PGP/MIME plugins.
 +
: Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
 +
 
 +
; PGP/inline
 +
: Handles inline PGP signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails.
 +
: Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
 +
 
 +
; PGP/MIME
 +
: Handles PGP/MIME signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails.
 +
: Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
 +
 
 +
; S/MIME
 +
: Handles S/MIME crypto (signing, encrypting, verifying signatures and decrypting). See [[S/MIME howto]] to get it working.
 +
 
 +
; SpamAssassin
 +
: Enables the scanning of incoming mail received from a POP, IMAP or LOCAL account using SpamAssassin. It can optionally delete mail identified as spam or save it to a designated folder. Preferences can be found in '/Configuration/ Preferences/Plugins/SpamAssassin'. More complete checks than Bogofilter.
 +
: SpamAssassin is available from http://spamassassin.apache.org/
 +
 
 +
; Trayicon
 +
: Places an icon in the notification area that indicates whether you have any new mail. A tooltip also shows the current new, unread and total number of messages
 +
 
 +
The following plugins are included in the Extra Plugins release tarballs and are also available from the [http://www.claws-mail.org/plugins.php Plugins] page
 +
 
 +
; AcpiNotifier
 +
: Enables mail notification via LEDs on some laptops.
 +
 
 +
; AddressKeeper
 +
: Allows to save outgoing email addresses to the Address Book automatically.
 +
 
 +
; AttRemover
 +
: This plugin lets you remove attachments from emails.
 +
 
 +
; AttachWarner
 +
: Warns when the user composes a message mentioning an attachment in the message body without attaching any files to the message.
 +
 
 +
; BSfilter
 +
: Check all messages that are received from an IMAP, LOCAL or POP account for spam using Bsfilter.
 +
 
 +
; Clamd
 +
: Allows message scanning for viruses using the ClamAV in daemon mode (clamd).
 +
 
 +
; Fancy
 +
: Renders HTML e-mail using the WebKit library.
 +
 
 +
; Fetchinfo
 +
: Inserts headers containing some download information: UIDL, Claws Mail account name, POP server, user ID and retrieval time.
 +
 
 +
; GeoLocation
 +
: This plugin provides GeoLocation functionality of the email sender.
 +
 
 +
; GtkHtml2 Viewer
 +
: Enables the viewing of html messages using libgtkhtml2. Fetches attached images, distant images (depending on the preferences), can cache the images.
 +
 
 +
; Mail Archiver
 +
: This plugin adds archiving features to Claws Mail.
 +
 
 +
; Mailmbox
 +
: Handles mailboxes in mbox format.
 +
 
 +
; NewMail
 +
:This plugin writes a msg header summary to a log file, (Default: ~/Mail/NewLog), on arrival of new mail *after* sorting.
 +
 
 +
; Notification
 +
: This plugin provides various ways to notify the user of new and unread email.
 +
 
 +
; Perl
 +
: Intended to extend the filtering possibilities of Claws Mail. It provides a Perl interface to Claws Mail's filtering mechanism, allowing the use of full Perl power in email filters.
 +
 
 +
; Python
 +
: This plugin provides Python integration features.
 +
 
 +
; RSSyl
 +
: Allows you to read your favorite newsfeeds in Claws Mail. RSS 1.0, 2.0 and Atom feeds are currently supported.
 +
 
 +
; SpamReport
 +
: Reports spam to various places.
 +
 
 +
; TNEF parse
 +
: This plugin enables reading application/ms-tnef attachments.
 +
 
 +
; vCalendar
 +
: Enables vCalendar message handling like that produced by Evolution or Outlook. It provides a personal calendar and public calendar import and export as well as Free/busy import and export to help planning meetings.
 +
 
 +
=== How do I configure SpamAssassin and the SpamAssassin plugin? ===
 +
 
 +
There are many configurations possible, this answer applies when the spamassassin daemon spamd is running on your local computer.
 +
 
 +
If you have the dependencies installed, the SpamAssassin plugin will be built automatically when building Claws Mail.  When you start Claws Mail the plugin is NOT loaded or enabled.  Load the plugins: Configuration|Plugins|Load Plugins, browse to your plugin directory location as described above. Load <tt>spamassassin.so</tt>. You then need to configure it in: Configuration|Preferences|Plugins|Spamassassin.  There are six items to set correctly.
 +
# Transport:  For our configuration set this to Localhost.  If ever you want to turn spam checking off, set this to Disabled.
 +
# Spamd:  This should be set to the IP port number that spamd is listening on, it's normally 783.
 +
# Save Spam: If cleared, this tickbox tells Claws Mail to delete mails that spamassassin thinks are spam.
 +
# Save Folder: If Save Spam is set, this is the folder that Claws Mail will send spam to.
 +
# Maximum Size: Spam is usually small, so it's a waste of resources to spam check very large emails, this sets the size threshold in KBytes.
 +
# Timeout: This is the time that Claws Mail will wait while spamd checks each message.  The default of 30 seconds is OK for most machines, but slow ones may need this increased.
 +
 
 +
Now you need to test the installation. Send yourself some spam.  When you receive it, it should be placed into the spam folder that you configured.  To check that spamd is being called, put a tail on your sys.log (mine is in <tt>/var/log/sys.log</tt>, so <tt>tail -f /var/log/sys.log</tt> works) and see if spamd runs and what it says.  If it is not running for every mail message received then check carefully both the SpamAssassin and Claws Mail settings.  If it is running, but not detecting spam, then you may need to train the bayesian filter - see SpamAssassin's documentation for that.
 +
 
 +
=== Does the SpamAssassin plugin change the email headers? ===
 +
 
 +
No, it only uses the return value from SpamAssassin, (SPAM/NOT SPAM). To use header changing ability of SpamAssassin you can either configure an [[Actions|Action]] (Report as SPAM: spamassassin -r < %f), or a [[Filtering and Processing of Messages|Filtering]] rule (test "!(spamc -c < %f)"), or setup fetchmail and procmail to filter emails into your Claws Mail mailbox instead of using the plugin.
 +
 
 +
=== How do I configure the bogofilter plugin to run on a remote server? ===
 +
 
 +
When you are receiving lots of messages, or reading them from several machines, it might be convenient to run bogofilter on a remote server rather than on your own machine when Claws downloads the messages. Although the bogofilter plugin currently only supports running bogofilter locally, (because it passes it the name of local files to process), it can be made to work with a remote server.
 +
 
 +
There are three steps to configuring Claws in such a context:
 +
 
 +
; Set up .procmailrc on the remote server
 +
: See the bogofilter documentation on how to do that. Presumably, bogofilter is run, marks the message as spam or ham, and move it to a Junk folder when it is spam.
 +
 
 +
; Set up Claws filters to mark messages as spam
 +
: When it is run, by default bogofilter will insert X-Bogosity headers in the messages. However, Claws currently ignores those. You must therefore create a pre-processing rule, 'header "X-Bogosity" match "Spam" mark_as_spam'
 +
 
 +
; Set up the bogofilter plugin to run bogofilter remotely
 +
: When some spam or ham was incorrectly detected, you can change its status through the toolbar icon created by the bogofilter plugin. However, the latter can only run a program on the local machine. The solution is to create a shell script, and setup the preferences for bogofilter to use this script as the "Bogofilter call", (for example /usr/local/bin/remotebogofilter.sh).
 +
An example of such a script would be:
 +
 
 +
  #!/bin/sh
 +
  remote_host=host.domain.com
 +
  cmd=`echo "bogofilter $@" | sed -e 's/-b//' `
 +
  while read; do
 +
    cat $REPLY | ssh $remote_host "$cmd"
 +
  done
 +
 
 +
=== How do I configure gpg-agent and the PGP plugin? ===
 +
 
 +
Attempts to use your gpg key to sign/encrypt messages will fail with a 'Signature failed' message without even asking you for your password if:
 +
# Your OS automatically starts the gpg-agent daemon AND
 +
# GPGME is properly configured to use the right GnuPG version (see [[Installation_and_Configuration#How_do_I_enable_GPG_support_in_Claws_Mail.3F|How do I enable GPG support in Claws Mail?]]) AND
 +
# you only have the CURSES based pinentry program installed AND
 +
# you started claws-mail from a menu or icon
 +
(Note: my Fedora Core 4 workstation install was configured this way).
 +
The solution is to make sure that you have the pinentry-gtk or pinentry-qt programs installed. Claws Mail will then present the pinentry dialog box to get your GPG passphrase.
 +
 
 +
You can tell if this is working by the dialog box presented to you for your passphrase. The pinentry dialog is a little uglier than the Claws Mail version, and the window title is 'pinentry'.
 +
 
 +
One advantage of using the gpg-agent over Claws Mail password dialog is that the password caching then works with other applications using the gpg-agent (eg the command line when you specify --use-agent).
 +
 
 +
Note 2: If it still refuses to work you might want to try the following steps:
 +
* Make sure your ''~/.gnupg/gpg.conf'' contains the line
 +
<code>use-agent</code>
 +
* Create a file ''~/.gnupg/gpg-agent.conf'' with the following contents:
 +
<code>
 +
<pre>
 +
pinentry-program /usr/bin/pinentry-qt
 +
no-grab
 +
default-cache-ttl 1800
 +
</pre>
 +
</code>
 +
* Add the following line to some startup script. (In case of KDE you could use ''~/.kde/env/gpgagent.sh''  -  The filename does not matter, the contents of ''~/.kde/env/'' is sourced by startkde)
 +
<pre>eval "$(gpg-agent --daemon)"</pre>
 +
 
 +
Note: If you make any changes to ''~/.gnupg/gpg-agent.conf'' while gpg-agent is running you will need to restart gpg-agent for the changes to take effect.
 +
 
 +
=== I love maildir format. Is there a useful replacement in Claws Mail, which is better than the maildir plugin ? ===
 +
 
 +
The maildir plugin used to work well, however it is currently '''unmaintained''', although you will probably be able to make it work with recent Claws Mail versions. The maildir plugin is not as efficient or as usable as the native MH format, (tested with 2GB of mails, folders with 30000 mails take a while to load), it lacks some important features and may well be buggy, so if you do use it, do so with caution. Also, if you plan to use it, please consider becoming the maintainer and bring it up to date. You can contact the [http://www.claws-mail.org/theteam.php Claws Mail Team] for that.
 +
 
 +
The good solution is to use the native format of Claws Mail: the MH format. You have two ways of doing this:
 +
 
 +
* Use a local account in MH format: you use the filters of Claws Mail to drop the mails directly on your disk in MH format. Then searching, indexing is very, very fast.
 +
 
 +
* Use an IMAP account: if choosing this way, your emails remain on the IMAP server BUT, when displayed, your mails are downloaded and stored in MH format on your disk too. They are dropped in ~/.claws-mail/imapcache/ and are synchronized with the server (see Synchronize folder in File menu).
 +
 
 +
In the two cases, Claws Mail uses the MH format and you can browse your emails with an alternative mail client able to read MH.

Revision as of 21:16, 8 October 2012

Contents

What are plugins?

Plugins are modules loaded (or unloaded) by Claws Mail at runtime. They provide a way to extend Claws Mail with new capabilities you really need without having all of them wasting memory.

Where are plugins located?

Plugins are located in your $PREFIX/lib/claws-mail/plugins. Typical locations are /usr/lib/claws-mail/plugins if you installed a packaged plugin and /usr/local/lib/claws-mail/plugins if you're installing from source. (plugins have a suffix of '.so')

I have loaded plugin X but how can I configure it?

Plugin configuration options can be found under '/Configuration/Preferences/Plugins/' and/or '/Configuration/[Account Preferences]/Plugins'.

Some plugins have a separate interface plugin which provides the configuration pane for the X plugin. If you have loaded plugin X.so typical name for the configuration plugin will be X_gtk.so, but this is not mandatory, read plugin's documentation in case of doubt.

What plugins are currently available?

The following plugins are included in the Claws Mail release tarballs

Bogofilter
Enables the scanning of incoming mail received from a POP, IMAP or LOCAL account using bogofilter. It can optionally delete mail identified as spam or save it to a designated folder. Faster than Spamassassin.
Bogofilter is available from http://www.bogofilter.org/
Clam AntiVirus
Enables the scanning of message attachments in mail received from a POP, IMAP or LOCAL account using Clam AntiVirus. It can optionally delete the mail or save it to a designated folder. Preferences can be found in '/Configuration/Preferences/Plugins/Clam AntiVirus'.
Clam AntiVirus is available from http://clamav.sourceforge.net/
Dillo HTML Viewer
Enables the viewing of html messages using the Dillo web browser, version 0.7.0 or newer. It uses Dillo's --local option by default for safe browsing. Preferences can be found in '/Configuration/Preferences/Plugins/Dillo Browser'.
Dillo is available from http://www.dillo.org/
PGP/Core
Handles core PGP functions and is required by the PGP/Inline and PGP/MIME plugins.
Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
PGP/inline
Handles inline PGP signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails.
Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
PGP/MIME
Handles PGP/MIME signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails.
Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/
S/MIME
Handles S/MIME crypto (signing, encrypting, verifying signatures and decrypting). See S/MIME howto to get it working.
SpamAssassin
Enables the scanning of incoming mail received from a POP, IMAP or LOCAL account using SpamAssassin. It can optionally delete mail identified as spam or save it to a designated folder. Preferences can be found in '/Configuration/ Preferences/Plugins/SpamAssassin'. More complete checks than Bogofilter.
SpamAssassin is available from http://spamassassin.apache.org/
Trayicon
Places an icon in the notification area that indicates whether you have any new mail. A tooltip also shows the current new, unread and total number of messages

The following plugins are included in the Extra Plugins release tarballs and are also available from the Plugins page

AcpiNotifier
Enables mail notification via LEDs on some laptops.
AddressKeeper
Allows to save outgoing email addresses to the Address Book automatically.
AttRemover
This plugin lets you remove attachments from emails.
AttachWarner
Warns when the user composes a message mentioning an attachment in the message body without attaching any files to the message.
BSfilter
Check all messages that are received from an IMAP, LOCAL or POP account for spam using Bsfilter.
Clamd
Allows message scanning for viruses using the ClamAV in daemon mode (clamd).
Fancy
Renders HTML e-mail using the WebKit library.
Fetchinfo
Inserts headers containing some download information: UIDL, Claws Mail account name, POP server, user ID and retrieval time.
GeoLocation
This plugin provides GeoLocation functionality of the email sender.
GtkHtml2 Viewer
Enables the viewing of html messages using libgtkhtml2. Fetches attached images, distant images (depending on the preferences), can cache the images.
Mail Archiver
This plugin adds archiving features to Claws Mail.
Mailmbox
Handles mailboxes in mbox format.
NewMail
This plugin writes a msg header summary to a log file, (Default: ~/Mail/NewLog), on arrival of new mail *after* sorting.
Notification
This plugin provides various ways to notify the user of new and unread email.
Perl
Intended to extend the filtering possibilities of Claws Mail. It provides a Perl interface to Claws Mail's filtering mechanism, allowing the use of full Perl power in email filters.
Python
This plugin provides Python integration features.
RSSyl
Allows you to read your favorite newsfeeds in Claws Mail. RSS 1.0, 2.0 and Atom feeds are currently supported.
SpamReport
Reports spam to various places.
TNEF parse
This plugin enables reading application/ms-tnef attachments.
vCalendar
Enables vCalendar message handling like that produced by Evolution or Outlook. It provides a personal calendar and public calendar import and export as well as Free/busy import and export to help planning meetings.

How do I configure SpamAssassin and the SpamAssassin plugin?

There are many configurations possible, this answer applies when the spamassassin daemon spamd is running on your local computer.

If you have the dependencies installed, the SpamAssassin plugin will be built automatically when building Claws Mail. When you start Claws Mail the plugin is NOT loaded or enabled. Load the plugins: Configuration|Plugins|Load Plugins, browse to your plugin directory location as described above. Load spamassassin.so. You then need to configure it in: Configuration|Preferences|Plugins|Spamassassin. There are six items to set correctly.

  1. Transport: For our configuration set this to Localhost. If ever you want to turn spam checking off, set this to Disabled.
  2. Spamd: This should be set to the IP port number that spamd is listening on, it's normally 783.
  3. Save Spam: If cleared, this tickbox tells Claws Mail to delete mails that spamassassin thinks are spam.
  4. Save Folder: If Save Spam is set, this is the folder that Claws Mail will send spam to.
  5. Maximum Size: Spam is usually small, so it's a waste of resources to spam check very large emails, this sets the size threshold in KBytes.
  6. Timeout: This is the time that Claws Mail will wait while spamd checks each message. The default of 30 seconds is OK for most machines, but slow ones may need this increased.

Now you need to test the installation. Send yourself some spam. When you receive it, it should be placed into the spam folder that you configured. To check that spamd is being called, put a tail on your sys.log (mine is in /var/log/sys.log, so tail -f /var/log/sys.log works) and see if spamd runs and what it says. If it is not running for every mail message received then check carefully both the SpamAssassin and Claws Mail settings. If it is running, but not detecting spam, then you may need to train the bayesian filter - see SpamAssassin's documentation for that.

Does the SpamAssassin plugin change the email headers?

No, it only uses the return value from SpamAssassin, (SPAM/NOT SPAM). To use header changing ability of SpamAssassin you can either configure an Action (Report as SPAM: spamassassin -r < %f), or a Filtering rule (test "!(spamc -c < %f)"), or setup fetchmail and procmail to filter emails into your Claws Mail mailbox instead of using the plugin.

How do I configure the bogofilter plugin to run on a remote server?

When you are receiving lots of messages, or reading them from several machines, it might be convenient to run bogofilter on a remote server rather than on your own machine when Claws downloads the messages. Although the bogofilter plugin currently only supports running bogofilter locally, (because it passes it the name of local files to process), it can be made to work with a remote server.

There are three steps to configuring Claws in such a context:

Set up .procmailrc on the remote server
See the bogofilter documentation on how to do that. Presumably, bogofilter is run, marks the message as spam or ham, and move it to a Junk folder when it is spam.
Set up Claws filters to mark messages as spam
When it is run, by default bogofilter will insert X-Bogosity headers in the messages. However, Claws currently ignores those. You must therefore create a pre-processing rule, 'header "X-Bogosity" match "Spam" mark_as_spam'
Set up the bogofilter plugin to run bogofilter remotely
When some spam or ham was incorrectly detected, you can change its status through the toolbar icon created by the bogofilter plugin. However, the latter can only run a program on the local machine. The solution is to create a shell script, and setup the preferences for bogofilter to use this script as the "Bogofilter call", (for example /usr/local/bin/remotebogofilter.sh).

An example of such a script would be:

 #!/bin/sh
 remote_host=host.domain.com
 cmd=`echo "bogofilter $@" | sed -e 's/-b//' `
 while read; do
    cat $REPLY | ssh $remote_host "$cmd"
 done

How do I configure gpg-agent and the PGP plugin?

Attempts to use your gpg key to sign/encrypt messages will fail with a 'Signature failed' message without even asking you for your password if:

  1. Your OS automatically starts the gpg-agent daemon AND
  2. GPGME is properly configured to use the right GnuPG version (see How do I enable GPG support in Claws Mail?) AND
  3. you only have the CURSES based pinentry program installed AND
  4. you started claws-mail from a menu or icon

(Note: my Fedora Core 4 workstation install was configured this way). The solution is to make sure that you have the pinentry-gtk or pinentry-qt programs installed. Claws Mail will then present the pinentry dialog box to get your GPG passphrase.

You can tell if this is working by the dialog box presented to you for your passphrase. The pinentry dialog is a little uglier than the Claws Mail version, and the window title is 'pinentry'.

One advantage of using the gpg-agent over Claws Mail password dialog is that the password caching then works with other applications using the gpg-agent (eg the command line when you specify --use-agent).

Note 2: If it still refuses to work you might want to try the following steps:

  • Make sure your ~/.gnupg/gpg.conf contains the line

use-agent

  • Create a file ~/.gnupg/gpg-agent.conf with the following contents:

pinentry-program /usr/bin/pinentry-qt
no-grab
default-cache-ttl 1800

  • Add the following line to some startup script. (In case of KDE you could use ~/.kde/env/gpgagent.sh - The filename does not matter, the contents of ~/.kde/env/ is sourced by startkde)
eval "$(gpg-agent --daemon)"

Note: If you make any changes to ~/.gnupg/gpg-agent.conf while gpg-agent is running you will need to restart gpg-agent for the changes to take effect.

I love maildir format. Is there a useful replacement in Claws Mail, which is better than the maildir plugin ?

The maildir plugin used to work well, however it is currently unmaintained, although you will probably be able to make it work with recent Claws Mail versions. The maildir plugin is not as efficient or as usable as the native MH format, (tested with 2GB of mails, folders with 30000 mails take a while to load), it lacks some important features and may well be buggy, so if you do use it, do so with caution. Also, if you plan to use it, please consider becoming the maintainer and bring it up to date. You can contact the Claws Mail Team for that.

The good solution is to use the native format of Claws Mail: the MH format. You have two ways of doing this:

  • Use a local account in MH format: you use the filters of Claws Mail to drop the mails directly on your disk in MH format. Then searching, indexing is very, very fast.
  • Use an IMAP account: if choosing this way, your emails remain on the IMAP server BUT, when displayed, your mails are downloaded and stored in MH format on your disk too. They are dropped in ~/.claws-mail/imapcache/ and are synchronized with the server (see Synchronize folder in File menu).

In the two cases, Claws Mail uses the MH format and you can browse your emails with an alternative mail client able to read MH.