Difference between revisions of "Installation and Configuration"

From Claws Mail FAQ
Jump to: navigation, search
(How do I make my own compface image?)
m
Line 1: Line 1:
=== What do I need to compile Sylpheed-Claws? ===
+
=== What do I need to compile Claws Mail? ===
  
 
<u>Required:</u>
 
<u>Required:</u>
Line 24: Line 24:
 
; GtkMathView : for MathML viewer plugin support
 
; GtkMathView : for MathML viewer plugin support
  
=== How do I set up Sylpheed-Claws? ===
+
=== How do I set up Claws Mail? ===
  
When you run Sylpheed-Claws for the first time, the Installation Wizard will appear and prompt you for the minimum required information necessary to start using Sylpheed-Claws in less than 5 minutes.
+
When you run Claws Mail for the first time, the Installation Wizard will appear and prompt you for the minimum required information necessary to start using Claws Mail in less than 5 minutes.
  
 
=== Why did the creation of the mailbox fail? ===
 
=== Why did the creation of the mailbox fail? ===
  
Sylpheed-Claws reports such an error if it can't create the default mailboxes (inbox, outbox, etc ...). This can be because <homedir>/Mail already contains files with the same names. This occurs when switching from Kmail to Sylpheed-Claws, in this case backup and remove the existing Mail directory or use another name for the Sylpheed-Claws mail directory.
+
Claws Mail reports such an error if it can't create the default mailboxes (inbox, outbox, etc ...). This can be because <homedir>/Mail already contains files with the same names. This occurs when switching from Kmail to Claws Mail, in this case backup and remove the existing Mail directory or use another name for the Claws Mail mail directory.
  
 
=== How do I create a new account? ===
 
=== How do I create a new account? ===
Line 36: Line 36:
 
You can add an account by using the menu item '/Configuration/Create new account'
 
You can add an account by using the menu item '/Configuration/Create new account'
  
=== Why does Sylpheed-Claws not delete my mails when I press "delete"? I set a filter, and Sylpheed-Claws does not filter. I moved a mail to a different mailbox and it did not move. ===
+
=== Why does Claws Mail not delete my mails when I press "delete"? I set a filter, and Claws Mail does not filter. I moved a mail to a different mailbox and it did not move. ===
  
 
You have the configuration option /Configuration/Preferences/Common Interface tab 'Execute immediately when moving or deleting messages' disabled.
 
You have the configuration option /Configuration/Preferences/Common Interface tab 'Execute immediately when moving or deleting messages' disabled.
Line 44: Line 44:
 
Yes, you can. In the Account preferences, on the 'Advanced' tab you can specify the port addresses that you want to use.
 
Yes, you can. In the Account preferences, on the 'Advanced' tab you can specify the port addresses that you want to use.
  
=== Does Sylpheed-Claws have options for threading messages? ===
+
=== Does Claws Mail have options for threading messages? ===
  
Yes. You can switch it on and off in the Summary Menu, just select "Thread View" or press Ctrl+T. (This only affects the currently selected folder; i.e. it is a folder property.)
+
Yes. You can switch it on and off in the View Menu, just select "Thread View" or press Ctrl+T. (This only affects the currently selected folder; i.e. it is a folder property.)
  
 
=== Can I create multiple levels of subfolders to store mail? ===
 
=== Can I create multiple levels of subfolders to store mail? ===
Line 54: Line 54:
 
=== How do I apply a patch after downloading it? ===
 
=== How do I apply a patch after downloading it? ===
  
Copy patch to Sylpheed-Claws directory Apply the patch:
+
Copy patch to Claws Mail directory Apply the patch:
 
<pre><nowiki>
 
<pre><nowiki>
 
  % patch -p0 < some.patch
 
  % patch -p0 < some.patch
Line 63: Line 63:
 
</nowiki></pre>
 
</nowiki></pre>
  
Run =./autogen.sh=, remove the generated =/config.cache= file (unless you want to install in prefix /usr/local). Run =./configure= with the appropriate options and then make. (Text as found on the Sylpheed patches page.)
+
Run =./autogen.sh=, remove the generated =/config.cache= file (unless you want to install in prefix /usr/local). Run =./configure= with the appropriate options and then make. (Text as found on the Sylpheed patch page.)
  
 
=== How do I compile in support for compface pictures? ===
 
=== How do I compile in support for compface pictures? ===
  
You have to have a package called libcompface installed, so this is available for compiling into Sylpheed-Claws. You can find out more and download it at http://freshmeat.net/projects/compface/ . Also, Tim Jackson has a spec file, which you can use to build an RPM of compface, at http://www.timj.co.uk/linux/rpms.php .
+
You have to have a package called libcompface installed, so this is available for compiling into Claws Mail. You can find out more and download it at http://freshmeat.net/projects/compface/ . Also, Tim Jackson has a spec file, which you can use to build an RPM of compface, at http://www.timj.co.uk/linux/rpms.php .
  
 
=== How do I make my own compface image? ===
 
