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