README

   1 Claws Mail - a GTK+ based, lightweight, and fast e-mail client
   2
   3 ---------------------------------------------------------------------
   4
   5    Copyright (C) 1999-2015 Hiroyuki Yamamoto <hiro-y@kcn.ne.jp> and the
   6    Claws Mail Team
   7
   8    This program is free software: you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation, either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20
  21    For more details see the file COPYING.
  22
  23 ---------------------------------------------------------------------
  24
  25 Summary:
  26
  27  1. What is Claws Mail?
  28  2. Plugins
  29  3. Actions
  30  4. Icon Themes
  31  5. Quick Search
  32  6. Custom toolbar
  33  7. Partial downloading of POP3 mails
  34  8. Hidden Options
  35  9. Tools
  36 10. How to contribute
  37 11. How to request features
  38 12. Installing Claws from Git
  39 13. Release History
  40 14. Useful Links
  41
  42
  43 1. What is Claws Mail?
  44 --------------------------
  45
  46 Claws Mail (previously known as Sylpheed-Claws) is a lightweight and
  47 highly configurable email client and news reader based on the GTK+
  48 GUI toolkit, it runs on the X Window System.
  49
  50 Claws Mail is free software distributed under the GNU GPL.
  51
  52 To run Claws Mail use 'claws-mail' on the command line.
  53
  54 When claws-mail is executed for the first time a configuration
  55 'Wizard' will appear prompting you for the minimum information
  56 necessary to create a new account.
  57
  58
  59 2. Plugins
  60 ----------
  61
  62 Claws Mail' capabilities are extended by plugins. It comes with
  63 the following plugins included, all of which are built automatically
  64 if the required libraries are present.
  65
  66 Plugins are installed in $PREFIX/lib/claws-mail/plugins/
  67 and have a suffix of '.so'
  68 To load a plugin go to '/Configuration/Plugins' and click
  69 the 'Load Plugin' button.
  70 Select the plugin that you want and click 'OK'
  71
  72 All plugin preferences can be found under
  73 '/Configuration/Preferences/Plugins/'.
  74
  75   o ACPI Notifier
  76     Notifies of new mail via the mail LED available on some laptops. The
  77     LED can be set to blinking or on states when new mail is received.
  78     Appropriate kernel modules have to be loaded first for this plugin to
  79     work. Laptops supported are from ACER (acerhk and acer_acpi modules),
  80     ASUS (asus_laptop and asus_acpi), IBM (ibm_acpi), Lenovo (tm_smapi)
  81     and Fujitsu (apanel) manufacturers.
  82
  83   o Address Keeper
  84     Saves mail addresses typed in the 'To', 'Cc' or 'Bcc' fields of
  85     outgoing messages to a designated folder in the address book.
  86     Addresses are saved only if not already present in the address book.
  87
  88   o Archiver
  89     Archives mail folders using libarchive library. Folders can be archived
  90     with or without compression (ZIP, GZIP or BZIP2) and also in several
  91     formats (TAR, SHAR, PAX or CPIO).
  92     Libarchive is available from http://www.libarchive.org/.
  93
  94   o Attachment Remover
  95     Selectively removes attachments from messages. Messages are permanently
  96     modified by using this feature, so be careful!
  97
  98   o Attachment Warning
  99     Warns the user of possibly forgotten attachments when some keywords
 100     are found in the outgoing messages. False positives (being warned when
 101     no attachment is realy needed) exist, but some configuration options
 102     can help to reduce their probability.
 103
 104   o Bogofilter
 105     Enables the scanning of incoming mail received from a POP,
 106     IMAP, or LOCAL account using Bogofilter. It can optionally
 107     delete mail identified as spam or save it to a designated folder.
 108     Bogofilter is a pure Bayesian filter, therefore it has better
 109     speed performance than SpamAssassin but might catch less spam.
 110     Bogofilter is available from http://bogofilter.sourceforge.net/.
 111
 112   o BSFilter
 113     Checks all messages received from IMAP, POP or local accounts using
 114     BSFilter, a bayesian spam filter program, which has to be installed
 115     locally. Messages identified as spam can be deleted or saved to a
 116     designated folder.
 117     Bsfilter is available from http://sourceforge.jp/projects/bsfilter/.
 118
 119   o Clamd
 120     Uses the Clam AntiVirus in daemon mode to scan received messages from
 121     IMAP, POP or local accounts. Scanning is done through a socket to the
 122     daemon, so it has to be previously configured to allow this.
 123     Clam AntiVirus is available from http://www.clamav.net/.
 124
 125   o Fetchinfo
 126     Modifies downloaded messages and inserts special headers containing
 127     some download information: UIDL, Claws Mail account name, POP server,
 128     user ID and retrieval time. These headers can be used later for more
 129     elaborate filtering or processing rules.
 130
 131   o Fancy
 132     Renders HTML mails and HTML parts of multipart messages using the GTK+
 133     port of the WebKit library. External content is blocked by default
 134     (including images) to avoid remote tracking, but can be enabled either
 135     globally or just on the displayed message.
 136     GTK+ WebKit is available from http://trac.webkit.org/wiki/WebKitGTK/.
 137
 138   o GData
 139     Includes your Gmail account contacts in the list generated for
 140     Tab-address completion on compose window, using the GData library.
 141     Gdata library is available from https://live.gnome.org/libgdata/.
 142
 143   o MailMbox
 144     Handles mailboxes in Mbox format using the libEtPan! library. Mbox
 145     files can be added to the folder tree and used like regular mailboxes.
 146     LibEtPan! is available from http://www.etpan.org/.
 147
 148   o Managesieve
 149     Manage sieve filters on a server using the ManageSieve protocol.
 150
 151   o Newmail
 152     Writes a header summary to a log file for each mail received after
 153     sorting. The file for the summary is ~/Mail/NewLog.
 154
 155   o Notification
 156     Provides various ways of notifying the user of new and unread email.
 157     Current methods include: a banner, a popup window, a user command,
 158     a message to a LCD daemon, a system tray icon and an indicator icon.
 159     Sound notifications are also possible through libcanberra. Each method
 160     can be customized in detail through the plugin preferences.
 161     Indicator library is available from https://launchpad.net/libindicator/
 162     and libcanberra from http://0pointer.de/lennart/projects/libcanberra/.
 163
 164   o Perl
 165     Extends the filtering possibilities of Claws Mail. Provides a Perl 5
 166     interface to Claws Mail's filtering mechanism, allowing the use of full
 167     Perl power in email filters. A conversion script is provided to
 168     translate user rules into perl rules suitable for this plugin.
 169     Perl is available from http://www.perl.org/.
 170
 171   o PDF Viewer
 172     Displays Portable Document Format (PDF) and PostScript attachments
 173     within the message view using Poppler. PostScript attachments are
 174     converted to PDF on the fly by the 'gs' tool, which has to be installed
 175     first. The 'gs' tool is available from http://pages.cs.wisc.edu/~ghost/.
 176     The Poppler library is available from http://poppler.freedesktop.org/.
 177
 178   o PGP/Core
 179     Handles core PGP functions and is required by the PGP/Inline
 180     and PGP/MIME plugins.
 181     Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
 182
 183   o PGP/inline
 184     Handles inline PGP signed and/or encrypted mails. You can
 185     decrypt mails, verify signatures or sign and encrypt your
 186     own mails. Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
 187
 188   o PGP/MIME
 189     Handles PGP/MIME signed and/or encrypted mails. You can
 190     decrypt mails, verify signatures or sign and encrypt your
 191     own mails. Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
 192
 193   o Python
 194     Provides Python scripting access to Claws Mail functions. A testing
 195     console is also featured. Scripts can be saved to specific folders
 196     for automatic loading on startup or being available as new menu items
 197     under the '/Tools/Python scripts' menu.
 198     Python is available from http://python.org/.
 199
 200   o RSSyl
 201     Creates mailboxes where newsfeeds in RSS 1.0, RSS 2.0 or Atom format
 202     can be added. Each newsfeed will create a folder with the appropriate
 203     entries, fetched from the web. You can read them, and delete or keep
 204     old entries.
 205
 206   o S/MIME
 207     Handles S/MIME signed and/or encrypted mails. You can decrypt mails,
 208     verify signatures or sign and encrypt your own mails.
 209
 210   o SpamAssassin
 211     Scans incoming mail received from a POP, IMAP or LOCAL account using
 212     SpamAssassin. It can optionally delete mail identified as spam or save
 213     it to a designated folder.
 214     SpamAssassin is available from http://spamassassin.apache.org/.
 215
 216   o Spam Report
 217     Reports spam messages to online spam harvesting sites. Sites suported
 218     are http://www.signal-spam.fr/ and http://www.spamcop.net/. The Debian
 219     mailing list spam nomination system is also supported.
 220
 221   o TNEF Parser
 222     Decodes attachments with 'application/ms-tnef' MIME type (also known
 223     as "winmail.dat" files) in Claws Mail, using the ytnef library.
 224     Decoded parts can be saved to files.
 225     The ytnef library is available from http://ytnef.sourceforge.net/.
 226
 227   o VCalendar
 228     Displays vCalendar messages. Only the meeting subset of the vCalendar
 229     format is currently supported, which includes planning, sendding and
 230     receiving invitations and answering them. Public calendar (WebCal)
 231     subscriptions, free/busy information export/import and reminding of
 232     events is also supported.
 233
 234
 235 Additonal plugins can be found here:
 236 http://www.claws-mail.org/plugins.php
 237
 238
 239 3. Actions
 240 ----------
 241   The "actions" feature is a convenient way for the user to launch external
 242   commands to process a complete message file including headers and body or
 243   just one of its parts. It allows also the use of an external command to
 244   filter the whole text or just a selected part in the message window or in
 245   the compose window. This is a generic tool that allows to do any uncommon
 246   actions on the messages, and thus extends the possibilities of Claws Mail.
 247   For example, Claws Mail does not include the rot13 cyphering algorithm
 248   popular in some newsgroups. It does not support uuencoded messages. As
 249   all these features can be handled by external programs, the actions
 250   provide a convenient way to use them from the menu bar.
 251
 252   a. Usage
 253   --------
 254
 255   To create a new action, go to Configuration -> Actions.... The "Action
 256   Creation" dialog offers to enter the Menu name that will trigger the
 257   command. The created menu will be found in the Tools -> Actions submenu.
 258   By inserting a slash / in the menu name, you create a submenu.
 259
 260   The command is entered in the Command line entry. Note that Claws Mail
 261   stores every single email in a separate file. This allows to use the
 262   following syntax for the command:
 263
 264     * %f denotes the file name of the selected message. If you selected more
 265          than one, then the command will be launched for each message with
 266          the appropriate file name
 267     * %F denotes the list of the file names of the selected message. If only
 268          one message is selected, this amounts to %f, but if more messages
 269          are selected, then the command will be launched only once with the
 270          list of the file names. (You can use both %f and %F in one command:
 271          then the command will be launched for each selected message with
 272          the name of this message and with the list of all selected
 273          messages. I did not find a practical example for this.)
 274     * %p denotes the current selected message part of a multipart message.
 275          The part is decoded accordingly. If the message is not a multipart
 276          message, it denotes the message body.
 277     * Prepending >: this will allow you to send to the command's standard
 278          input a text that you will enter in a dialog window.
 279     * Prepending *: this will allow you to send to the command's standard
 280          input a text that you will enter in a dialog window. But in
 281          contrast to prepending >, the entered text is hidden (useful when
 282          entering passwords).
 283     * Appending an ampersand &: this will run the command asynchronously.
 284          That means "fire and forget". Claws Mail won't wait for the
 285          command to finish, nor will it catch its output or its error
 286          messages.
 287     * Prepending the vertical bar | (pipe-in): this will send the current
 288          displayed text or the current selected text from the message view
 289          or the compose window to the command standard input. The command
 290          will silently fail if more than one message is selected.
 291     * Appending the vertical bar | (pipe-out): this will replace the current
 292          displayed text or the current selected text from the message window
 293          or the compose window by the command standard output. The command
 294          will silently fail if more than one message is selected.
 295
 296   Note: It is not possible to use actions containing %f, %F or %p from the
 297   compose window.
 298
 299   When a command is run, and unless it is run asynchronously, Claws Mail
 300   will be insensitive to any interaction and it will wait for the command to
 301   finish. If the command takes too long (5 seconds), it will popup a dialog
 302   window allowing to stop it. This dialog will also be displayed as soon as
 303   the command has some output: error messages or even its standard output
 304   when the command is not a "pipe-out" command. When multiple commands are
 305   being run, they are run in parallel and each command output is separated
 306   from the outputs of the others.
 307
 308   a. Examples
 309   -----------
 310
 311   Here are some examples that are listed in the same syntax as used for
 312   storing the actions list. You can copy and past the definition in your
 313   ~/.claws-mail/actionsrc file (exit Claws Mail before). The syntax
 314   is very simple: one line per action, each action contains the menu name
 315   and the command line separated by a colon and a space ": "
 316
 317   Purpose:      rot13 cyphering
 318   Definition:   Rot13: |tr a-zA-Z n-za-mN-ZA-M|
 319   Details:      This will apply the rot13 cyphering algorithm to the
 320                 (selected) text in the message/compose view.
 321
 322   Purpose:      Decoding uuencoded messages
 323   Definition:   UUdeview: xdeview %F&
 324   Details:      xdeview comes with uudeview. If an encoded file is split in
 325                 multiple messages, just select them all and run the command.
 326
 327   Purpose:      Display uuencoded image
 328   Definition:   Display uuencoded: uudec %f&
 329   Details:      Displays uuencoded files. The uudec[1] script can be found in
 330                 the 'tools' directory of the distribution package.
 331
 332   Purpose:      Alter messages
 333   Definition:   Edit message: gvim -f %F
 334   Details:      Allows editing of any received message. Can be used to remove
 335                 unneeded message parts, etc.
 336
 337   Purpose:      Pretty format
 338   Definition:   Par: |par 72Tbgjqw74bEe B=._A_a 72bg|
 339   Details:      par is a utility that can pretty format any text. It does a
 340                 very good job in indenting quoted messages, and justifying
 341                 text. Used when composing a message
 342
 343   Purpose:      Browse
 344   Definition:   Part/Dillo: dillo %p&
 345   Details:      Browse the selected message part in Dillo.
 346
 347
 348   [1] The uudec script can be found in the 'tools' directory of the
 349   distribution package. It needs uudecode and ImageMagick's display. The
 350   latter can be replaced by any image viewer that can get input from
 351   standard input. The script could also be modified to use temporary files
 352   instead of standard input.
 353
 354
 355 4. Icon Themes
 356 --------------
 357   Claws has support for different icon sets. Several icon sets can be
 358   downloaded from http://www.claws-mail.org/themes.php
 359   You will need to create a directory called 'themes' in your config
 360   directory, unpack them into this directory, and then use the interface
 361   to select them, /Configuration/Preferences/Display/Themes
 362
 363   This interface can also be used to install new themes.
 364
 365
 366 5. Quick Search with extended search
 367 ------------------------------------
 368     Quick Search, with its powerful Extended search function,
 369     enables searching through folder's messages.
 370
 371     Extended Search allows one to define criteria that messages must
 372     have in order to match and be displayed in the summary view pane.
 373     Search types titled From, Subject and To are self explanatory.
 374     Search type extended allows one to use Claws Mail's powerful
 375     filtering engine to select messages. Examples:
 376     from regexpcase "foo"
 377     subject regexp "Bug" & to regexp "claws-mail"
 378
 379     Additionally, it is possible to use simpler yet equally
 380     powerfull patterns for message selections. Mutt users will
 381     immediately recognise most of the available patterns:
 382
 383     Pattern  Parameter  Selects
 384     ----------------------------------------------------
 385     a                   all messages
 386     ag       #          messages whose age is greater than #
 387     al       #          messages whose age is lower than #
 388     b        S          messages which contain S in the message body
 389     B        S          messages which contain S in the whole message
 390     c        S          messages carbon-copied to S
 391     C        S          message is either to: or cc: to S
 392     D                   deleted messages
 393     e        S          messages which contain S in the Sender field
 394     E        S          true if execute "S" succeeds
 395     f        S          messages originating from user S
 396     F                   forwarded messages
 397     h        S          messages which contain S in any header name or value
 398     H        S          messages which contain S in the value of any header
 399     i        S          messages which contain S in Message-Id header
 400     I        S          messages which contain S in inreplyto header
 401     k        #          messages which are marked with color #
 402     L                   locked messages
 403     n        S          messages which are in newsgroup S
 404     N                   new messages
 405     O                   old messages
 406     r                   messages which have been replied to
 407     R                   read messages
 408     s        S          messages which contain S in subject
 409     se       #          messages whose score is equal to #
 410     sg       #          messages whose score is greater than #
 411     sl       #          messages whose score is lower than #
 412     Se       #          messages whose size is equal to #
 413     Sg       #          messages whose size is greater than #
 414     Ss       #          messages whose size is smaller than #
 415     t        S          messages which have been sent to S
 416     tg       S          messages with tags containing S
 417     tagged              messages which are tagged
 418     T                   marked messages
 419     U                   unread messages
 420     x        S          messages which contain S in References header
 421     x        "cmd args" messages returning 0 when passed to command
 422                         - %F is message file
 423     y        S          messages which contain S in X-Label header
 424
 425     &        logical AND operator
 426     |        logical OR operator
 427     ! or ~   logical NOT operator
 428     %        case sensitive search
 429
 430     all filtering expressions are allowed
 431
 432     # means number
 433     S means regexp string
 434
 435     It is possible to use logical operators AND (&), OR (|) and
 436     NOT (! or ~). Case sensitive search is achieved with %.
 437     Examples:
 438     T                  marked messages
 439     U                  unread messages
 440     f "john beavis"    messages from john beavis
 441     %f "John Beavis"   messages from John Beavis (case sensitive)
 442     ~s foo             messages which do not have foo in the subject
 443     f foo & ~s bar     messages from foo that do not have bar in thesubject
 444
 445
 446 6. Custom toolbar
 447 -----------------
 448
 449    /Configuration/Preferences/Customize Toolbars lets you define the
 450    toolbar you want. The configuration dialog enables you to set an icon,
 451    an appropriate text, and map an action to it. Actions to choose
 452    from are predefined. You can also have your "Claws Mail Actions"
 453    (refer to "Actions" above) on your toolbar.
 454
 455    Example:
 456         * Configuration->Actions
 457                 - add an entry "Dillo: dillo %p&"
 458         * Configuration->Custom toolbar
 459                 - select Claws Mail Actions Feature
 460                 - select "Dillo: dillo %p&" from drop down list
 461                 - choose an icon and click ok
 462
 463
 464
 465 7. Partial downloading of POP3 mails
 466 ------------------------------------
 467   Messages over the configured size limit, (/[Account preferences]/
 468   Receive/Message size limit), will be partially retrieved. These
 469   messages will have a Notice View displayed (above the Message View),
 470   informing of the partially retrieved state and the total size of the
 471   message. The Notice View will also contain two buttons, 'Mark for
 472   download' and 'Mark for deletion'. If the user clicks 'Mark for
 473   download', the message will be downloaded in full at the next message
 474   retrieval, (and the partial one deleted); if the user checks 'Mark for
 475   deletion' it will be removed from the server after the normal delay
 476   as specified in the POP3 account's 'Receive' preferences.
 477   If a user moves a partially retrieved message to the Trash folder
 478   it will be deleted on the server at the next retrieval after the
 479   Trash folder has been emptied.
 480
 481
 482 8. Hidden options
 483 -----------------
 484
 485     It is recommended that you use Clawsker to edit these options,
 486     http://www.claws-mail.org/clawsker.php
 487
 488     addressbook_use_editaddress_dialog  (default: 1)
 489         Use a separate dialogue to edit a person's details. '0'
 490         will use a form embedded in the addressbook's main window.
 491         0: off  1: on
 492
 493     bold_unread                 (default: 1)
 494         show unread messages using bold font in summary view
 495         0: off  1: on
 496
 497     cache_max_mem_usage         (default: 4096)
 498         the maximum kB of memory Claws Mail should use. It will try
 499         to keep the memory usage below this value, but it will always
 500         use the assigned amount of memory for speed gain.
 501
 502     cache_min_keep_time         (default: 15)
 503         the minimum time in minutes Claws Mail will keep the folder
 504         cache in memory. If a cache is more recent than this time it
 505         will not be freed even if the memory usage is above the
 506         maximum. You should probably set this value higher than your
 507         mail check interval. Otherwise the cache will always be freed
 508         between checks even if the folder is accessed on every check,
 509         which will cause much disk IO.
 510
 511     compose_no_markup           (default: 0)
 512         prevent italic and bold text in the Compose dialog account
 513         selector
 514         0: normal (markup) 1: no markup
 515
 516     diff_added_color            (default: #008b8b)
 517     diff_deleted_color          (default: #6a5acd)
 518     diff_hunk_color             (default: #a52a2a)
 519         Colors to use when displaying attachments in unified diff
 520         format.
 521
 522     emphasis_color              (default: #0000CF)
 523         The colour used for the X-Mailer line when its value is
 524         Claws Mail.
 525
 526     enable_hscrollbar           (default: 1)
 527         enable horizontal scroll bar in summary view
 528         0: off  1: on
 529
 530     enable_swap_from            (default: 0)
 531         display sender's email address in To column in Sent folder
 532         instead of recipient's
 533         0: off  1: on
 534
 535     folderview_vscrollbar_policy         (default: 0)
 536         specify the policy of vertical scroll bar of folder view
 537         0: always  1: automatic  2: never
 538
 539     hover_timeout                       (default: 500)
 540         time in milliseconds that will cause a folder tree to expand
 541         during drag n drop when the mouse cover is held over it
 542
 543     live_dangerously                    (default: 0)
 544         Don't ask for confirmation before definitive deletion of
 545         emails.
 546         0: off  1: on
 547
 548     log_error_color                     (default: #af0000)
 549     log_in_color                        (default: #000000)
 550     log_msg_color                       (default: #00af00)
 551     log_out_color                       (default: #0000ef)
 552     log_warn_color                      (default: #af0000)
 553     log_status_ok_color                 (default: #00af00)
 554     log_status_nok_color                (default: #0000af)
 555     log_status_skip_color               (default: #aa00aa)
 556         The colours used in the Network Log window.
 557
 558     msgview_date_format                 (default: 0)
 559         Use the same user-defined date format in the Message View as
 560         is used in the Message List.
 561         0: off  1: on
 562
 563     outgoing_fallback_to_ascii          (default: 1)
 564         The outgoing encoding of a message will use 7bit US-ASCII
 565         whenever it is suitable for the message content, ignoring
 566         the "Outgoing encoding" option unless it is necessary.
 567         Turning this option off forces the user-defined encoding to
 568         be used, regardless of message content.
 569         0: off  1: on
 570
 571     primary_paste_unselects             (default: 0)
 572         Causes the primary buffer to be cleared and the insertion
 573         point to be repositioned when the middle mouse button is used
 574         for pasting text.
 575         0: off  1: on
 576
 577     respect_flowed_format               (default: 0)
 578         Respect format=flowed on text/plain message parts. This will
 579         cause some mails to have long lines, but will fix some URLs
 580         that would otherwise be wrapped.
 581         0: off  1: on
 582
 583     save_parts_readwrite                (default: 0)
 584         Saves temporary files when opening attachment with write bit
 585         set.
 586         0: off  1: on
 587
 588     show_compose_margin                 (default: 0)
 589         Adds margins to the message text area in the Compose window.
 590         0: off  1: on
 591
 592     show_inline_attachments             (default: 1)
 593         Show inline attachments in MimeView.
 594         0: off  1: on
 595
 596     skip_ssl_cert_check                 (default: 0)
 597         Disables the verification of SSL certificates.
 598         0: off  1: on
 599
 600     statusbar_update_step               (default: 10)
 601         Update stepping in progress bars.
 602
 603     stripes_color_offset                (default: 4000)
 604         Specify the value to use when creating alternately coloured
 605         lines in GtkTreeView components. The smaller the value, the
 606         less visible the difference in the alternating colours of the
 607         lines.
 608
 609     textview_cursor_visible             (default: 0)
 610         display the cursor in the message view.
 611         0: off  1: on
 612
 613     thread_by_subject_max_age           (default: 10)
 614         number of days to include a message in a thread when using
 615         'Thread using subject in addition to standard headers'.
 616
 617     toolbar_detachable                  (default: 0)
 618         hide handles in the toolbar.
 619         0: off  1: on
 620
 621     two_line_vertical                   (default: 1)
 622         Spread message list information over two lines when using the
 623         three column layout.
 624         0: off  1: on
 625
 626     unsafe_ssl_certs                    (default: 0)
 627         Allows Claws to remember multiple SSL certificates for a
 628         given server/port.
 629         0: off  1: on
 630
 631     use_networkmanager                  (default: 1)
 632         Use NetworkManager to switch offline automatically.
 633         0: off  1: on
 634
 635     use_stripes_everywhere              (default: 1)
 636         Enable alternately coloured lines in GtkTreeView components.
 637         0: off  1: on
 638
 639     use_stripes_in_summaries            (default: 1)
 640         Enable alternately coloured lines in the main window
 641         GtkTreeView components, (Folder List and Message List). The
 642         only useful way to use this option is to set it to 0 when
 643         use_stripes_everywhere is set to 1.
 644         0: off  1: on
 645
 646     utf8_instead_of_locale_for_broken_mail      (default: 0)
 647         Use UTF-8 encoding for broken mails instead of current
 648         locale.
 649         0: off  1: on
 650
 651     warn_dnd                    (default: 1)
 652         Display a confirmation dialog on drag'n'drop of folders.
 653         0: off  1: on
 654
 655     zero_replacement_char       (default: 0)
 656         Character to show in Folder List counter columns when a
 657         folder doesn't contain messages.
 658
 659 9. Tools
 660 ---------
 661   You will find all of these tools in the 'tools' directory:
 662
 663   acroread2claws-mail.pl
 664         send PDFs from Adobe Reader 7
 665   calypso_convert.pl
 666         import mbox files exported by calypso
 667   claws-mail-compose-insert-files.pl
 668         insert files into a new Compose window
 669   convert_mbox.pl
 670         convert mbox format to MH format
 671   csv2addressbook.pl
 672         import Becky, Thunderbird, Kmail, Gmail and Fox Mail
 673         address books
 674   eud2gc.py
 675         convert a Eudora (v.3?) addressbook to vCard
 676         (GnomeCard) format
 677   filter_conv.pl
 678         convert sylpheed main's filter rules, (< 0.9.99),
 679         into Claws' filtering format
 680   filter_conv_new.pl
 681         convert sylpheed main's filter rules, (>= 0.9.99),
 682         into Claws' filtering format
 683   fix-date.sh
 684         Replace/Add a message's Date field
 685   freshmeat_search.pl
 686         Actions script to lookup the selected text on
 687         Freshmeat www.freshmeat.net using the configured
 688         browser
 689   gif2xface.pl
 690         convert a gif file to an xface
 691   google_msgid.pl
 692         Actions script to lookup selected message-id on
 693         google using mozilla.
 694   google_search.pl
 695         Actions script to lookup up the selected text on
 696         google using the configured browser
 697   kdeservicemenu/*
 698         Service Menus for Konqueror to allow sending
 699         files to Claws Mail
 700   kmail2claws-mail.pl
 701         convert a Kmail addressbook to a Claws Mail
 702         addressbook
 703   kmail2claws-mail_v2.pl
 704         new version of the address book conversion script
 705         for newer versions of Kmail/Kaddressbook
 706   kmail-mailbox2claws-mail.pl
 707         convert a Kmail mailbox into a Claws mail mailbox
 708   mairix.sh
 709         a wrapper to mairix, to enable global searches in mail
 710         folders
 711   mew2claws-mail.pl
 712         import a Mew address book
 713   multiwebsearch.pl
 714         search any searchable website for the selected text
 715   nautilus2claws-mail.sh
 716         enables sending files from the Nautilus file manager
 717         to Claws Mail
 718   OOo2claws-mail.pl
 719         enable OpenOffice to send documents through
 720         Claws Mail
 721   outlook2claws-mail.pl
 722         convert an Outlook contacts list to a Claws Mail
 723         addressbook
 724   popfile-link.sh
 725         open messages in POPFile control center to edit their status
 726   sylprint.pl
 727         process a Claws Mail message and print it using enscript
 728         if available or lpr if not
 729   tb2claws-mail
 730         convert an addressbook exported from The Bat! into
 731         a Claws Mail addressbook
 732   tbird2claws.py
 733         integrate a Thunderbird folder tree into Claws Mail
 734   textviewer.pl
 735         Display various attachments as text
 736   textviewer.sh
 737         attempt to view an attachment as plain text
 738   thunderbird-filters-convertor.pl
 739         convert Thunderbird filtering rules
 740   update-po
 741         translators' tool that eases the creation of
 742         *.po files
 743   uudec
 744         decode UUencoded mails, for use with Actions
 745   uuooffice
 746         Decode uuencoded attachments and open them with OpenOffice
 747   vcard2xml.py
 748         import an Evolution vCard
 749
 750
 751 10. How to contribute
 752 ---------------------
 753
 754 You are encourged to send patches via the Claws Mail bugzilla at
 755 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
 756 But please first read the patch guidelines here:
 757 http://www.claws-mail.org/devel.php
 758
 759 If that's too troublesome, either contact Paul Mangan
 760 <paul@claws-mail.org> or consider posting to the
 761 Claws Mail-users mailing list.
 762 http://www.claws-mail.org/MLs.php
 763
 764 Bugs can be reported with Claws' bugzilla at:
 765 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
 766
 767 Of course, you can also post to the Claws Mail-users mailing list.
 768
 769 Also, we really try to incorporate good contributions, but sometimes we
 770 don't have enough time. If the contribution is really big, or requires
 771 a long time to stabilise, send a mail to Paul Mangan
 772 <paul@claws-mail.org>. We can probably arrange access to the
 773 Claws Mail Git repository.
 774
 775
 776
 777 11. How to request features
 778 ---------------------------
 779
 780 Ask around in Claws Mail-users ML. Note that some developers may
 781 have already thought about your feature and may, perhaps, be implementing
 782 it, or the feature was already discussed and rejected for whatever reason.
 783 You might want to go ahead and hack a patch for it. (That would be very
 784 cool!) Another possibility is to add a request to our bugzilla, (severity:
 785 'enhancement'), at
 786 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
 787
 788
 789 12. Installing Claws Mail from Git
 790 --------------------------------------
 791
 792   a. Downloading
 793   --------------
 794
 795   To download the latest Git, cd to the directory where you wish to download
 796   to and type the following information:
 797
 798   git clone http://git.claws-mail.org/readonly/claws.git
 799
 800   Later, when you want to update your local repository, you'll just have to
 801   go back to the 'claws' directory, and type:
 802
 803   git pull --all
 804
 805   b. Installing
 806   -------------
 807
 808   To compile and install use the following commands:
 809
 810   ./autogen.sh          [add configure options as required]
 811   make
 812   make install          [as root]
 813
 814   You will need a full set of development tools installed to be able to run
 815   autogen.sh. See also ac/README.
 816
 817
 818
 819 13. Release History
 820 -------------------
 821
 822 GTK 2 Version
 823 -------------
 824 2015-07-19      3.12.0
 825 2014-10-27      3.11.1
 826 2014-10-20      3.11.0
 827 2014-06-09      3.10.1
 828 2014-05-26      3.10.0
 829 2013-12-14      3.9.3
 830 2013-06-08      3.9.2
 831 2013-05-06      3.9.1
 832 2012-11-14      3.9.0
 833 2012-06-27      3.8.1
 834 2011-12-16      3.8.0
 835 2011-08-27      3.7.10
 836 2011-04-09      3.7.9
 837 2010-12-04      3.7.8
 838 2010-11-19      3.7.7
 839 2010-05-01      3.7.6
 840 2010-01-31      3.7.5
 841 2010-01-08      3.7.4
 842 2009-10-09      3.7.3
 843 2009-07-03      3.7.2
 844 2009-03-06      3.7.1
 845 2008-12-19      3.7.0
 846 2008-10-10      3.6.1
 847 2008-10-03      3.6.0
 848 2008-06-27      3.5.0
 849 2008-04-18      3.4.0
 850 2008-02-23      3.3.1
 851 2008-02-08      3.3.0
 852 2007-12-17      3.2.0
 853 2007-11-19      3.1.0
 854 2007-10-02      3.0.2
 855 2007-09-17      3.0.1
 856 2007-09-03      3.0.0
 857 2007-07-02      2.10.0
 858 2007-05-08      2.9.2
 859 2007-04-19      2.9.1
 860 2007-04-16      2.9.0
 861 2007-03-06      2.8.1
 862 2007-02-26      2.8.0
 863 2007-01-26      2.7.2
 864 2007-01-15      2.7.1
 865 2007-01-08      2.7.0
 866 2006-12-04      2.6.1 [first release as Claws Mail]
 867 2006-11-06      2.6.0
 868 2006-10-19      2.5.6
 869 2006-10-12      2.5.5
 870 2006-10-11      2.5.4
 871 2006-10-04      2.5.3
 872 2006-09-26      2.5.2
 873 2006-09-26      2.5.1
 874 2006-09-25      2.5.0
 875 2006-07-31      2.4.0
 876 2006-06-20      2.3.1
 877 2006-06-12      2.3.0
 878 2006-06-08      2.2.3
 879 2006-06-06      2.2.2
 880 2006-06-05      2.2.1
 881 2006-05-08      2.2.0
 882 2006-04-17      2.1.1
 883 2006-04-05      2.1.0
 884 2006-01-30      2.0.0
 885 2005-11-08      1.9.100
 886 2005-10-31      1.9.99
 887 2005-10-03      1.9.15
 888 2005-09-05      1.9.14
 889 2005-07-22      1.9.13
 890 2005-06-27      1.9.12
 891 2005-05-19      1.9.11
 892 2005-05-09      1.9.9
 893 2005-03-18      1.9.6
 894
 895 GTK 1 Version
 896 -------------
 897 2005-06-27      1.0.5
 898 2005-05-09      1.0.4a
 899 2005-03-24      1.0.4
 900 2005-03-10      1.0.3
 901 2005-02-08      1.0.1
 902 2005-01-17      1.0.0
 903 2004-12-06      0.9.13
 904 2004-09-27      0.9.12b
 905 2004-08-23      0.9.12a
 906 2004-06-28      0.9.12
 907 2004-05-31      0.9.11claws
 908 2004-03-08      0.9.10claws
 909 2004-02-06      0.9.9claws
 910 2003-12-19      0.9.8claws
 911 2003-11-26      0.9.7claws
 912 2003-10-02      0.9.6claws
 913 2003-09-10      0.9.5claws
 914 2003-08-04      0.9.4claws
 915 2003-07-12      0.9.3claws
 916 2003-05-24      0.9.0claws
 917 2003-03-12      0.8.11claws
 918 2003-02-12      0.8.10claws
 919 2003-01-24      0.8.9claws
 920 2002-12-26      0.8.8claws
 921 2002-12-23      0.8.7claws
 922 2002-11-25      0.8.6claws
 923 2002-10-07      0.8.5claws
 924 2002-09-22      0.8.3claws
 925 2002-08-28      0.8.2claws
 926 2002-07-30      0.8.1claws
 927 2002-07-23      0.8.0claws
 928 2002-06-15      0.7.8claws
 929 2002-05-18      0.7.6claws
 930 2002-04-28      0.7.5claws
 931 2002-03-11      0.7.4claws
 932 2002-02-19      0.7.2claws
 933 2002-02-14      0.7.1claws
 934 2002-01-14      0.7.0claws
 935 2001-12-16      0.6.6claws
 936 2001-10-16      0.6.5claws8
 937 2001-09-30      0.6.2claws
 938 2001-08-14      0.6.1claws
 939 2001-07-13      0.5.1claws
 940 2001-07-01      0.5.0claws3
 941 2001-06-16      0.4.99claws
 942 2001-05-29      0.4.99claws3
 943 2001-05-11      0.4.67claws1
 944
 945
 946
 947 14. Useful links
 948 ----------------
 949 Homepage
 950     http://www.claws-mail.org/
 951 User Contributed FAQ
 952     http://www.claws-mail.org/faq/
 953 Project page
 954     http://sourceforge.net/projects/claws-mail/
 955 Downloads
 956     http://www.claws-mail.org/downloads.php
 957 Extra Plugins
 958     http://www.claws-mail.org/plugins.php
 959 Icon Themes
 960     http://www.claws-mail.org/themes.php
 961 Mailing Lists
 962     http://www.claws-mail.org/MLs.php
 963 Users Mailing List archive
 964     http://lists.claws-mail.org/pipermail/users/index.html
 965 Commits Announcement List archive
 966     http://lists.claws-mail.org/pipermail/commits/index.html
 967 Bug/Patch/Feature Request Tracker
 968     http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
 969 Internationalisation Status
 970     http://www.claws-mail.org/i18n.php
 971 Donations
 972     http://www.claws-mail.org/sponsors.php
 973 Planet Claws Mail
 974     http://planet.claws-mail.org/
 975 Claws Mail for Windows homepage
 976     http://www.claws-mail.org/win32/
 977