Add license and copyright to 9b3fd2b5
[claws.git] / tools / README
index 4def5feeedd195dd89f887e74e0c2a4517ba59f3..05bccc6a75c75ed53df79e96b6f39d39db32f846 100644 (file)
@@ -4,44 +4,49 @@ Contents of the tools directory:
 --------------------------------------------------------------------------------
 
 Action scripts:
-  freshmeat_search.pl          Search freshmeat.net for selected text
+  freshmeat_search.pl           Search freshmeat.net for selected text
   google_msgid.pl               Search groups.google.com for selected message-id
-  google_search.pl             Search google.com for selected text
-  multiwebsearch.pl            Search any search engine for the selected text
-  textviewer.sh                        Attempt to view an attachment as plain text
+  google_search.pl              Search google.com for selected text
+  multiwebsearch.pl             Search any search engine for the selected text
+  textviewer.sh                 Attempt to view an attachment as plain text
   uudec                         Decode and display uuencoded images
-  uuooffice                    Decode uuencoded attachments and open them with
-                               OpenOffice
+  uuooffice                     Decode uuencoded attachments and open them with
+                                OpenOffice
 
 Addressbook conversion:
+  csv2addressbook.pl           Import Becky, Thunderbird, Kmail, Gmail and Fox
+                               Mail address books
   eud2gc.py                     Convert Eudora address book to Gnomecard
   kmail2claws-mail.pl           Import a Kmail address book (KDE2)
   kmail2claws-mail_v2.pl        Import a Kmail address book (KDE3)
+  mew2claws-mail.pl            Import a Mew address book
   outlook2claws-mail.pl         Import an Outlook generated contact list
   tb2claws-mail                 Import The Bat! address books
-  vcard2xml.py                 Import an Evolution vCard
+  vcard2xml.py                  Import an Evolution vCard
 
 Mailbox conversion:
   calypso_convert.pl            Import mbox files with attachments from Calypso
-  convert_mbox.pl              Import mbox files
-  kmail-mailbox2claws-mail.pl  Convert a kmail mailbox to a Claws Mail mailbox
-  tbird2claws.py               Integrate a Thunderbird folder tree into Claws
+  convert_mbox.pl               Import mbox files
+  kmail-mailbox2claws-mail.pl   Convert a kmail mailbox to a Claws Mail mailbox
+  tbird2claws.py                Integrate a Thunderbird folder tree into Claws
 
 Other tools:
-  acroread2claws-mail.pl       Send PDFs from Adobe Reader 7
+  acroread2claws-mail.pl        Send PDFs from Adobe Reader 7
   claws-mail-compose-insert-files.pl
-                               Insert files into a new Compose window
-  filter_conv_new.pl           Convert new-style Sylpheed filters to filtering
+                                Insert files into a new Compose window
+  filter_conv_new.pl            Convert new-style Sylpheed filters to filtering
   filter_conv.pl                Convert old-style Sylpheed filters to filtering
-  fix-date.sh                  Replace/Add a message's Date field
-  mairix.sh                     Indexed search in virtual folders (mairix
-                                wrapper)
-  nautilus2claws-mail.sh       Send files from Nautilus
+  fix-date.sh                   Replace/Add a message's Date field
+  mairix.sh                     A wrapper to mairix, to enable global searches in
+                                mail folders
+  nautilus2claws-mail.sh        Send files from Nautilus
   OOo2claws-mail.pl             Send documents from OpenOffice.org
+  popfile-link.sh               Open messages in POPFile control center to edit
+                                their status
   sylprint.pl                   Printing engine, explained in README.sylprint
-  textviewer.pl                        Display various attachments as text
+  textviewer.pl                 Display various attachments as text
   thunderbird-filters-convertor.pl
-                               Convert Thunderbird filtering rules
+                                Convert Thunderbird filtering rules
 
 Extra tools:
   gif2xface.pl                  Convert a 48x48 GIF file to an X-Face header
@@ -135,6 +140,86 @@ Action scripts
 Address book conversion
 -----------------------
 
