2 --------------------------------------------------------------------------------
3 Contents of the tools directory:
4 --------------------------------------------------------------------------------
7 freshmeat_search.pl Search freshmeat.net for selected text
8 google_msgid.pl Search groups.google.com for selected message-id
9 google_search.pl Search google.com for selected text
10 multiwebsearch.pl Search any search engine for the selected text
11 textviewer.sh Attempt to view an attachment as plain text
12 uudec Decode and display uuencoded images
14 Addressbook conversion:
15 eud2gc.py Convert Eudora address book to Gnomecard
16 kmail2sylpheed.pl Import a Kmail address book (KDE2)
17 kmail2sylpheed_v2.pl Import a Kmail address book (KDE3)
18 outlook2sylpheed.pl Import an Outlook generated contact list
19 tb2sylpheed Import The Bat! address books
20 vcard2xml.py Import an Evolution vCard
23 calypso_convert.pl Import mbox files with attachments from Calypso
24 convert_mbox.pl Import mbox files
25 maildir2sylpheed.pl Convert a maildir mailbox to MH format
28 acroread2sylpheed.pl Send PDFs from Adobe Reader 7
29 filter_conv.pl Convert old-style filters to new filtering
30 nautilus2sylpheed.sh Send files from Nautilus
31 OOo2sylpheed.pl Send documents from OpenOffice.org
32 sylprint.pl Printing engine, explained in README.sylprint
33 update-po Update the .po files named on the command line.
36 gif2xface.pl Convert a 48x48 GIF file to an X-Face header
38 --------------------------------------------------------------------------------
39 Detailed Descriptions:
40 --------------------------------------------------------------------------------
47 COMMAND: |freshmeat_search.pl
48 Search freshmeat.net for selected text using the default Sylpheed-Claws browser
52 COMMAND: |google_msgid.pl
53 Lookup selected message-id in google using mozilla. Edit the script to use
58 COMMAND: |google_search.pl
59 Search google.com for selected text using the default Sylpheed-Claws browser
63 see further down for details
66 WORKS ON: current message (or part of multipart message)
68 Decode and display uuencoded images using uudecode.
71 WORKS ON: current message part
72 COMMAND: textviewer.sh %p |
73 Attempt to view an attachment as plain text
75 * More action examples can be found at
76 http://melvin.hadasht.free.fr/home/sylpheed/actions/
78 ** multiwebsearch.pl **
81 This is an Actions script that allows you to search
82 websites for the selected text. It uses the default
83 Sylpheed-Claws browser as configured through Sylpheed
84 -Claws' GUI and specified in ~/.sylpheed-claws/sylpheedrc,
85 and a configuration file called multiwebsearch.conf.
88 The configuration file takes the following format:
90 ALIAS|URL PART|URL PART
92 ALIAS is a user-defined name; the first URL PART is the
93 url before the search term; the second URL PART is
94 optional and contains the remaining part of the url which
95 comes after the search term. A sample configuration file
99 Copy 'multiwebsearch.conf' to ~/.sylpheed-claws/
102 a) pre-configured website
103 Command: multiwebsearch.pl --where="google" --what="%s"
105 Command: multiwebsearch.pl --where="%u" --what="%s"
107 In type a) "google" refers to one of the configured aliases,
108 this Action will always search the website referred to by
111 In type b) you will be presented with a dialog box into
112 which you type one of your configured aliases
115 Contact: Paul Mangan <claws@thewildbeast.co.uk>
116 --------------------------------------------------------------------------------
118 Address book conversion
119 -----------------------
124 This python-script is a quick hack to convert an Eudora (v.3?)
125 addressbook to vCard (GnomeCard) format.
128 You may do whatever you want with it! (Also regarding copying)
129 However, the script is intended to use like this:
131 eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
133 Be careful not to overwrite your original GnomeCard.gcrd!
134 (But of course you might want to add the converted stuff to it)
136 Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
141 This perl script will convert an exported Kmail addressbook into a
142 Sylpheed-Claws addressbook. If your version of Kmail is 1.37 or
143 greater and/or your version of KAddressBook is 3.1beta1 or greater,
144 or this script mixes up your definitions and their related data, use
145 'kmail2sylpheed_v2.pl' instead.
148 (You must run sylpheed-claws at least once before running this script.)
150 In Kmail's Address book choose '/File/Export List'. This will export
151 your Kmail address book data to a *.csv file.
153 If Sylpheed-Claws is running, close it.
155 From the command line, execute the following:
157 perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
159 Your Kmail address book data will now be contained in Sylpheed-Claws'
160 address book, under the name 'Kmail Address Book'.
162 Contact: Paul Mangan <claws@thewildbeast.co.uk>
165 * kmail2sylpheed_v2.pl
167 This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
170 This perl script will convert a Kmail address book that has been
171 exported in csv format into a Sylpheed-Claws address book.
174 (You must run sylpheed-claws at least once before running this script.)
176 Open Kmail's Addressbook, /File/Address Book
177 In Kmail's Addressbook choose '/File/Export/Export List...'. This
178 will allow you to export your Kmail addressbook data to a *.csv file.
180 If Sylpheed-Claws is running, close it.
182 From the command line, execute the following:
184 perl kmail2sylpheed_v2.pl --kmailfile=/path/to/addressbook.csv
186 You can also use --help to see usage instructions.
188 Your Kmail addressbook data will now be contained in Sylpheed-Claws'
189 addressbook, under the name 'Kmail address book'.
191 Contact: Paul Mangan <claws@thewildbeast.co.uk>
194 * outlook2sylpheed.pl
197 This perl script converts an Outlook generated contact list into a
198 Sylpheed-Claws XML address book.
203 You must export Outlook Express contact list as TXT file, choosing
204 only "Name" and "Address" fields to export.
206 You must exit Sylpheed-Claws before converting the contact list.
208 From the command line, execute the following:
210 outlook2sylpheed.pl fullpathname
214 You must export Outlook contact list as CSV file, choosing ALL the
215 fields available for exporting.
217 You must exit Sylpheed-Claws before converting the contact list.
219 From the command line, execute the following:
221 outlook2sylpheed.pl --csv fullpathname
224 For text files only works with fields described above. If you have
225 more complex examples send them to me, and I'll try to enhance the
228 For csv files you must export all fields (but only non empty fields
229 are added to the created Sylpheed-Claws address book) and the number
230 of fields expected is harcoded. Look for the $nboffields variable in
231 the script and change its value if you are sure you exported all
232 fields and script gives the 'unknown csv file format' error.
234 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
240 This perl script will convert an address book exported from The Bat!
241 into a Sylpheed-Claws address book.
244 (You must run sylpheed-claws at least once before running this script.)
246 If Sylpheed-Claws is running, close it.
248 Export The Bat! Address Book to CSV file format with all fields
249 selected to YES and then start:
251 tb2sylpheed --tbfile=/full/path/to/thebat/addressbook.csv
253 The Bat! addressbook data will now be contained in Sylpheed-Claws'
254 addressbook, under the name 'The Bat! Address Book'.
256 Contact: Urke MMI <urke@gmx.net>
262 This python script will convert an Evolution vCard into a Sylpheed-Claws
266 (You must run sylpheed-claws at least once before running this script.)
268 If Sylpheed-Claws is running, close it.
269 From the command line, execute the following:
271 vcard2xml.py source_file [destination_file]
273 When only <source_file> is specified it will overwrite (and
274 create a backup of) the existing addressbook.
275 When both arguments are suplied it will create a new additional
276 addressbook named as <destination_file>.
277 If the script encounters an error it will attempt to roll back
278 the changes and restore the original files.
280 Contact: Bogdan Sumanariu <bsumanariu@one5.ro>
282 --------------------------------------------------------------------------------
290 This perl script imports mbox files that are exported by Calypso.
291 It recreates the folder structure by scanning the "X-CalypsoFolder"
292 header and reincludes the attachments referenced in the
293 "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
296 Export the Calypso mailbox by selecting "Save to archive" and check
297 the "Save attachments" box.
299 Edit the script to set following variables (at the top of the file):
300 $mboxdir : path to the exported mbox, e.g. 'Archive' or '.'
301 $mboxfile : name of exported mbox, e.g. 'mail.txt'
302 $outdir : name of the MH folder to create, e.g. 'Calypso'
306 perl calypso_convert.pl
308 Finally, import that folder by either selecting "New mailbox" or
309 moving it into your existing directory and recreate the folder
310 structure manually (contentmenu from folderview).
312 Contact: Thorsten Maerz <torte@netztorte.de>
317 This perl script converts an mbox directory's contents into
318 Sylpheed-Claws' MH format.
322 Run the script using:
324 perl convert_mbox.pl MBOX MH_DIR
326 Move the outputted MH_DIR and its contents into your Sylpheed-Claws
327 Mail folder; in Sylpheed-Claws right-click the top-level folder and
328 choose 'Rebuild folder tree' from the popup menu.
330 Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
332 * maildir2sylpheed.pl
335 This perl script converts a mailbox in maildir format into
336 Sylpheed-Claws' MH format.
340 Exit Sylpheed-Claws if running.
342 Run the script using:
344 perl maildir2sylpheed.pl --kmaildir=mail_folder_name
346 Start Sylpheed-Claws and right-click the toplevel mailbox, i.e
347 "Mailbox (MH)", and select 'Rebuild folder tree'.
348 You may also need to run '/File/Folder/Check for new messages
350 Your maildir directory will be backed-up.
354 --dry-run test mode, nothing is actually written
355 --help brief usage info
357 Contact: Paul Mangan <claws@thewildbeast.co.uk>
358 --------------------------------------------------------------------------------
363 * acroread2sylpheed.pl
366 This perl script enables Adobe Reader 7 to send documents to
367 Sylpheed-Claws as attachments.
370 Make sure that the script is executable (chmod +x acroread2sylpheed.pl)
371 Start up Adobe Reader 7 (acroread)
372 Go to /Edit/Preferences/SendMail
373 Select any email client except 'System Mail (mail)'
374 Enter the path to this script in the alternate location box
376 You can then use 'File/Email' or the Email toolbar button to launch
377 sylpheed-claws (if not already launched) and open a new compose window
378 with the PDF attached.
380 Contact: Paul Mangan <claws@thewildbeast.co.uk>
386 This perl script provides easy conversion of your filtering rules
387 form sylpheed's old filter system (pre version 0.9.99) to the new
388 filtering system used in sylpheed-claws.
389 It reads '~/.sylpheed/filterrc' and outputs '~/.sylpheed-claws/matcherrc'.
392 Issue the following command from the 'tools' directory:
396 That's it, the new filtering system is now implemented with your
397 previous rules applied.
399 Contact: Paul Mangan <claws@thewildbeast.co.uk>
402 * nautilus2sylpheed.sh
405 This script will recursively attach a number of selected
406 files/directories from Nautilus to a new blank e-mail.
409 Copy the script to $HOME/.gnome2/nautilus-scripts, chmod u+x,
410 and restart nautilus (killall -9 nautilus). You will now have
411 a right-click menu item: '/Scripts/nautilus2sylpheed.sh'
413 Contact: Reza Pakdel <hrpakdel@cpsc.ucalgary.ca>
419 This perl script enables OpenOffice.org to send documents to
420 Sylpheed-Claws as attachments.
423 OpenOffice.org Version 1.0
424 --------------------------
425 Start up OpenOffice.org.
426 Go to 'Tools/Options/OpenOffice.org/External Programs'
427 Enter the path to OOo2sylpheed.pl in the 'Program' box
428 or select it by clicking on the '...' button.
430 OpenOffice.org Version 1.1.0
431 ----------------------------
432 Start up OpenOffice.org.
433 Go to 'Tools/Options/OpenOffice.org/External Programs'
434 Select either ''Mozilla 1.x (Option 1)', or
435 'Netscape 6.x - 7.0 (Option 1)' from the 'Program' selection
436 Enter the path to OOo2sylpheed.pl in the 'Path' box
437 or select it by clicking on the '...' button.
439 You can then use 'File/Send/Document as email' to launch
440 sylpheed-claws (if not already launched) and open a new compose
441 window with the document attached.
443 Tested with OpenOffice.org versions 1.0, 1.1.0
445 Contact: Paul Mangan <claws@thewildbeast.co.uk>
451 This script is a message catalog translator's tool, it updates the .po
452 files named on the command line.
455 This script needs to be copied to and run from the 'po' directory.
457 ./update-po lang.po lang2.po ...
459 to update one or more <yourlang>.po files from the sourcecode files
460 named in POTFILES.in. The old .po file is save in a .po.old file.
462 For example, when you want to update fr.po, run ./update-po fr.po,
463 then edit fr.po to update your translation.
465 Contact: Wilbert Berendsen <wilbert@oswf.org>
467 --------------------------------------------------------------------------------
475 This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
476 into an X-Face graphic suitable for inclusion into custom headers of
477 Sylpheed-Claws. An X-Face allows to quickly identify (or be identified
478 as) the sender of a mail message in a xface-capable MUA (like sylpheed
482 After obtaining the desired image for your X-Face you should:
483 * scale it to 48x48 pixels (Image->Scale image on Gimp)
484 * down color depth to b/w (Image->Mode->Indexed selecting "Use
485 Black/White palette" and the desired dithering options (prior to
486 indexing doing Image->Colors->Threshold allows you to select the
487 b/w level if you don't want a dithered (dotty) image))
488 * save file as non-interlaced GIF
491 ./gif2xface < filename.gif > filename.xface
493 In filename.xface will be the X-Face header ready to use.
494 You can add a custom header in Sylpheed-Claws through Configuration->
495 Preferences per account, "Send" tab, check "Add user-defined header"
496 then "Edit..." if you want to add it via Sylpheed -Claws interface, or do
498 echo "0:" `cat filename.xface` > ~/.sylpheed-claws/customheaderrc
500 if you want to create the custom headers file yourself (Warning: this
501 method is valid only if you don't have any other custom header set or
504 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
506 --------------------------------------------------------------------------------