+Claws Mail - a GTK+ based, lightweight, and fast e-mail client
---------------------------------------------------------------------------------
-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:
- 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
------------------------
-
-* 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:
-
- 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.)
-
- In Kmail's Address book choose '/File/Export List'. This will export
- your Kmail address book data to a *.csv file.
-
- If Claws Mail is running, close it.
-
- 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
-
- 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.
-
- 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.
-
- 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'.
-
- Contact: Paul Mangan <paul@claws-mail.org>
+---------------------------------------------------------------------
+
+ Copyright(C) 1999-2015 Hiroyuki Yamamoto <hiro-y@kcn.ne.jp> and the
+ Claws Mail Team
-* 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:
+ 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/.
- perl mew2claws-mail.pl --mew-addressbook=/path/to/mew/addressbook
+ 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/.
- 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
-
- 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 exit Claws Mail before converting the contact list.
-
- From the command line, execute the following:
-
- outlook2claws-mail.pl fullpathname
-
- For csv files:
- -------------
- You must export Outlook contact list as CSV file, choosing ALL the
- fields available for exporting.
-
- You must exit Claws Mail before converting the contact list.
-
- From the command line, execute the following:
-
- outlook2claws-mail.pl --csv fullpathname
-
- 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>
-
-
-* 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.)
-
- If Claws Mail is running, close it.
-
- Export The Bat! Address Book to CSV file format with all fields
- selected to YES and then start:
-
- 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'.
-
- Contact: Urke MMI <urke@gmx.net>
-
-
-* vcard2xml.py
-
- WHAT IT DOES
- This python script will convert an Evolution vCard 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:
+ 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.
+
- vcard2xml.py source_file [destination_file]
+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.
- 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.
-
- 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
-
- 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.
+ 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.
- Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
+ 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
-* kmail-mailbox2claws-mail.pl
+ Purpose: Browse
+ Definition: Part/Dillo: dillo %p&
+ Details: Browse the selected message part in Dillo.
- 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
-
- WHAT IT DOES
- This python script integrates a Thunderbird folder tree into
- Claws Mail.
-
- 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:
-
- <path>\python2.4 <path>\tbird2claws.py . <path to Claws Mail>\Mail
- Contact: Aleksandar Urosevic aka Urke MMI <urke@gmx.net>
+ [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.
---------------------------------------------------------------------------------
-
-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.
-
- Contact: Paul Mangan <paul@claws-mail.org>
-
-* claws-mail-compose-insert-files.pl
-
- 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.
-
- 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
-
- --attach and --insert can be used multiple times
-
- 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>
-
-
-* 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'
-
- 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.
+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
- Contact: Paul Mangan <paul@claws-mail.org>
+ This interface can also be used to install new themes.
-* 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.
-
- 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
+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
- WHAT IT DOES
- 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>
-
-
-* OOo2claws-mail.pl
-
- 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 ...
-
- 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.
+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.
- Contact: Wilbert Berendsen <wilbert@oswf.org> or the Claws Mail Team
+ 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/
---------------------------------------------------------------------------------
projects / claws.git / blobdiff