+* csv2addressbook.pl
+
+  WHAT IT DOES
+       This perl script will import a Becky, Thunderbird, Kmail, Gmail and
+       Fox Mail address book.
+
+  HOW TO USE IT
+       (You must run claws-mail at least once before running this script.)
+
+       Becky >= 2.41
+       -------------
+       In Becky you need to do a CSV full export with titles of your
+       address book.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=becky --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Becky address book'.
+
+
+       Thunderbird >= 2.0.0.6
+       ----------------------
+       In Thunderbird you need to export your address book as 'comma
+       separated'.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=thunderbird --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Thunderbird address book'.
+
+       Kmail >= 1.9.7 / Kaddressbook >= 3.5.7
+       --------------------------------------
+       In Kaddressbook you need to export your address book as 'CSV List'.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=kmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Kmail address book'.
+
+       WARNING: Kmail/Kaddressbook has a bug whereby it exports badly
+       formatted CSV if the values are quoted.
+
+       Gmail
+       -----
+       In the Gmail web interface you need to export your address book
+       as Outlook CSV format.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=gmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'gmail address book'.
+
+       Fox Mail
+       --------
+       Export your Fox Mail address book as CSV with all possible headers.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=foxmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'foxmail address book'.
+
+       You can also run the script with '--help' to get a brief usage message.
+
+  Contact: Paul Mangan <paul@claws-mail.org>
+
 * eud2gc.py
 
   WHAT IT DOES
@@ -207,6 +292,27 @@ Address book conversion
 
   Contact: Paul Mangan <paul@claws-mail.org>
 
+* mew2claws-mail.pl
+
+  WHAT IT DOES
+       This perl script will convert a Mew address book into a Claws Mail
+       address book.
+
+  HOW TO USE IT
+       (You must run claws-mail at least once before running this script.)
+  
+       If Claws Mail is running, close it.
+
+       From the command line, execute the following:
+               perl mew2claws-mail.pl --mew-addressbook=/path/to/mew/addressbook
+       
+       You can also use --help to see usage instructions.
+
+       Your Mew addressbook data will now be contained in Claws Mail's
+       addressbook, under the name 'Mew Address Book'.
+
+  Contact: Jérôme Lelong <jerome.lelong@gmail.com>
 
 * outlook2claws-mail.pl
 
@@ -248,7 +354,7 @@ Address book conversion
        the script and change its value if you are sure you exported all
        fields and script gives the 'unknown csv file format' error.
 
-  Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
+  Contact: Ricardo Mones <ricardo@mones.org>
 
 
 * tb2claws-mail
@@ -371,7 +477,7 @@ Mailbox conversion
        
   Contact: Paul Mangan <paul@claws-mail.org>
 
-* tbird2syl.py
+* tbird2claws.py
 
   WHAT IT DOES
        This python script integrates a Thunderbird folder tree into 
@@ -385,7 +491,7 @@ Mailbox conversion
        The best way to use it is to go to inside your Thunderbird
        root mailfolder directory and invoke it as:
 
-               <path>\python2.4 <path>\tbird2syl.py . <path to Claws Mail>\Mail
+               <path>\python2.4 <path>\tbird2claws.py . <path to Claws Mail>\Mail
 
   Contact: Aleksandar Urosevic aka Urke MMI <urke@gmx.net>
 
@@ -418,18 +524,21 @@ Other tools
   WHAT IT DOES
        This script enables inserting files into the message body of a new 
        Claws Mail Compose window from the command line. Additionally To,
-       Cc, Subject and files to attach to the message can be specified. 
+       Cc, Bcc, Subject and files to attach to the message can be specified. 
 
   HOW TO USE IT
        claws-mail-compose-insert-files.pl [options]
        Options:
