README

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