-* eud2gc.py
+
+--------------------------------------------------------------------------------
+Contents of the tools directory:
+--------------------------------------------------------------------------------
+
+Action scripts:
+ 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
+ uudec Decode and display uuencoded images
+ 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
+
+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
+
+Other tools:
+ 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
+ filter_conv.pl Convert old-style Sylpheed filters to filtering
+ 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
+ thunderbird-filters-convertor.pl
+ Convert Thunderbird filtering rules
+
+Extra tools:
+ gif2xface.pl Convert a 48x48 GIF file to an X-Face header
+ update-po Update the .po files named on the command line.
+
+--------------------------------------------------------------------------------
+Detailed Descriptions:
+--------------------------------------------------------------------------------
+
+Action scripts
+--------------
+
+* freshmeat_search.pl
+ WORKS ON: selection
+ COMMAND: |freshmeat_search.pl
+ Search freshmeat.net for selected text using the default Claws Mail browser
+
+* google_msgid.pl
+ WORKS ON: selection
+ COMMAND: |google_msgid.pl
+ Lookup selected message-id in google using mozilla. Edit the script to use
+ different browsers.
+
+* google_search.pl
+ WORKS ON: selection
+ COMMAND: |google_search.pl
+ Search google.com for selected text using the default Claws Mail browser
+
+* multiwebsearch.pl
+ WORKS ON: selection
+ see further down for details
+
+* textviewer.sh
+ WORKS ON: current message part
+ COMMAND: textviewer.sh %p |
+ Attempt to view an attachment as plain text
+
+* uudec
+ WORKS ON: current message (or part of multipart message)
+ COMMAND: uudec %f&
+ Decode and display uuencoded images using uudecode.
+
+* uuooffice
+ WORKS ON: current message (or part of multipart message)
+ COMMAND: uuooffice %f&
+ Decode uuencoded attachments and open them with OpenOffice
+
+* More action examples can be found at the Claws Mail FAQ
+ http://www.claws-mail.org/faq/index.php/Actions
+
+** multiwebsearch.pl **
WHAT IT DOES
+ This is an Actions script that allows you to search
+ websites for the selected text. It uses the default
+ Claws Mail browser as configured through Claws Mail's
+ GUI and specified in ~/.claws-mail/clawsrc, and a
+ configuration file called multiwebsearch.conf.
+
+ CONFIGURATION
+ The configuration file takes the following format:
+
+ ALIAS|URL PART|URL PART
+
+ ALIAS is a user-defined name; the first URL PART is the
+ url before the search term; the second URL PART is
+ optional and contains the remaining part of the url which
+ comes after the search term. A sample configuration file
+ is included.
+
+ HOW TO USE IT
+ Copy 'multiwebsearch.conf' to ~/.claws-mail/
+
+ Configure an Action:
+ a) pre-configured website
+ Command: multiwebsearch.pl --where="google" --what="%s"
+ b) dynamic
+ Command: multiwebsearch.pl --where="%u" --what="%s"
+
+ In type a) "google" refers to one of the configured aliases,
+ this Action will always search the website referred to by
+ the alias "google".
+
+ In type b) you will be presented with a dialog box into
+ which you type one of your configured aliases
+
+
+ Contact: Paul Mangan <paul@claws-mail.org>
+--------------------------------------------------------------------------------
+
+Address book conversion
+-----------------------
- This python-script is a quick hack to convert an Eudora (v.3?) addressbook
- to vCard (GnomeCard) format.
+* 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.)
- You may do whatever you want with it! (Also regarding copying)
+ Becky >= 2.41
+ -------------
+ In Becky you need to do a CSV full export with titles of your
+ address book.
- However, the script is intended to use like this:
+ Run the script with the following options:
- eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
+ perl csv2addressbook.pl --type=becky --csv=/full/path/to/file.csv
- Be careful not to overwrite your original GnomeCard.gcrd!
- (But of course you might want to add the converted stuff to it)
+ 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'.
- Copyleft some time long ago (around 1999?) by Jeroen Versteeg
- (j.m.versteeg@student.utwente.nl)
------------------------------------------------------------------------
+ Thunderbird >= 2.0.0.6
+ ----------------------
+ In Thunderbird you need to export your address book as 'comma
+ separated'.
-* filter_conv.pl
+ Run the script with the following options:
- WHAT IT DOES
+ perl csv2addressbook.pl --type=thunderbird --csv=/full/path/to/file.csv
- This perl script provides easy conversion of your filtering rules
- form sylpheed's old filter system to the new filtering system used
- in sylpheed-claws. It reads '~/.sylpheed/filterrc' and outputs
- '~/.sylpheed/matcherrc'.
-
- HOW TO USE IT
+ 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'.
- Issue the following command from the 'tools' directory:
+ Kmail >= 1.9.7 / Kaddressbook >= 3.5.7
+ --------------------------------------
+ In Kaddressbook you need to export your address book as 'CSV List'.
- perl filter_conv.pl
+ Run the script with the following options:
- That's it, the new filtering system is now implemented with your
- previous rules applied.
+ perl csv2addressbook.pl --type=kmail --csv=/full/path/to/file.csv
- Any problems, contact Paul <claws@thewildbeast.co.uk>
+ 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.
-* gif2xface.pl
+ 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
+ This python-script is a quick hack to convert an Eudora (v.3?)
+ addressbook to vCard (GnomeCard) format.
+
+ HOW TO USE IT
+ You may do whatever you want with it! (Also regarding copying)
+ However, the script is intended to use like this:
- This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
- into an X-Face graphic suitable for inclusion into custom headers of
- Sylpheed. An X-Face allows to quickly identify (or be identified as)
- the sender of a mail message in a xface-capable MUA (like sylpheed).
+ eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
+
+ Be careful not to overwrite your original GnomeCard.gcrd!
+ (But of course you might want to add the converted stuff to it)
+
+ Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
+
+* kmail2claws-mail.pl
+
+ WHAT IT DOES
+ This perl script will convert an exported Kmail addressbook into a
+ Claws Mail addressbook. If your version of Kmail is 1.37 or
+ greater and/or your version of KAddressBook is 3.1beta1 or greater,
+ or this script mixes up your definitions and their related data, use
+ 'kmail2claws-mail_v2.pl' instead.
HOW TO USE IT
+ (You must run claws-mail at least once before running this script.)
- After obtaining the desired image for your X-Face you should:
- * scale it to 48x48 pixels (Image->Scale image on Gimp)
- * down color depth to b/w (Image->Mode->Indexed selecting "Use
- Black/White palette" and the desired dithering options (prior to
- indexing doing Image->Colors->Threshold allows you to select the
- b/w level if you don't want a dithered (dotty) image))
- * save file as non-interlaced GIF
- Then do:
+ In Kmail's Address book choose '/File/Export List'. This will export
+ your Kmail address book data to a *.csv file.
- ./gif2xface < filename.gif > filename.xface
+ If Claws Mail is running, close it.
- In filename.xface will be the X-Face header ready to use.
- You can add a custom header in Sylpheed through Configuration->
- Preferences per account, "Send" tab, check "Add user-defined header"
- then "Edit..." if you want to add it via Sylpheed interface, or do
+ From the command line, execute the following:
+
+ perl kmail2claws-mail.pl --kmailfile=/path/to/addressbook.csv
+
+ Your Kmail address book data will now be contained in Claws Mail'
+ address book, under the name 'Kmail Address Book'.
+
+ Contact: Paul Mangan <paul@claws-mail.org>
+
+
+* kmail2claws-mail_v2.pl
+
+ This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
- echo "0:" `cat filename.xface` > ~/.sylpheed/customheaderrc
+ WHAT IT DOES
+ This perl script will convert a Kmail address book that has been
+ exported in csv format into a Claws Mail address book.
- if you want to create the custom headers file yourself (Warning: this
- method is valid only if you don't have any other custom header set or
- they will be lost!).
+ HOW TO USE IT
+ (You must run claws-mail at least once before running this script.)
+
+ Open Kmail's Addressbook, /File/Address Book
+ In Kmail's Addressbook choose '/File/Export/Export List...'. This
+ will allow you to export your Kmail addressbook data to a *.csv file.
- Any problems, contact Ricardo Mones Lastra <mones@aic.uniovi.es>
+ If Claws Mail is running, close it.
+
+ From the command line, execute the following:
+
+ perl kmail2claws-mail_v2.pl --kmailfile=/path/to/addressbook.csv
+
+ You can also use --help to see usage instructions.
------------------------------------------------------------------------
+ Your Kmail addressbook data will now be contained in Claws Mail'
+ addressbook, under the name 'Kmail address book'.
-* kmail2sylpheed.pl
+ 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.
- This perl script will convert an exported Kmail addressbook into a
- Sylpheed addressbook.
+ 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
+
+ WHAT IT DOES
+ This perl script converts an Outlook generated contact list into a
+ Claws Mail XML address book.
HOW TO USE IT
+ For text files:
+ --------------
+ You must export Outlook Express contact list as TXT file, choosing
+ only "Name" and "Address" fields to export.
- (You must run sylpheed at least once before running this script.)
+ You must exit Claws Mail before converting the contact list.
- In Kmail's Addressbook choose '/File/Export List'. This will export
- your Kmail addressbook data to a *.csv file.
+ From the command line, execute the following:
- If Sylpheed is running, close it.
+ outlook2claws-mail.pl fullpathname
- From the command line, execute the following:
-
- perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
+ For csv files:
+ -------------
+ You must export Outlook contact list as CSV file, choosing ALL the
+ fields available for exporting.
- Your Kmail addressbook data will now be contained in Sylpheed's
- addressbook, under the name 'Kmail Address Book'.
+ You must exit Claws Mail before converting the contact list.
- Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
+ From the command line, execute the following:
------------------------------------------------------------------------
+ outlook2claws-mail.pl --csv fullpathname
-* ldif-to-xml.py
+ LIMITATIONS
+ For text files only works with fields described above. If you have
+ more complex examples send them to me, and I'll try to enhance the
+ script.
+
+ For csv files you must export all fields (but only non empty fields
+ are added to the created Claws Mail address book) and the number
+ of fields expected is harcoded. Look for the $nboffields variable in
+ 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>
- WHAT IT DOES
- This python script converts the netscape ldif format address book to
- the sylpheed xml format.
+* tb2claws-mail
+
+ WHAT IT DOES
+ This perl script will convert an address book exported from The Bat!
+ into a Claws Mail address book.
HOW TO USE IT
+ (You must run claws-mail at least once before running this script.)
- Inside Netscape export your address book to a file.
- From the command line, execute:
+ If Claws Mail is running, close it.
- ./ldif-to-xml.py <path/filename>
+ Export The Bat! Address Book to CSV file format with all fields
+ selected to YES and then start:
- In case of trouble, just invoke your python interpreter directly:
+ tb2claws-mail --tbfile=/full/path/to/thebat/addressbook.csv
+
+ The Bat! addressbook data will now be contained in Claws Mail'
+ addressbook, under the name 'The Bat! Address Book'.
- python ldif-to-xml.py <path/filename>
+ Contact: Urke MMI <urke@gmx.net>
- Either way a file called addressbook.xml will be generated in the current
- directory. This xml file should be merged with or simply placed in the
- $HOME/.sylpheed directory.
- Any problems, contact Rod Senra <rodrigo.senra@ic.unicamp.br>
+* vcard2xml.py
------------------------------------------------------------------------
+ WHAT IT DOES
+ This python script will convert an Evolution vCard into a Claws Mail
+ address book.
-* newscache_clean.pl
+ HOW TO USE IT
+ (You must run claws-mail at least once before running this script.)
- WHAT IT DOES AND WHY IT DOES IT
+ If Claws Mail is running, close it.
+ From the command line, execute the following:
+
+ vcard2xml.py source_file [destination_file]
+
+ When only <source_file> is specified it will overwrite (and
+ create a backup of) the existing addressbook.
+ When both arguments are suplied it will create a new additional
+ addressbook named as <destination_file>.
+ If the script encounters an error it will attempt to roll back
+ the changes and restore the original files.
- This perl script cleans up in '$HOME/.sylpheed/newscache'. Currently
- the newscache becomes littered with old directories and files - when
- you subscribe to a newsgroup a sub-directory gets created for it in
- ~/.sylpheed/newscache/[nntpserver], should you unsubscribe from the
- group the sub-directory does not get deleted. Until this is done
- internally this script will take care of some tidying up.
+ Contact: Bogdan Sumanariu <bsumanariu@one5.ro>
+
+--------------------------------------------------------------------------------
+
+Mailbox conversion
+------------------
+
+* calypso_convert.pl
+
+ WHAT IT DOES
+ This perl script imports mbox files that are exported by Calypso.
+ It recreates the folder structure by scanning the "X-CalypsoFolder"
+ header and reincludes the attachments referenced in the
+ "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
+
+ HOW TO USE IT
+ Export the Calypso mailbox by selecting "Save to archive" and check
+ the "Save attachments" box.
+
+ Edit the script to set following variables (at the top of the file):
+ $mboxdir : path to the exported mbox, e.g. 'Archive' or '.'
+ $mboxfile : name of exported mbox, e.g. 'mail.txt'
+ $outdir : name of the MH folder to create, e.g. 'Calypso'
+
+ Run the script using
+
+ perl calypso_convert.pl
+
+ Finally, import that folder by either selecting "New mailbox" or
+ moving it into your existing directory and recreate the folder
+ structure manually (contentmenu from folderview).
+
+ Contact: Thorsten Maerz <torte@netztorte.de>
+
+* convert_mbox.pl
+
+ WHAT IT DOES
+ This perl script converts an mbox directory's contents into
+ Claws Mail' MH format.
+
+ HOW TO USE IT
- This script removes directory trees of nntp servers that you no longer
- have an account for. Where an account exists it removes directories
- and files of those groups to which you are no longer subscribed.
+ Run the script using:
+
+ perl convert_mbox.pl MBOX MH_DIR
+
+ Move the outputted MH_DIR and its contents into your Claws Mail
+ Mail folder; in Claws Mail right-click the top-level folder and
+ choose 'Rebuild folder tree' from the popup menu.
+
+ Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
+
+* kmail-mailbox2claws-mail.pl
+ WHAT IT DOES
+ This perl script converts a kmail mailbox into Claws Mail' mailbox.
+
HOW TO USE IT
+
+ Exit Claws Mail if running.
+
+ Run the script using:
+
+ kmail-mailbox2claws-mail.pl --kmaildir=/full/path/to/kmail/mailbox
+
+ Start Claws Mail and right-click the toplevel mailbox, i.e
+ "Mailbox (MH)", and select 'Rebuild folder tree'.
+ You may also need to run '/File/Folder/Check for new messages
+ in all folders'
+
+ Additional options:
+ --debug debug mode
+ --dry-run test mode, nothing is actually written
+ --help brief usage info
+
+ Contact: Paul Mangan <paul@claws-mail.org>
+
+* tbird2claws.py
- Issue the following command from the 'tools' directory:
+ WHAT IT DOES
+ This python script integrates a Thunderbird folder tree into
+ Claws Mail.
- perl newscache_clean.pl
-
- This script uses the File::Path module, if you don't already have it
- installed, you can find it at the CPAN search site <http://search.cpan.org>
+ HOW TO USE IT
+
+ The script receives two parameters from command-line:
+ <Thunderbird folder path> <Claws Mail folder path>
+
+ The best way to use it is to go to inside your Thunderbird
+ root mailfolder directory and invoke it as:
- Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
+ <path>\python2.4 <path>\tbird2claws.py . <path to Claws Mail>\Mail
------------------------------------------------------------------------
+ Contact: Aleksandar Urosevic aka Urke MMI <urke@gmx.net>
-* sylpheed-switcher
+--------------------------------------------------------------------------------
+
+Other tools
+-----------
+
+* acroread2claws-mail.pl
WHAT IT DOES
+ This perl script enables Adobe Reader 7 to send documents to
+ Claws Mail as attachments.
+
+ HOW TO USE IT
+ Make sure that the script is executable (chmod +x acroread2claws-mail.pl)
+ Start up Adobe Reader 7 (acroread)
+ Go to /Edit/Preferences/SendMail
+ Select any email client except 'System Mail (mail)'
+ Enter the path to this script in the alternate location box
+
+ You can then use 'File/Email' or the Email toolbar button to launch
+ claws-mail (if not already launched) and open a new compose window
+ with the PDF attached.
- This perl script is for users who like to move between the main
- sylpheed branch and the claws branch. Because of some differences
- between the stored options it is better IMO to use two separate
- '.sylpheed' directory trees. Doing that manually could prove to
- be tiresome, and so I've written this script to automate the task.
+ Contact: Paul Mangan <paul@claws-mail.org>
+
+* claws-mail-compose-insert-files.pl
- The first time you run this script you enter the full paths,
- including the executable itself, to both the main version of
- sylpheed and the claws version. This information is then stored
- in a file in your $HOME directory called '.sylpheed-switcher'
+ 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, Bcc, Subject and files to attach to the message can be specified.
- During this initial set-up, your '~/.sylpheed' directory
- is copied to '~/.sylpheed-main' and '~/.sylpheed-claws'.
+ HOW TO USE IT
+ claws-mail-compose-insert-files.pl [options]
+ Options:
+ --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
- When you run sylpheed via this script, your '~/.sylpheed' directory
- is deleted and replaced with a symbolic link to either ~/.sylpheed-main'
- or '~/sylpheed-claws', depending on the option you choose.
- (On subsequent usage the symbolic link is deleted and replaced with
- a new symbolic link).
+ Contact: Paul Mangan <paul@claws-mail.org>
+
+* filter_conv_new.pl
+ WHAT IT DOES
+ This perl script provides easy conversion of your filtering rules from
+ sylpheed's new filter system (>= 0.9.99) to the filtering system used in
+ Claws Mail.
+ It reads '~/.sylpheed-2.0/filter.xml' or '~/.sylpheed/filter.xml' and
+ writes '~/[CLAWS CONFIG DIR]/matcherrc'
+
HOW TO USE IT
+ Issue the following command from the 'tools' directory:
+
+ perl filter_conv_new.pl
+
+ That's it, the claws' filtering system is now implemented with your
+ previous rules applied.
+
+ REQUIREMENTS
+ XML::SimpleObject
+
+ Contact: Paul Mangan <paul@claws-mail.org>
- Initial set-up
- Enter the full paths to the executable, including the executable itself,
- example:
+
+* filter_conv.pl
+
+ WHAT IT DOES
+ This perl script provides easy conversion of your filtering rules
+ from sylpheed's old filter system (< 0.9.99) to the filtering system
+ used in Claws Mail.
+ It reads '~/.sylpheed/filterrc' and writes '~/.claws-mail/matcherrc'
- ./sylpheed-switcher --claws-path=/usr/local/bin/sylpheed --main-path=
- /usr/bin/sylpheed
-
- After the initial set-up, use the following:
+ HOW TO USE IT
+ Issue the following command from the 'tools' directory:
+
+ perl filter_conv.pl
+
+ That's it, the new filtering system is now implemented with your
+ previous rules applied.
+
+ Contact: Paul Mangan <paul@claws-mail.org>
- ./sylpheed-switcher --claws (to run sylpheed-claws)
- ./sylpheed-switcher --main (to run sylpheed main)
-
- Additionally you can append --debug to run in debug mode.
- Use --help for more info.
-
- This script uses the File::Path and Getopt::Long modules, if you don't already
- have them installed, you can find them at the CPAN search site
- <http://search.cpan.org>
- Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
+* 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.
-* update-po
+ HOW TO USE IT
+ fix_date.sh <filename> [<filename>..]
+
+ Contact: wwp <wwp@claws-mail.org>
+
+
+* mairix.sh
+
+ WHAT IT DOES
+ It's a wrapper to mairix, a tool that makes indexed searches
+ and shows search results in a virtual folder. Maildir, MH and
+ mbox formats are supported, see:
+ http://www.rpcurnow.force9.co.uk/mairix/
+
+ HOW TO USE IT
+ mairix.sh
+ mairix.sh <mairix rcfile> [<mairix options>..]
+
+ For instance:
+ mairix.sh ~/.mairixrc s:word1,word2
+
+ Contact: wwp <wwp@claws-mail.org>
+
+
+* nautilus2claws-mail.sh
WHAT IT DOES
-
- This script is a message catalog translator's tool, it updates the .po
- files named on the command line.
+ This script will recursively attach a number of selected
+ files/directories from Nautilus to a new blank e-mail.
HOW TO USE IT
+ Copy the script to $HOME/.gnome2/nautilus-scripts, chmod u+x,
+ and restart nautilus (killall -9 nautilus). You will now have
+ a right-click menu item: '/Scripts/nautilus2claws-mail.sh'
+
+ Contact: Reza Pakdel <hrpakdel@cpsc.ucalgary.ca>
- This script needs to be copied to and run from the 'po' directory.
-
- ./update-po lang.po lang2.po ...
- to update one or more <yourlang>.po files from the sourcecode files
- named in POTFILES.in. The old .po file is save in a .po.old file.
+* OOo2claws-mail.pl
- For example, when you want to update fr.po, run ./update-po fr.po,
- then edit fr.po to update your translation.
+ WHAT IT DOES
+ This perl script enables OpenOffice.org to send documents to
+ Claws Mail as attachments.
+
+ HOW TO USE IT
+ OpenOffice.org Version 2.0
+ ----------------------------
+ This script is not needed for OOo version 2, which can work
+ directly with Claws Mail.
+ Go to 'Tools/Options/Internet/E-mail' and enter 'claws-mail'
+ in the box.
+
+ OpenOffice.org Version 1.1.0
+ ----------------------------
+ Start up OpenOffice.org.
+ Go to 'Tools/Options/OpenOffice.org/External Programs'
+ Select either ''Mozilla 1.x (Option 1)', or
+ 'Netscape 6.x - 7.0 (Option 1)' from the 'Program' selection
+ Enter the path to OOo2claws-mail.pl in the 'Path' box
+ or select it by clicking on the '...' button.
+
+ You can then use 'File/Send/Document as email' to launch
+ claws-mail (if not already launched) and open a new compose
+ window with the document attached.
+
+ OpenOffice.org Version 1.0
+ --------------------------
+ Start up OpenOffice.org.
+ Go to 'Tools/Options/OpenOffice.org/External Programs'
+ Enter the path to OOo2claws-mail.pl in the 'Program' box
+ or select it by clicking on the '...' button.
+
+
+ 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
+ utilities to make an effort to display it as text. For example
+ .doc antiword -w 72
+ .txt, .diff, .c, .h,
+ .ic. .ec, .cc, .sh,
+ .sed, .awk cat
+ .html txt2htm or text2html
+ .xls, .sxc, .csv xlscat -L
+ .rtf rtf2text
+ .pdf pdf2text %f -
+ .odt ooo2txt
+ .pl, .pm perltidy -st -se or cat
+ .bz2 bzip2 -d < %f | strings
+
+ HOW TO USE IT
+ Go to /Configuration/Message View/External Programs and enter the
+ path to the script in the "Command for 'Display as text'" box.
+ Now when you right-click an attachment and choose 'Display as text'
+ this script will be invoked.
+
+
+ Contact: H.Merijn Brand <h.m.brand@xs4all.nl>
+
+
+* thunderbird-filters-convertor.pl
+
+ WHAT IT DOES
+ This perl script converts Thunderbird filtering rules into Claws Mail
+ filtering rules. It can be run several times, once for each filter
+ configuration file in Thunderbird.
+
+ HOW TO USE IT
+ The script takes 3 arguments:
+
+ --tbird-file=PATH TO FILE The full path to the file to be converted
+ --mailbox-name=NAME The name of the Claws Mail mailbox
+ --account-name=NAME The name of the account to be used (optional)
+
+ --tbird-file must point to the Thunderbird filter file (msgFilterRules.dat)
+ that you want to convert, it must contain the full path to the file.
+ --mailbox-name should be given the name of your mailbox in Claws Mail, e.g.
+ if the top-level folder is 'Mailbox (MH)' then this option should be
+ 'Mailbox'.
+ --account-name is optional, only needed if you are creating account-specific
+ rules. This is the name of your account in Claws Mail, which should
+ correspond to an account that you had in Thunderbird, e.g. the acount whose
+ rules you are converting.
+
+ This script presumes that your folder hierarchy in Claws Mail matches the
+ one that you had in Thunderbird. If you used the tbird2claws.py script to
+ convert your Thunderbird mailbox, then the folder hierarchy should match.
+
+ If the Claws Mail filtering configuration file (matcherrc) does not exist,
+ the script will create it; if it does exist, the newly converted rules will
+ be appended to it.
+
+ REQUIREMENTS
+ Getopt::Long
+ URI::Escape
+
+ Contact: Paul Mangan <paul@claws-mail.org>
+
+--------------------------------------------------------------------------------
+
+Extra tools
+-----------
+
+* gif2xface.pl
+
+ WHAT IT DOES
+ 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 Claws
+ Mail).
+
+ HOW TO USE IT
+ After obtaining the desired image for your X-Face you should:
+ * scale it to 48x48 pixels (Image->Scale image on Gimp)
+ * down color depth to b/w (Image->Mode->Indexed selecting "Use
+ Black/White palette" and the desired dithering options (prior to
+ indexing doing Image->Colors->Threshold allows you to select the
+ b/w level if you don't want a dithered (dotty) image))
+ * save file as non-interlaced GIF
+ Then do:
+
+ ./gif2xface < filename.gif > filename.xface
+
+ In filename.xface will be the X-Face header ready to use.
+ You can add a custom header in Claws Mail through Configuration->
+ Preferences per account, "Send" tab, check "Add user-defined header"
+ then "Edit..." if you want to add it via the Claws Mail interface, or do
+
+ echo "0:" `cat filename.xface` > ~/.claws-mail/customheaderrc
+
+ if you want to create the custom headers file yourself (Warning: this
+ 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>
+
+
+* update-po
+
+ WHAT IT DOES
+ This script is a message catalog translator's tool, it updates the .po
+ files named on the command line.
+
+ HOW TO USE IT
+ This script needs to be copied to and run from the 'po' directory.
+
+ ./update-po lang.po lang2.po ...
- Author: Wilbert Berendsen <wilbert@oswf.org>
+ to update one or more <yourlang>.po files from the sourcecode files
+ named in POTFILES.in. The old .po file is save in a .po.old file.
------------------------------------------------------------------------
+ For example, when you want to update fr.po, run ./update-po fr.po,
+ then edit fr.po to update your translation.
+ Contact: Wilbert Berendsen <wilbert@oswf.org> or the Claws Mail Team
+--------------------------------------------------------------------------------