-               --help -h
-               --to mail@address.net[,mail2@address.net]
-               --cc mail@address.net[,mail2@address.net]
-               --subject "My subject"
-               --attach FILE
-               --insert FILE
-
+               --help -h
+               --to "Person One <mail@address.net>"
+               --cc "Person One <mail@address.net>"
+                       --bcc "Person One <mail@address.net>"
+               --subject "My subject"
+               --attach FILE
+               --insert FILE
+
+       For multiple recipients separate the addresses with ','
+       e.g. --to "Person One <mail@address.net>,Person Two <mail2@address.net>"
        --attach and --insert can be used multiple times
   
   Contact: Paul Mangan <paul@claws-mail.org>
@@ -479,14 +588,23 @@ Other tools
 * fix-date.sh
 
  WHAT IT DOES
-       It will replace the Date: value w/ the one picked up from
-       more recent Received: field if this field resides in one
-       line. Otherwise, it will take the file modification time
-       (using a RFC 2822-compliant form). If no X-Original-Date already
-       exist, the former Date value will be set in such field.
-
+       Add a 'Date:' header to the selected email(s) when such header is 
+       missing. The correct date is guessed from other headers that contain 
+       timestamp information (preferred: Fetchinfo header if found) or from 
+       the file or system date as a fallback. The order or preference for the
+       date valuereplacement can be changed by editing the script.
+       This script can be used to fix messages that show non RFC-compliant
+       Date headers as well.
+       X-Original-Date is always added too if not already existing (if so,
+       it's left untouched), to keep track of the original value if any.
+       An existing Date: header is not overwritten unless you use the --force
+       switch.
+       Non RFC-compliant dates can be overwritten using the --rfc switch. Use
+       --strict to use strict RFC matching patterns for date values in other
+       headers.
+       
   HOW TO USE IT
-       fix_date.sh <filename> [<filename>..]
+       fix_date.sh %F
 
   Contact: wwp <wwp@claws-mail.org>
 
@@ -501,7 +619,10 @@ Other tools
 
   HOW TO USE IT
        mairix.sh
-       mairix.sh <rcfile> [<options>..]
+       mairix.sh <mairix rcfile> [<mairix options>..]
+    
+    For instance:    
+    mairix.sh ~/.mairixrc s:word1,word2
 
   Contact: wwp <wwp@claws-mail.org>
 
@@ -558,11 +679,27 @@ Other tools
   Contact: Paul Mangan <paul@claws-mail.org>
 
 
+* popfile-link.sh
+
+ WHAT IT DOES
+       Open selected messages in POPFile control center to edit their
+       status. Requires that POPFile is running and that the messages
+       have been processed by it (X-POPFile-Link: header is expected).
+       POPFile control center opens with the web browser set in
+       Claws Mail prefs.
+
+  HOW TO USE IT
+       popfile-link.sh <filename> [<filename>..]
+    
+
+  Contact: wwp <wwp@claws-mail.org>
+
+
 * textviewer.pl
 
   WHAT IT DOES
        This script tries to recognise an attachment by using the 'file'
-       command and/or the file extension and then uses the available Linux
+       command and/or the file extension and then uses the available
        utilities to make an effort to display it as text. For example
                .doc                    antiword -w 72
                .txt, .diff, .c, .h,
@@ -635,8 +772,8 @@ Extra tools
        This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
        into an X-Face graphic suitable for inclusion into custom headers of
        Claws Mail. An X-Face allows to quickly identify (or be identified
-       as) the sender of a mail message in a xface-capable MUA (like sylpheed
-       -claws).
+       as) the sender of a mail message in a xface-capable MUA (like Claws
+       Mail).
 
   HOW TO USE IT
        After obtaining the desired image for your X-Face you should:
@@ -661,7 +798,7 @@ Extra tools
        method is valid only if you don't have any other custom header set or
        they will be lost!).
 
-  Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
+  Contact: Ricardo Mones <ricardo@mones.org>
 
 
 * update-po
@@ -684,3 +821,6 @@ Extra tools
   Contact: Wilbert Berendsen <wilbert@oswf.org> or the Claws Mail Team
 
 --------------------------------------------------------------------------------
+This file is Copyright 1999-2014 by the Claws Mail team.
+See accompanying COPYING file for license details.
+See each included script for copyright and license details.