2 --------------------------------------------------------------------------------
3 Contents of the tools directory:
4 --------------------------------------------------------------------------------
7 gpg-sign-syl Clear-sign current selection
8 google_msgid.pl Lookup selected message-id in google
9 uudec Decode and display uuencoded images
11 Addressbook conversion:
12 eud2gc.py Convert Eudora address book to Gnomecard
13 kmail2sylpheed.pl Import a Kmail address book (KDE2)
14 kmail2sylpheed_v2.pl Import a Kmail address book (KDE3)
15 outlook2sylpheed.pl Import an Outlook generated contact list
16 tb2sylpheed Import The Bat! address books
19 calypso_convert.pl Import mbox files with attachments from Calypso
22 filter_conv.pl Convert old-style filters to new filtering
23 newscache_clean.pl Clean up news directory
24 OOo2sylpheed.pl Send documents from OpenOffice.org
25 sylpheed-switcher Run either sylpheed or claws (separate configs)
26 sylprint.pl Printing engine, explained in README.sylprint
27 update-po Update the .po files named on the command line.
30 gif2xface.pl Convert a 48x48 GIF file to an X-Face header
31 launch_phoenix Open URLs in Phoenix
33 --------------------------------------------------------------------------------
34 Detailed Descriptions:
35 --------------------------------------------------------------------------------
41 WORKS ON: selection, whole message
42 COMMAND: |gpg-sign-syl|
43 Clear-sign current selection using gpg.
47 COMMAND: |google_msgid.pl
48 Lookup selected message-id in google using mozilla. Edit the script to use
52 WORKS ON: current message (or part of multipart message)
54 Decode and display uuencoded images using uudecode.
56 * More action examples can be found at
57 http://melvin.hadasht.free.fr/home/sylpheed/actions/
59 --------------------------------------------------------------------------------
61 Address book conversion
62 -----------------------
67 This python-script is a quick hack to convert an Eudora (v.3?)
68 addressbook to vCard (GnomeCard) format.
71 You may do whatever you want with it! (Also regarding copying)
72 However, the script is intended to use like this:
74 eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
76 Be careful not to overwrite your original GnomeCard.gcrd!
77 (But of course you might want to add the converted stuff to it)
79 Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
84 This perl script will convert an exported Kmail addressbook into a
85 Sylpheed addressbook. If your version of Kmail is 1.37 or greater
86 and/or your version of KAddressBook is 3.1beta1 or greater, or
87 this script mixes up your definitions and their related data, use
88 'kmail2sylpheed_v2.pl' instead.
91 (You must run sylpheed at least once before running this script.)
93 In Kmail's Address book choose '/File/Export List'. This will export
94 your Kmail address book data to a *.csv file.
96 If Sylpheed is running, close it.
98 From the command line, execute the following:
100 perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
102 Your Kmail address book data will now be contained in Sylpheed's
103 address book, under the name 'Kmail Address Book'.
105 Contact: Paul Mangan <claws@thewildbeast.co.uk>
108 * kmail2sylpheed_v2.pl
110 This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
113 This perl script will convert a Kmail address book that has been
114 exported in csv format into a Sylpheed address book.
117 (You must run sylpheed at least once before running this script.)
119 Open Kmail's Addressbook, /File/Address Book
120 In Kmail's Addressbook choose '/File/Export/Export List...'. This
121 will allow you to export your Kmail addressbook data to a *.csv file.
123 If Sylpheed is running, close it.
125 From the command line, execute the following:
127 perl kmail2sylpheed_v2.pl --kmailfile=/path/to/addressbook.csv
129 You can also use --help to see usage instructions.
131 Your Kmail addressbook data will now be contained in Sylpheed's
132 addressbook, under the name 'Kmail address book'.
134 Contact: Paul Mangan <claws@thewildbeast.co.uk>
137 * outlook2sylpheed.pl
140 This perl script converts an Outlook generated contact list into a
141 Sylpheed XML address book.
144 You must export Outlook Express contact list as TXT file, choosing
145 only "Name" and "Address" fields to export.
147 You must exit Sylpheed before converting the contact list.
149 From the command line, execute the following:
151 outlook2sylpheed.pl fullpathname
154 Only works with fields described above. If you have more complex
155 examples send them to me, and I'll try to enhance the script.
157 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
163 This perl script will convert an address book exported from The Bat!
164 into a Sylpheed address book.
167 (You must run sylpheed at least once before running this script.)
169 If Sylpheed is running, close it.
171 Export The Bat! Address Book to CSV file format with all fields
172 selected to YES and then start:
174 tb2sylpheed --tbfile=/full/path/to/thebat/addressbook.csv
176 The Bat! addressbook data will now be contained in Sylpheed's
177 addressbook, under the name 'The Bat! Address Book'.
179 Contact: Urke MMI <urke@gmx.net>
181 --------------------------------------------------------------------------------
189 This perl script imports mbox files that are exported by Calypso.
190 It recreates the folder structure by scanning the "X-CalypsoFolder"
191 header and reincludes the attachments referenced in the
192 "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
195 Export the Calypso mailbox by selecting "Save to archive" and check
196 the "Save attachments" box.
198 Edit the script to set following variables (at the top of the file):
199 $mboxdir : path to the exported mbox, e.g. 'Archive' or '.'
200 $mboxfile : name of exported mbox, e.g. 'mail.txt'
201 $outdir : name of the MH folder to create, e.g. 'Calypso'
205 perl calypso_convert.pl
207 Finally, import that folder by either selecting "New mailbox" or
208 moving it into your existing directory and recreate the folder
209 structure manually (contentmenu from folderview).
211 Contact: Thorsten Maerz <torte@netztorte.de>
213 --------------------------------------------------------------------------------
221 This perl script provides easy conversion of your filtering rules
222 form sylpheed's old filter system to the new filtering system used
223 in sylpheed-claws. It reads '~/.sylpheed/filterrc' and outputs
224 '~/.sylpheed/matcherrc'.
227 Issue the following command from the 'tools' directory:
231 That's it, the new filtering system is now implemented with your
232 previous rules applied.
234 Contact: Paul Mangan <claws@thewildbeast.co.uk>
239 WHAT IT DOES AND WHY IT DOES IT
240 This perl script cleans up in '$HOME/.sylpheed/newscache'. Currently
241 the newscache becomes littered with old directories and files - when
242 you subscribe to a newsgroup a sub-directory gets created for it in
243 ~/.sylpheed/newscache/[nntpserver], should you unsubscribe from the
244 group the sub-directory does not get deleted. Until this is done
245 internally this script will take care of some tidying up.
247 This script removes directory trees of nntp servers that you no longer
248 have an account for. Where an account exists it removes directories
249 and files of those groups to which you are no longer subscribed.
252 Issue the following command from the 'tools' directory:
254 perl newscache_clean.pl
256 This script uses the File::Path module, if you don't already have it
257 installed, you can find it at the CPAN search site
258 <http://search.cpan.org>
260 Contact: Paul Mangan <claws@thewildbeast.co.uk>
266 This perl script enables OpenOffice.org to send documents to sylpheed
270 Start up OpenOffice.org.
271 Go to 'Tools/Options/OpenOffice.org/External Programs'
272 Enter the path to OOo2sylpheed.pl in the 'Program' box
273 or select it by clicking on the '...' button.
275 You can then use 'File/Send/Document as email' to launch sylpheed
276 (if not already launched) and open a new compose window with the
279 Tested with OpenOffice.org version 1.0
281 Contact: Paul Mangan <claws@thewildbeast.co.uk>
287 This perl script is for users who like to move between the main
288 sylpheed branch and the claws branch. Because of some differences
289 between the stored options it is better IMO to use two separate
290 '.sylpheed' directory trees. Doing that manually could prove to
291 be tiresome, and so I've written this script to automate the task.
293 The first time you run this script you enter the full paths,
294 including the executable itself, to both the main version of
295 sylpheed and the claws version. This information is then stored
296 in a file in your $HOME directory called '.sylpheed-switcher'
298 During this initial set-up, your '~/.sylpheed' directory
299 is copied to '~/.sylpheed-main' and '~/.sylpheed-claws'.
301 When you run sylpheed via this script, your '~/.sylpheed' directory
302 is deleted and replaced with a symbolic link to either
303 ~/.sylpheed-main' or '~/sylpheed-claws', depending on the option you
304 choose. (On subsequent usage the symbolic link is deleted and replaced
305 with a new symbolic link).
309 Enter the full paths to the executable, including the executable itself,
312 ./sylpheed-switcher --claws-path=/usr/local/bin/sylpheed
313 --main-path=/usr/bin/sylpheed
315 After the initial set-up, use the following:
317 ./sylpheed-switcher --claws (to run sylpheed-claws)
318 ./sylpheed-switcher --main (to run sylpheed main)
320 Additionally you can append --debug to run in debug mode.
321 Use --help for more info.
323 This script uses the File::Path and Getopt::Long modules, if you don't
324 already have them installed, you can find them at the CPAN search site
325 <http://search.cpan.org>
327 Contact: Paul Mangan <claws@thewildbeast.co.uk>
333 This script is a message catalog translator's tool, it updates the .po
334 files named on the command line.
337 This script needs to be copied to and run from the 'po' directory.
339 ./update-po lang.po lang2.po ...
341 to update one or more <yourlang>.po files from the sourcecode files
342 named in POTFILES.in. The old .po file is save in a .po.old file.
344 For example, when you want to update fr.po, run ./update-po fr.po,
345 then edit fr.po to update your translation.
347 Contact: Wilbert Berendsen <wilbert@oswf.org>
349 --------------------------------------------------------------------------------
357 This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
358 into an X-Face graphic suitable for inclusion into custom headers of
359 Sylpheed. An X-Face allows to quickly identify (or be identified as)
360 the sender of a mail message in a xface-capable MUA (like sylpheed).
363 After obtaining the desired image for your X-Face you should:
364 * scale it to 48x48 pixels (Image->Scale image on Gimp)
365 * down color depth to b/w (Image->Mode->Indexed selecting "Use
366 Black/White palette" and the desired dithering options (prior to
367 indexing doing Image->Colors->Threshold allows you to select the
368 b/w level if you don't want a dithered (dotty) image))
369 * save file as non-interlaced GIF
372 ./gif2xface < filename.gif > filename.xface
374 In filename.xface will be the X-Face header ready to use.
375 You can add a custom header in Sylpheed through Configuration->
376 Preferences per account, "Send" tab, check "Add user-defined header"
377 then "Edit..." if you want to add it via Sylpheed interface, or do
379 echo "0:" `cat filename.xface` > ~/.sylpheed/customheaderrc
381 if you want to create the custom headers file yourself (Warning: this
382 method is valid only if you don't have any other custom header set or
385 Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
391 Check for a running phoenix process and and open a new tab with a
392 given URL, or execute phoenix with that URL
395 In Common Preferences move to the 'Other' tab and enter the
396 following in the 'Web browser' box
400 Contact: Mohammed Sameer <Uniball@linux-egypt.org>
403 --------------------------------------------------------------------------------