=== How do I make my own compface image? ===
  
You can use the gif2xface.pl script, which converts a 48x48 gif to the format suitable for compface. This script can be found in the 'tools' directory, along with a README. It is also available from this site: http://www.sylpheed-claws.net/tools.php.
+
You can use the gif2xface.pl script, which converts a 48x48 gif to the format suitable for compface. This script can be found in the 'tools' directory, along with a README. It is also available from this site: http://www.claws-mail.org/tools.php.
You can also let Sylpheed-Claws create it by itself from a .xbm file.
+
You can also let Claws Mail create it by itself from a .xbm file.
  
=== How can I make Sylpheed-Claws send my compface image in the mails? ===
+
=== How can I make Claws Mail send my compface image in the mails? ===
  
 
In the Configuration menu, Preferences for current account, Send tab, check Add user-defined header and press Edit button. A dialog appears, add a header named "X-Face" and fill the value field with your face data. Alternatively, you can select a .xbm file in this dialog. Note that if you paste the data from a terminal into the field some spurious newlines can be added, and these can mangle your face, be careful.
 
In the Configuration menu, Preferences for current account, Send tab, check Add user-defined header and press Edit button. A dialog appears, add a header named "X-Face" and fill the value field with your face data. Alternatively, you can select a .xbm file in this dialog. Note that if you paste the data from a terminal into the field some spurious newlines can be added, and these can mangle your face, be careful.
  
=== How can I tell my browser/newsclient/other program to use Sylpheed-Claws as e-mail program? ===
+
=== How can I tell my browser/newsclient/other program to use Claws Mail as e-mail program? ===
  
 
In the settings part of the program, use <code>sylpheed-claws --compose "%t?subject=%s&body=%d"</code>
 
In the settings part of the program, use <code>sylpheed-claws --compose "%t?subject=%s&body=%d"</code>
Line 84: Line 84:
 
; Specific options for typical browsers :  
 
; Specific options for typical browsers :  
 
; Opera:
 
; Opera:
  <pre>sylpheed-claws --compose <nowiki>mailto:%t?subject=%s</nowiki></pre>
+
  <pre>claws-mail --compose <nowiki>mailto:%t?subject=%s</nowiki></pre>
 
; Galeon:
 
; Galeon:
  <pre>sylpheed-claws --compose <nowiki>"mailto:%t?subject=%s&body=%d"</nowiki></pre>
+
  <pre>claws-mail --compose <nowiki>"mailto:%t?subject=%s&body=%d"</nowiki></pre>
