2 --------------------------------------------------------------------------------
3 Contents of the tools directory:
4 --------------------------------------------------------------------------------
7 freshmeat_search.pl Search freshmeat.net for selected text
8 gpg-sign-syl Clear-sign current selection
9 google_msgid.pl Search groups.google.com for selected message-id
10 google_search.pl Search google.com for selected text
11 multiwebsearch.pl Search any search engine for the selected 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
22 calypso_convert.pl Import mbox files with attachments from Calypso
25 filter_conv.pl Convert old-style filters to new filtering
26 newscache_clean.pl Clean up news directory
27 OOo2sylpheed.pl Send documents from OpenOffice.org
28 sylpheed-switcher Run either sylpheed or claws (separate configs)
29 sylprint.pl Printing engine, explained in README.sylprint
30 update-po Update the .po files named on the command line.
33 gif2xface.pl Convert a 48x48 GIF file to an X-Face header
34 launch_phoenix Open URLs in Phoenix
36 --------------------------------------------------------------------------------
37 Detailed Descriptions:
38 --------------------------------------------------------------------------------
45 COMMAND: |freshmeat_search.pl
46 Search freshmeat.net for selected text using the default Sylpheed browser
50 COMMAND: |google_msgid.pl
51 Lookup selected message-id in google using mozilla. Edit the script to use
56 COMMAND: |google_search.pl
57 Search google.com for selected text using the default Sylpheed browser
60 WORKS ON: selection, whole message
61 COMMAND: |gpg-sign-syl|
62 Clear-sign current selection using gpg.
66 see further down for details
69 WORKS ON: current message (or part of multipart message)
71 Decode and display uuencoded images using uudecode.
73 * More action examples can be found at
74 http://melvin.hadasht.free.fr/home/sylpheed/actions/
76 ** multiwebsearch.pl **
79 This is an Actions script that allows you to search
80 websites for the selected text. It uses the default
81 Sylpheed browser as configured through Sylpheed's
82 GUI and specified in ~/.sylpheed/sylpheedrc, and a
83 configuration file called multiwebsearch.conf.
86 The configuration file takes the following format:
88 ALIAS|URL PART|URL PART
90 ALIAS is a user-defined name; the first URL PART is the
91 url before the search term; the second URL PART is
92 optional and contains the remaining part of the url which
93 comes after the search term. A sample configuration file
97 Copy 'multiwebsearch.conf' to ~/.sylpheed/
100 a) pre-configured website
101 Command: multiwebsearch.pl --where="google" --what="%s"
103 Command: multiwebsearch.pl --where="%u" --what="%s"
105 In type a) "google" refers to one of the configured aliases,
106 this Action will always search the website referred to by
109 In type b) you will be presented with a dialog box into
110 which you type one of your configured aliases
113 Contact: Paul Mangan <claws@thewildbeast.co.uk>
114 --------------------------------------------------------------------------------
116 Address book conversion
117 -----------------------
122 This python-script is a quick hack to convert an Eudora (v.3?)
123 addressbook to vCard (GnomeCard) format.
126 You may do whatever you want with it! (Also regarding copying)
127 However, the script is intended to use like this:
129 eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
131 Be careful not to overwrite your original GnomeCard.gcrd!
132 (But of course you might want to add the converted stuff to it)
134 Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
139 This perl script will convert an exported Kmail addressbook into a
140 Sylpheed addressbook. If your version of Kmail is 1.37 or greater
141 and/or your version of KAddressBook is 3.1beta1 or greater, or
142 this script mixes up your definitions and their related data, use
143 'kmail2sylpheed_v2.pl' instead.
146 (You must run sylpheed at least once before running this script.)
148 In Kmail's Address book choose '/File/Export List'. This will export
149 your Kmail address book data to a *.csv file.
151 If Sylpheed is running, close it.
153 From the command line, execute the following:
155 perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
157 Your Kmail address book data will now be contained in Sylpheed's
158 address book, under the name 'Kmail Address Book'.
160 Contact: Paul Mangan <claws@thewildbeast.co.uk>
163 * kmail2sylpheed_v2.pl
165 This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
168 This perl script will convert a Kmail address book that has been
169 exported in csv format into a Sylpheed address book.
172 (You must run sylpheed at least once before running this script.)
174 Open Kmail's Addressbook, /File/Address Book
175 In Kmail's Addressbook choose '/File/Export/Export List...'. This
176 will allow you to export your Kmail addressbook data to a *.csv file.
178 If Sylpheed is running, close it.
180 From the command line, execute the following:
182 perl kmail2sylpheed_v2.pl --kmailfile=/path/to/addressbook.csv
184 You can also use --help to see usage instructions.
186 Your Kmail addressbook data will now be contained in Sylpheed's
187 addressbook, under the name 'Kmail address book'.
189 Contact: Paul Mangan <claws@thewildbeast.co.uk>
192 * outlook2sylpheed.pl
195 This perl script converts an Outlook generated contact list into a
196 Sylpheed XML address book.
199 You must export Outlook Express contact list as TXT file, choosing
200 only "Name" and "Address" fields to export.
202 You must exit Sylpheed before converting the contact list.
204 From the command line, execute the following:
206 outlook2sylpheed.pl fullpathname
209 Only works with fields described above. If you have more complex
210 examples send them to me, and I'll try to enhance the script.
212 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
218 This perl script will convert an address book exported from The Bat!
219 into a Sylpheed address book.
222 (You must run sylpheed at least once before running this script.)
224 If Sylpheed is running, close it.
226 Export The Bat! Address Book to CSV file format with all fields
227 selected to YES and then start:
229 tb2sylpheed --tbfile=/full/path/to/thebat/addressbook.csv
231 The Bat! addressbook data will now be contained in Sylpheed's
232 addressbook, under the name 'The Bat! Address Book'.
234 Contact: Urke MMI <urke@gmx.net>
236 --------------------------------------------------------------------------------
244 This perl script imports mbox files that are exported by Calypso.
245 It recreates the folder structure by scanning the "X-CalypsoFolder"
246 header and reincludes the attachments referenced in the
247 "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
250 Export the Calypso mailbox by selecting "Save to archive" and check
251 the "Save attachments" box.
253 Edit the script to set following variables (at the top of the file):
254 $mboxdir : path to the exported mbox, e.g. 'Archive' or '.'
255 $mboxfile : name of exported mbox, e.g. 'mail.txt'
256 $outdir : name of the MH folder to create, e.g. 'Calypso'
260 perl calypso_convert.pl
262 Finally, import that folder by either selecting "New mailbox" or
263 moving it into your existing directory and recreate the folder
264 structure manually (contentmenu from folderview).
266 Contact: Thorsten Maerz <torte@netztorte.de>
268 --------------------------------------------------------------------------------
276 This perl script provides easy conversion of your filtering rules
277 form sylpheed's old filter system to the new filtering system used
278 in sylpheed-claws. It reads '~/.sylpheed/filterrc' and outputs
279 '~/.sylpheed/matcherrc'.
282 Issue the following command from the 'tools' directory:
286 That's it, the new filtering system is now implemented with your
287 previous rules applied.
289 Contact: Paul Mangan <claws@thewildbeast.co.uk>
294 WHAT IT DOES AND WHY IT DOES IT
295 This perl script cleans up in '$HOME/.sylpheed/newscache'. Currently
296 the newscache becomes littered with old directories and files - when
297 you subscribe to a newsgroup a sub-directory gets created for it in
298 ~/.sylpheed/newscache/[nntpserver], should you unsubscribe from the
299 group the sub-directory does not get deleted. Until this is done
300 internally this script will take care of some tidying up.
302 This script removes directory trees of nntp servers that you no longer
303 have an account for. Where an account exists it removes directories
304 and files of those groups to which you are no longer subscribed.
307 Issue the following command from the 'tools' directory:
309 perl newscache_clean.pl
311 This script uses the File::Path module, if you don't already have it
312 installed, you can find it at the CPAN search site
313 <http://search.cpan.org>
315 Contact: Paul Mangan <claws@thewildbeast.co.uk>
321 This perl script enables OpenOffice.org to send documents to sylpheed
325 Start up OpenOffice.org.
326 Go to 'Tools/Options/OpenOffice.org/External Programs'
327 Enter the path to OOo2sylpheed.pl in the 'Program' box
328 or select it by clicking on the '...' button.
330 You can then use 'File/Send/Document as email' to launch sylpheed
331 (if not already launched) and open a new compose window with the
334 Tested with OpenOffice.org version 1.0
336 Contact: Paul Mangan <claws@thewildbeast.co.uk>
342 This perl script is for users who like to move between the main
343 sylpheed branch and the claws branch. Because of some differences
344 between the stored options it is better IMO to use two separate
345 '.sylpheed' directory trees. Doing that manually could prove to
346 be tiresome, and so I've written this script to automate the task.
348 The first time you run this script you enter the full paths,
349 including the executable itself, to both the main version of
350 sylpheed and the claws version. This information is then stored
351 in a file in your $HOME directory called '.sylpheed-switcher'
353 During this initial set-up, your '~/.sylpheed' directory
354 is copied to '~/.sylpheed-main' and '~/.sylpheed-claws'.
356 When you run sylpheed via this script, your '~/.sylpheed' directory
357 is deleted and replaced with a symbolic link to either
358 ~/.sylpheed-main' or '~/sylpheed-claws', depending on the option you
359 choose. (On subsequent usage the symbolic link is deleted and replaced
360 with a new symbolic link).
364 Enter the full paths to the executable, including the executable itself,
367 ./sylpheed-switcher --claws-path=/usr/local/bin/sylpheed
368 --main-path=/usr/bin/sylpheed
370 After the initial set-up, use the following:
372 ./sylpheed-switcher --claws (to run sylpheed-claws)
373 ./sylpheed-switcher --main (to run sylpheed main)
375 Additionally you can append --debug to run in debug mode.
376 Use --help for more info.
378 This script uses the File::Path and Getopt::Long modules, if you don't
379 already have them installed, you can find them at the CPAN search site
380 <http://search.cpan.org>
382 Contact: Paul Mangan <claws@thewildbeast.co.uk>
388 This script is a message catalog translator's tool, it updates the .po
389 files named on the command line.
392 This script needs to be copied to and run from the 'po' directory.
394 ./update-po lang.po lang2.po ...
396 to update one or more <yourlang>.po files from the sourcecode files
397 named in POTFILES.in. The old .po file is save in a .po.old file.
399 For example, when you want to update fr.po, run ./update-po fr.po,
400 then edit fr.po to update your translation.
402 Contact: Wilbert Berendsen <wilbert@oswf.org>
404 --------------------------------------------------------------------------------
412 This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
413 into an X-Face graphic suitable for inclusion into custom headers of
414 Sylpheed. An X-Face allows to quickly identify (or be identified as)
415 the sender of a mail message in a xface-capable MUA (like sylpheed).
418 After obtaining the desired image for your X-Face you should:
419 * scale it to 48x48 pixels (Image->Scale image on Gimp)
420 * down color depth to b/w (Image->Mode->Indexed selecting "Use
421 Black/White palette" and the desired dithering options (prior to
422 indexing doing Image->Colors->Threshold allows you to select the
423 b/w level if you don't want a dithered (dotty) image))
424 * save file as non-interlaced GIF
427 ./gif2xface < filename.gif > filename.xface
429 In filename.xface will be the X-Face header ready to use.
430 You can add a custom header in Sylpheed through Configuration->
431 Preferences per account, "Send" tab, check "Add user-defined header"
432 then "Edit..." if you want to add it via Sylpheed interface, or do
434 echo "0:" `cat filename.xface` > ~/.sylpheed/customheaderrc
436 if you want to create the custom headers file yourself (Warning: this
437 method is valid only if you don't have any other custom header set or
440 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
446 Check for a running phoenix process and and open a new tab with a
447 given URL, or execute phoenix with that URL
450 In Common Preferences move to the 'Other' tab and enter the
451 following in the 'Web browser' box
455 Contact: Mohammed Sameer <Uniball@linux-egypt.org>
458 --------------------------------------------------------------------------------