; Konqueror : See [[Installation_And_Configuration#konqueror|How do I make sylpheed the default mail application for KDE]]?
+
; Konqueror : See [[Installation_And_Configuration#konqueror|How do I make Claws Mail the default mail application for KDE]]?
  
=== How do I enable GPG support in Sylpheed-Claws? ===
+
=== How do I enable GPG support in Claws Mail? ===
  
 
GunPG support requires GnuPG >= 0.4.x and GPGME >= 1.x.x.
 
GunPG support requires GnuPG >= 0.4.x and GPGME >= 1.x.x.
Line 95: Line 95:
 
You need to load the PGP/Core, PGP/MIME, and PGP/inline plugins. '/Configuration/Plugins/Load plugin'.
 
You need to load the PGP/Core, PGP/MIME, and PGP/inline plugins. '/Configuration/Plugins/Load plugin'.
  
=== Mutt does not recognize Sylpheed-Claws' MH structure ===
+
=== Mutt does not recognize Claws Mail's MH structure ===
  
 
For this to work you need to use the <code>touch</code> command in every MH folder. <code>touch</code> the file <code>.xmhcache</code> and Mutt should do just fine.
 
For this to work you need to use the <code>touch</code> command in every MH folder. <code>touch</code> the file <code>.xmhcache</code> and Mutt should do just fine.
  
=== How can I make Sylpheed-Claws notify me when new mail arrives? ===
+
=== How can I make Claws Mail notify me when new mail arrives? ===
  
Go to '/Configuration/Preferences/Common', on the 'Receive' tab use the settings for 'Run command when new mail arrives'. You can also use the Trayicon (which is shipped with Sylpheed-Claws) or Acpi-notifier or Notification plugins, which are available on the [http://www.sylpheed-claws.net/plugins.php Plugins page].
+
Go to '/Configuration/Preferences/Common', on the 'Receive' tab use the settings for 'Run command when new mail arrives'. You can also use the Trayicon (which is shipped with Claws Mail) or Acpi-notifier or Notification plugins, which are available on the [http://www.claws-mail.org/plugins.php Plugins page].
  
=== Can I use a spell checker with Sylpheed-Claws? ===
+
=== Can I use a spell checker with Claws Mail? ===
  
 
Install Aspell >= 0.50 and use the <code>./configure</code> option <code>--enable-aspell</code>
 
Install Aspell >= 0.50 and use the <code>./configure</code> option <code>--enable-aspell</code>
Line 135: Line 135:
 
=== How can I select different applications to open with specific MIME types? ===
 
=== How can I select different applications to open with specific MIME types? ===
  
The MIME-type->application associations are kept in <code>/etc/mailcap</code>. Note that you need metamail installed to process the opening of the attachment.
+
The MIME-type->application associations are kept in <code>~/.mailcap</code> and <code>/etc/mailcap</code>.
  
 
=== How can I change the suggested mimetype for attachments I am sending? ===
 
=== How can I change the suggested mimetype for attachments I am sending? ===
Line 143: Line 143:
 
=== Why is the folder list not updated after I manually moved/copied folders? ===
 
=== Why is the folder list not updated after I manually moved/copied folders? ===
  
You need to update Sylpheed-Claws' cache. Right click on the mailbox and choose "Check for new folders".
+
You need to update Claws Mail's cache. Right click on the mailbox and choose "Check for new folders".
  
 
=== How can I revert original settings, e.g. for fonts, keybindings, etc.? ===
 
=== How can I revert original settings, e.g. for fonts, keybindings, etc.? ===
  
Sylpheed-Claws keeps its configuration files in <code>$HOME/.sylpheed-claws/sylpheedrc</code> and creates default entries, if none are found. So the easiest way is to quit sylpheed, temporarily renaming your <code>$HOME/.sylpheed-claws</code> e.g. to <code>*.bak</code> and restarting sylpheed in order to get default entries.
+
Claws Mail keeps its configuration files in <code>$HOME/.claws-mail/clawsrc</code> and creates default entries, if none are found. So the easiest way is to quit claws-mail, temporarily renaming your <code>$HOME/.claws-mail</code> e.g. to <code>*.bak</code> and restarting claws-mail in order to get default entries.
  
=== What environment variables have effect on Sylpheed-Claws? ===
+
=== What environment variables have effect on Claws Mail? ===
  
 
; Here are the most common variables :  
 
; Here are the most common variables :  
; HOME : location of .sylpheed (config directory) and default folder for Mailboxes.
+
; HOME : location of .claws-mail (config directory) and default folder for Mailboxes.
 
; LANG
 
; LANG
 
; LC_ALL
 
; LC_ALL
Line 172: Line 172:
 
=== What config files are there, and what are they used for? ===
 
=== What config files are there, and what are they used for? ===
  
Sylpheed-Claws' config files can be found in <code>$HOME/.sylpheed-claws</code>. They are in plain text format and quite easy to understand, so dont fear to take a look into them using a texteditor.
+
Claws Mail's config files can be found in <code>$HOME/.claws-mail</code>. They are in plain text format and quite easy to understand, so dont fear to take a look into them using a texteditor.
  
; sylpheedrc : main configuration: nearly all options from the settings window, e.g. mailbox location, font entries, etc.
+
; clawsrc : main configuration: nearly all options from the settings window, e.g. mailbox location, font entries, etc.
 
; accountrc : settings for pop/imap/nntp accounts
 
; accountrc : settings for pop/imap/nntp accounts
 
; actionsrc : user defined actions
 
; actionsrc : user defined actions
Line 190: Line 190:
 
Most precompiled packages will use the libgnomeprintui library, which will allow you to print your emails simply with the same interface as Gnome apps. It will be compiled in if you have libgnomeprint-dev and libgnomeprintui-dev packages installed.
 
Most precompiled packages will use the libgnomeprintui library, which will allow you to print your emails simply with the same interface as Gnome apps. It will be compiled in if you have libgnomeprint-dev and libgnomeprintui-dev packages installed.
  
If Sylpheed-Claws hasn't been compiled with libgnomeprintui support, you can use enscript. Use <code>enscript %s</code> to print everything on one page, or <code>enscript -U2 %s</code> for printing two logical pages on one physical page.
+
If Claws Mail hasn't been compiled with libgnomeprintui support, you can use enscript. Use <code>enscript %s</code> to print everything on one page, or <code>enscript -U2 %s</code> for printing two logical pages on one physical page.
  
 
As a more pretty alternative: Use [http://muttprint.sf.net muttprint]. The print-command would then look something like this: <code>muttprint -f %s</code>
 
As a more pretty alternative: Use [http://muttprint.sf.net muttprint]. The print-command would then look something like this: <code>muttprint -f %s</code>
Line 200: Line 200:
 
=== Mail is not sent because the queue folder cannot be found? ===
 
=== Mail is not sent because the queue folder cannot be found? ===
  
(From the old bug tracker): Sylpheed-Claws requires a queue folder. This
+
(From the old bug tracker): Claws Mail requires a queue folder. This
was changed to prevent message losses, if Sylpheed-Claws is killed while sending. Create a local folder (/File/Add Mailbox.../MH) for the queue and sending should work. I would not suggest to use the imap
+
was changed to prevent message losses, if Claws Mail is killed while sending. Create a local folder (/File/Add Mailbox.../MH) for the queue and sending should work. I would not suggest to use the imap
 
server for this purpose because sylpheeds queue messages have a special header that can not be handled correctly by the imap server, when the data for the summaryview is queried.
 
server for this purpose because sylpheeds queue messages have a special header that can not be handled correctly by the imap server, when the data for the summaryview is queried.
  
If you really want to create a queueing folder in an IMAP server, you just have to create an ordinary folder in it, and then edit folderlist.xml file in sylpheed's configuration directory. In this file, you will find a "folderitem" tag, with its "name" attribute set to the IMAP folder name you just created for queueing. You should edit this tag, and set its "type" attribute set to "queue". Note that this "folderitem" you're looking that will be a child of an "folder" tag that has its "type" attribute set to "imap".
+
If you really want to create a queueing folder in an IMAP server, you just have to create an ordinary folder in it, and then edit folderlist.xml file in Claws Mail's configuration directory. In this file, you will find a "folderitem" tag, with its "name" attribute set to the IMAP folder name you just created for queueing. You should edit this tag, and set its "type" attribute set to "queue". Note that this "folderitem" you're looking that will be a child of an "folder" tag that has its "type" attribute set to "imap".
  
 
=== What is the purpose of this bizarre "Enable Alternate Dictionary" option? ===
 
=== What is the purpose of this bizarre "Enable Alternate Dictionary" option? ===
Line 216: Line 216:
 
If you prefer checking while you type, just bind the <Spelling/Check backwards misspelled word> and <Spelling/Forward to next misspelled word> to two quick keyboard short cuts.  Then, as soon as you mistype a word, call the <Check backwards...> short-cut ---you do not need to move the cursor--- and without using the mouse select the suggestion. As GNU/Aspell does a good job at suggesting a replacement, you will often end to type <a>, and as the cursor did not move, just continue typing.  In contrast, the other option, <Forward to next...> does move the cursor.  This is because if you have text after the cursor, that also means in general that you are only editing a message, and not writing it, so advancing the cursor to the misspelled word is in general the wanted behaviour.
 
If you prefer checking while you type, just bind the <Spelling/Check backwards misspelled word> and <Spelling/Forward to next misspelled word> to two quick keyboard short cuts.  Then, as soon as you mistype a word, call the <Check backwards...> short-cut ---you do not need to move the cursor--- and without using the mouse select the suggestion. As GNU/Aspell does a good job at suggesting a replacement, you will often end to type <a>, and as the cursor did not move, just continue typing.  In contrast, the other option, <Forward to next...> does move the cursor.  This is because if you have text after the cursor, that also means in general that you are only editing a message, and not writing it, so advancing the cursor to the misspelled word is in general the wanted behaviour.
 
<div id=konqueror>
 
<div id=konqueror>
=== How do I make sylpheed the default mail application for KDE? ===
+
=== How do I make Claws Mail the default mail application for KDE? ===
  
KDE does not support passing the full URL to a mailer (see [http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/show_bug.cgi?id=658 bug 658] and the corresponding [http://bugs.kde.org/show_bug.cgi?id=81598 KDE bug entry]).
+
KDE does not support passing the full URL to a mailer (see [http://www.thewildbeast.co.uk/claws-mail/bugzilla/show_bug.cgi?id=658 bug 658] and the corresponding [http://bugs.kde.org/show_bug.cgi?id=81598 KDE bug entry]).
 
But there is a workaround - do the following as root:
 
But there is a workaround - do the following as root:
 
<pre>
 
<pre>
wget http://www.sylpheed-claws.net/tools/sylpheed-compose.pl
+
wget http://www.claws-mail.org/tools/claws-mail-compose.pl
mv sylpheed-compose.pl /usr/local/bin
+
mv claws-mail-compose.pl /usr/local/bin
chmod +x /usr/local/bin/sylpheed-compose.pl
+
chmod +x /usr/local/bin/claws-mail-compose.pl
 
</pre>
 
</pre>
 
Then go to the KDE Control Center -> KDE Components -> Component Chooser -> Email Client, choose "Use a different email client" and enter the following into the textbox:
 
Then go to the KDE Control Center -> KDE Components -> Component Chooser -> Email Client, choose "Use a different email client" and enter the following into the textbox:
 
<pre>
 
<pre>
/usr/local/bin/sylpheed-compose.pl --to="%t" --cc="%c" --bcc="%b" --subject="%s" --body="%B" --attach="%A"
+
/usr/local/bin/claws-mail-compose.pl --to="%t" --cc="%c" --bcc="%b" --subject="%s" --body="%B" --attach="%A"
 
</pre>
 
</pre>
  
If your binary has a name other than "sylpheed-claws", you must append another parameter:
+
If your binary has a name other than "claws-mail", you must append another parameter:
 
<pre>
 
<pre>
--sylpheed="/usr/bin/sylpheed"
+
--claws-mail="/usr/bin/claws-mail"
 
</pre>
 
</pre>
where /usr/bin/sylpheed is the full path to sylpheed on your system.
+
where /usr/bin/claws-mail is the full path to claws-mail on your system.
  
In case you don't want that perlscript or you can't use it - there is this alternative. But be aware that passing multiple lines or non-standard characters to Sylpheed-Claws from an application (e.g. konqueror trying to send form-data via email) will '''not''' work!
+
In case you don't want that perlscript or you can't use it - there is this alternative. But be aware that passing multiple lines or non-standard characters to Claws Mail from an application (e.g. konqueror trying to send form-data via email) will '''not''' work!
 
<pre>
 
<pre>
sylpheed-claws --compose <nowiki>"~mailto:%t?cc=%c&bcc=%b&subject=%s&body=%B" --attach "%A"</nowiki>
+
clawws-mail --compose <nowiki>"~mailto:%t?cc=%c&bcc=%b&subject=%s&body=%B" --attach "%A"</nowiki>
 
</pre>
 
</pre>
Replace "sylpheed-claws" with the actual name of your binary here as well.
+
Replace "clawws-mail" with the actual name of your binary here as well.
 
</div>
 
</div>
  
=== Why does Sylpheed-Claws tell me that a gpg signature has expired? ===
+
=== Why does Claws Mail tell me that a gpg signature has expired? ===
  
 
; The sender used a key with a time limit, you have to update your keyring regularly to receive the updated signatures, e.g. like this : <code>gpg --refresh-keys</code>
 
; The sender used a key with a time limit, you have to update your keyring regularly to receive the updated signatures, e.g. like this : <code>gpg --refresh-keys</code>
Line 250: Line 250:
  
  
=== Why does Sylpheed-Claws tell me that there is one unread message in some folders? ===
+
=== Why does Claws Mail tell me that there is one unread message in some folders? ===
  
 
; When the number behind some folder tells you that you have one unread message but all are marked as read you have to do the following : Right click on toplevel MH folder and use "Check for new messages", or use '/View/Update Summary'
 
; When the number behind some folder tells you that you have one unread message but all are marked as read you have to do the following : Right click on toplevel MH folder and use "Check for new messages", or use '/View/Update Summary'
  
=== How can I use my free Hotmail, Yahoo, or AOL email account via Sylpheed-Claws? ===
+
=== How can I use my free Hotmail, Yahoo, or AOL email account via Claws Mail? ===
  
[http://www.freepops.org/en/ FreePOPs] should allow you to create kind of a "bridge" between these proprietary email services and Sylpheed-Claws. Simply install FreePOPs, which is probably packaged in your distribution and configure it. After that, you can add an POP3 account to Sylpheed-Claws, which receiving server will be <code>localhost</code> and set the port to use to <code>2000</code> in the Advanced tab. The username to use consists of a complete email address, like <code> johndoe@hotmail.com</code>, so that FreePOP can know which type of account it is. For more information, see [http://www.freepops.org/en/files/html-manual/ FreePOPs' user manual].
+
[http://www.freepops.org/en/ FreePOPs] should allow you to create kind of a "bridge" between these proprietary email services and Claws Mail. Simply install FreePOPs, which is probably packaged in your distribution and configure it. After that, you can add an POP3 account to Claws Mail, which receiving server will be <code>localhost</code> and set the port to use to <code>2000</code> in the Advanced tab. The username to use consists of a complete email address, like <code> johndoe@hotmail.com</code>, so that FreePOP can know which type of account it is. For more information, see [http://www.freepops.org/en/files/html-manual/ FreePOPs' user manual].

Revision as of 08:13, 1 December 2006

Contents

What do I need to compile Claws Mail?

Required:

Any POSIX compliant UNIX or similar OS eg. Linux, FreeBSD, Solaris
GTK+ 2.4.x or later
A recent ANSI C compiler (gcc 2.7.2.3 should also work)

Otherwise ./configure will fail.

Optional requirements:

compface 
for X-Face support
GnuPG 1.2.1 or later and GPGME 0.4.5 or later 
for GnuPG support
OpenSSL 
for SSL support
libEtPan! 0.42 or later 
for IMAP4 support
OpenLDAP 2.0.7 or later 
for LDAP support
Aspell 0.50 or later (and dictionaries) 
for spell-checker support
libgnomeprint-2.2 and libgnomeprintui-2.2 
for extended printer support
J-Pilot 
for J-Pilot support
SpamAssassin 
for SpamAssassin plugin support
Clam AntiVirus 
for Clam AntiVirus plugin support
Dillo 
for Dillo HTML viewer plugin support
GtkMathView 
for MathML viewer plugin support

How do I set up Claws Mail?

When you run Claws Mail for the first time, the Installation Wizard will appear and prompt you for the minimum required information necessary to start using Claws Mail in less than 5 minutes.

Why did the creation of the mailbox fail?

Claws Mail reports such an error if it can't create the default mailboxes (inbox, outbox, etc ...). This can be because <homedir>/Mail already contains files with the same names. This occurs when switching from Kmail to Claws Mail, in this case backup and remove the existing Mail directory or use another name for the Claws Mail mail directory.

How do I create a new account?

You can add an account by using the menu item '/Configuration/Create new account'

Why does Claws Mail not delete my mails when I press "delete"? I set a filter, and Claws Mail does not filter. I moved a mail to a different mailbox and it did not move.

You have the configuration option /Configuration/Preferences/Common Interface tab 'Execute immediately when moving or deleting messages' disabled.

Can I set up special addresses/ports for my mailserver / newsserver?

Yes, you can. In the Account preferences, on the 'Advanced' tab you can specify the port addresses that you want to use.

Does Claws Mail have options for threading messages?

Yes. You can switch it on and off in the View Menu, just select "Thread View" or press Ctrl+T. (This only affects the currently selected folder; i.e. it is a folder property.)

Can I create multiple levels of subfolders to store mail?

Absolutely. This is no problem.

How do I apply a patch after downloading it?

Copy patch to Claws Mail directory Apply the patch:

 % patch -p0 < some.patch

Or, if it's gzipped:

 % gzip -dc some.patch.gz | patch -p0

Run =./autogen.sh=, remove the generated =/config.cache= file (unless you want to install in prefix /usr/local). Run =./configure= with the appropriate options and then make. (Text as found on the Sylpheed patch page.)

How do I compile in support for compface pictures?

You have to have a package called libcompface installed, so this is available for compiling into Claws Mail. You can find out more and download it at http://freshmeat.net/projects/compface/ . Also, Tim Jackson has a spec file, which you can use to build an RPM of compface, at http://www.timj.co.uk/linux/rpms.php .

How do I make my own compface image?

You can use the gif2xface.pl script, which converts a 48x48 gif to the format suitable for compface. This script can be found in the 'tools' directory, along with a README. It is also available from this site: http://www.claws-mail.org/tools.php. You can also let Claws Mail create it by itself from a .xbm file.

How can I make Claws Mail send my compface image in the mails?

In the Configuration menu, Preferences for current account, Send tab, check Add user-defined header and press Edit button. A dialog appears, add a header named "X-Face" and fill the value field with your face data. Alternatively, you can select a .xbm file in this dialog. Note that if you paste the data from a terminal into the field some spurious newlines can be added, and these can mangle your face, be careful.

How can I tell my browser/newsclient/other program to use Claws Mail as e-mail program?

In the settings part of the program, use sylpheed-claws --compose "%t?subject=%s&body=%d"

Specific options for typical browsers 
Opera
claws-mail --compose mailto:%t?subject=%s
Galeon
claws-mail --compose "mailto:%t?subject=%s&body=%d"
Konqueror 
See How do I make Claws Mail the default mail application for KDE?

How do I enable GPG support in Claws Mail?

GunPG support requires GnuPG >= 0.4.x and GPGME >= 1.x.x.

You need to load the PGP/Core, PGP/MIME, and PGP/inline plugins. '/Configuration/Plugins/Load plugin'.

Mutt does not recognize Claws Mail's MH structure

For this to work you need to use the touch command in every MH folder. touch the file .xmhcache and Mutt should do just fine.

How can I make Claws Mail notify me when new mail arrives?

Go to '/Configuration/Preferences/Common', on the 'Receive' tab use the settings for 'Run command when new mail arrives'. You can also use the Trayicon (which is shipped with Claws Mail) or Acpi-notifier or Notification plugins, which are available on the Plugins page.

Can I use a spell checker with Claws Mail?

Install Aspell >= 0.50 and use the ./configure option --enable-aspell

I checked out the sources using cvs and cant find any configure script. What can I do?

The cvs versions are meant to be used by developers rather than normal users, so the source (or binary) distributions are easier to use.

- Yeah, but the latest features from cvs really look sexy...

You need to generate the configure script by running ./autogen.sh. Be sure to have autoconf and automake packages installed for this.

Running "autogen.sh" gives errormessages that AM_PATH_GDK_PIXBUF or AM_PATH_(whatever) is not found. What can I do?

There are some *.m4 files in the ac/missing directory. Try to copy them into the ac directory and run autogen.sh again.

If there are still some .m4 files not found (e.g. those from Gtk), try to run

% locate m4 | less

or

% locate aclocal | less

to find additional directories containing those macros. If you find e.g. a "gtk.m4" in "/opt/gnome/share/aclocal", change following line in "autogen.sh" from

aclocal -I ac \

to

aclocal -I ac -I /opt/gnome/share/aclocal \

and run it again.

I dont want to compile in support for ... any longer, but after running configure, those libraries are still used. What can I do?

Remove the config.cache file and run configure again. You should also use make clean to avoid undefined references.

How can I select different applications to open with specific MIME types?

The MIME-type->application associations are kept in ~/.mailcap and /etc/mailcap.

How can I change the suggested mimetype for attachments I am sending?

The extension->MIME-type associations are kept in /etc/mime.types.
Right-click an attachment in the compose window's "Attachments" tab, and select Properties to change the MIME-type.

Why is the folder list not updated after I manually moved/copied folders?

You need to update Claws Mail's cache. Right click on the mailbox and choose "Check for new folders".

How can I revert original settings, e.g. for fonts, keybindings, etc.?

Claws Mail keeps its configuration files in $HOME/.claws-mail/clawsrc and creates default entries, if none are found. So the easiest way is to quit claws-mail, temporarily renaming your $HOME/.claws-mail e.g. to *.bak and restarting claws-mail in order to get default entries.

What environment variables have effect on Claws Mail?

Here are the most common variables 
HOME 
location of .claws-mail (config directory) and default folder for Mailboxes.
LANG
LC_ALL
LC_CTYPE
LC_MESSAGES 
locale settings, e.g. language and date format.

Why are special characters (e.g. umlauts) not displayed correctly?

In most cases, this is caused by emails with broken encodings. You can try to force it using the View/Character Encoding submenu.

How can I convert my old mailbox / adressbook from (some mailclient).

In the source distribution, you can find some scripts in the tools subdirectory, maybe your application is supported. You can also try to export your old mailbox to MH or mbox format. If the mailbox is in mbox format, it can be imported: File -> Import mbox file...

For the addressbook, direct import is supported for Mutt and Pine, but also LDIF, which is a standard format which most email clients can export to.

Tip: Take a look at the "harvest addresses" function from the Tools menu, it could be a useful alternative or addition, when importing your old contacts.

What config files are there, and what are they used for?

Claws Mail's config files can be found in $HOME/.claws-mail. They are in plain text format and quite easy to understand, so dont fear to take a look into them using a texteditor.

clawsrc 
main configuration: nearly all options from the settings window, e.g. mailbox location, font entries, etc.
accountrc 
settings for pop/imap/nntp accounts
actionsrc 
user defined actions
customheaderrc 
contains user defined header lines
dispheaderrc 
headers to display above the mail body
filterrc 
traditional filter settings
folderitemrc 
folder specific settings, e.g. default outbox
matcherrc 
new filtering and scoring settings
menurc 
Key bindings
addrbook-*.xml 
contents of your addressbook
folderlist.xml 
additional folder specific settings, e.g. hiding read messages, sort order, etc.

What's a good method for printing an e-mail?

Most precompiled packages will use the libgnomeprintui library, which will allow you to print your emails simply with the same interface as Gnome apps. It will be compiled in if you have libgnomeprint-dev and libgnomeprintui-dev packages installed.

If Claws Mail hasn't been compiled with libgnomeprintui support, you can use enscript. Use enscript %s to print everything on one page, or enscript -U2 %s for printing two logical pages on one physical page.

As a more pretty alternative: Use muttprint. The print-command would then look something like this: muttprint -f %s

Using KDE or gv you also get a "print preview" for free!

Try muttprint -f %s -p - |kghostview - or muttprint -f %s -p - |gv - respectively... BTW: muttprint, like enscript, may optionally print two logical pages on one physical page. Just have a look at the docs!

Mail is not sent because the queue folder cannot be found?

(From the old bug tracker): Claws Mail requires a queue folder. This was changed to prevent message losses, if Claws Mail is killed while sending. Create a local folder (/File/Add Mailbox.../MH) for the queue and sending should work. I would not suggest to use the imap server for this purpose because sylpheeds queue messages have a special header that can not be handled correctly by the imap server, when the data for the summaryview is queried.

If you really want to create a queueing folder in an IMAP server, you just have to create an ordinary folder in it, and then edit folderlist.xml file in Claws Mail's configuration directory. In this file, you will find a "folderitem" tag, with its "name" attribute set to the IMAP folder name you just created for queueing. You should edit this tag, and set its "type" attribute set to "queue". Note that this "folderitem" you're looking that will be a child of an "folder" tag that has its "type" attribute set to "imap".

What is the purpose of this bizarre "Enable Alternate Dictionary" option?

It is useful only if you routinely compose messages that use two or more languages. If this option is enabled, then when you switch to another language, the last one you used is not swapped out from memory, thus, when you switch again to it, there is no delay. Moreover, whenever you use two dictionaries, if you check a word and if the spell checker considers it misspelled in the current language, you can switch to the alternate language and recheck the word in one operation by selecting the "Check with ALTERNATE_LANGUAGE" item (keyboard short-cut: <x>) in the suggestions menu. This is very handy when the message contains paragraphs in two languages.

(Tips & Tricks) Why doesn't the spell checker have a more traditional user interface, like KMail, Evolution etc?

Because the developer (Melvin Hadasht) noted that by using the keyboard shortcuts the spell checking can be done faster while typing (more on that below). Moreover, there is the option <Spelling/Check All or Check selection> allows to do a spell checking of the whole text or just a selection. Just keep an eye where the suggestions menu shows up to look at the misspelled word, then hit one of the letters corresponding to the suggestion (<a> through <p>, press also <ALT> to make the selected suggestion listed as the first suggestion the next time you do exactly the same mistake --- this is the "learn by mistake" feature), or hit <r> to type a replacement, or hit <ALT-SPACE> to accept the word in the current message, or hit <ALT-RETURN> to accept the word and to add it definitively to your personal dictionary associated to this language. If you have enabled the "Alternate Dictionary", you can switch to it by hitting <x>.

If you prefer checking while you type, just bind the <Spelling/Check backwards misspelled word> and <Spelling/Forward to next misspelled word> to two quick keyboard short cuts. Then, as soon as you mistype a word, call the <Check backwards...> short-cut ---you do not need to move the cursor--- and without using the mouse select the suggestion. As GNU/Aspell does a good job at suggesting a replacement, you will often end to type <a>, and as the cursor did not move, just continue typing. In contrast, the other option, <Forward to next...> does move the cursor. This is because if you have text after the cursor, that also means in general that you are only editing a message, and not writing it, so advancing the cursor to the misspelled word is in general the wanted behaviour.

How do I make Claws Mail the default mail application for KDE?

KDE does not support passing the full URL to a mailer (see bug 658 and the corresponding KDE bug entry). But there is a workaround - do the following as root:

wget http://www.claws-mail.org/tools/claws-mail-compose.pl
mv claws-mail-compose.pl /usr/local/bin
chmod +x /usr/local/bin/claws-mail-compose.pl

Then go to the KDE Control Center -> KDE Components -> Component Chooser -> Email Client, choose "Use a different email client" and enter the following into the textbox:

/usr/local/bin/claws-mail-compose.pl --to="%t" --cc="%c" --bcc="%b" --subject="%s" --body="%B" --attach="%A"

If your binary has a name other than "claws-mail", you must append another parameter:

--claws-mail="/usr/bin/claws-mail"

where /usr/bin/claws-mail is the full path to claws-mail on your system.

In case you don't want that perlscript or you can't use it - there is this alternative. But be aware that passing multiple lines or non-standard characters to Claws Mail from an application (e.g. konqueror trying to send form-data via email) will not work!

clawws-mail --compose "~mailto:%t?cc=%c&bcc=%b&subject=%s&body=%B" --attach "%A"

Replace "clawws-mail" with the actual name of your binary here as well.

Why does Claws Mail tell me that a gpg signature has expired?

The sender used a key with a time limit, you have to update your keyring regularly to receive the updated signatures, e.g. like this 
gpg --refresh-keys

Note: Most keyservers have problems syncing OpenPGP type keys (see http://keyserver.kjsl.com/~jharris/keyserver.html). It is recommended to switch to SKS keyservers, e.g. subkeys.pgp.net or sks.keyserver.penguin.de .


Why does Claws Mail tell me that there is one unread message in some folders?

When the number behind some folder tells you that you have one unread message but all are marked as read you have to do the following 
Right click on toplevel MH folder and use "Check for new messages", or use '/View/Update Summary'

How can I use my free Hotmail, Yahoo, or AOL email account via Claws Mail?

FreePOPs should allow you to create kind of a "bridge" between these proprietary email services and Claws Mail. Simply install FreePOPs, which is probably packaged in your distribution and configure it. After that, you can add an POP3 account to Claws Mail, which receiving server will be localhost and set the port to use to 2000 in the Advanced tab. The username to use consists of a complete email address, like johndoe@hotmail.com, so that FreePOP can know which type of account it is. For more information, see FreePOPs' user manual.