add outlook2sylpheed script
[claws.git] / tools / README
1 * calypso_convert.pl
2
3   WHAT IT DOES
4
5   This perl script imports mbox files that are exported by Calypso.
6   It recreates the folder structure by scanning the "X-CalypsoFolder"
7   header and reincludes the attachments referenced in the
8   "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
9   
10   HOW TO USE IT
11
12   Export the Calypso mailbox by selecting "Save to archive" and check
13   the "Save attachments" box.
14   Edit the script to set following variables (at the top of the file):
15     $mboxdir  : path to the exported mbox, e.g. 'Archive' or '.'
16     $mboxfile : name of exported mbox, e.g. 'mail.txt'
17     $outdir   : name of the MH folder to create, e.g. 'Calypso'
18   Run the script using
19     perl calypso_convert.pl
20   Finally, import that folder by either selecting "New mailbox" or
21   moving it into your existing directory and recreate the folder
22   structure manually (contentmenu from folderview).
23
24   Any questions, comments or problems, contact Thorsten Maerz <torte@netztorte.de>
25
26 -----------------------------------------------------------------------
27
28 * eud2gc.py
29
30   WHAT IT DOES
31
32   This python-script is a quick hack to convert an Eudora (v.3?) addressbook
33   to vCard (GnomeCard) format.
34
35   HOW TO USE IT
36
37   You may do whatever you want with it! (Also regarding copying)
38
39   However, the script is intended to use like this:
40
41                         eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
42
43   Be careful not to overwrite your original GnomeCard.gcrd!
44   (But of course you might want to add the converted stuff to it)
45
46   Copyleft some time long ago (around 1999?) by Jeroen Versteeg
47   (j.m.versteeg@student.utwente.nl)
48
49 -----------------------------------------------------------------------
50
51 * filter_conv.pl
52
53   WHAT IT DOES
54
55   This perl script provides easy conversion of your filtering rules
56   form sylpheed's old filter system to the new filtering system used
57   in sylpheed-claws. It reads '~/.sylpheed/filterrc' and outputs 
58   '~/.sylpheed/matcherrc'.
59   
60   HOW TO USE IT
61
62   Issue the following command from the 'tools' directory:
63
64         perl filter_conv.pl
65
66   That's it, the new filtering system is now implemented with your
67   previous rules applied.
68
69   Any problems, contact Torsten Schoenfeld <kaffeetisch@web.de>
70
71 -----------------------------------------------------------------------
72
73 * gif2xface.pl
74
75   WHAT IT DOES
76
77   This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
78   into an X-Face graphic suitable for inclusion into custom headers of
79   Sylpheed. An X-Face allows to quickly identify (or be identified as)
80   the sender of a mail message in a xface-capable MUA (like sylpheed).
81
82   HOW TO USE IT
83
84   After obtaining the desired image for your X-Face you should:
85     * scale it to 48x48 pixels (Image->Scale image on Gimp)
86     * down color depth to b/w (Image->Mode->Indexed selecting "Use
87       Black/White palette" and the desired dithering options (prior to
88       indexing doing Image->Colors->Threshold allows you to select the
89       b/w level if you don't want a dithered (dotty) image))
90     * save file as non-interlaced GIF
91   Then do:
92
93       ./gif2xface < filename.gif > filename.xface
94
95   In filename.xface will be the X-Face header ready to use.
96   You can add a custom header in Sylpheed through Configuration->
97   Preferences per account, "Send" tab, check "Add user-defined header"
98   then "Edit..." if you want to add it via Sylpheed interface, or do
99
100       echo "0:" `cat filename.xface` > ~/.sylpheed/customheaderrc
101
102   if you want to create the custom headers file yourself (Warning: this
103   method is valid only if you don't have any other custom header set or
104   they will be lost!).
105
106   Any problems, contact Ricardo Mones Lastra <mones@aic.uniovi.es>
107
108 -----------------------------------------------------------------------
109
110 * kmail2sylpheed.pl
111
112   WHAT IT DOES
113
114   This perl script will convert an exported Kmail addressbook into a
115   Sylpheed addressbook.
116
117   HOW TO USE IT
118
119   (You must run sylpheed at least once before running this script.)
120
121   In Kmail's Addressbook choose '/File/Export List'. This will export
122   your Kmail addressbook data to a *.csv file.
123
124   If Sylpheed is running, close it.
125
126   From the command line, execute the following:
127  
128         perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
129
130   Your Kmail addressbook data will now be contained in Sylpheed's
131   addressbook, under the name 'Kmail Address Book'.
132
133   Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>  
134
135 -----------------------------------------------------------------------
136
137 * ldif-to-xml.py
138
139   WHAT IT DOES
140
141   This python script converts the netscape ldif format address book to
142   the sylpheed xml format.
143
144   HOW TO USE IT
145
146   Inside Netscape export your address book to a file.
147   From the command line, execute:
148
149       ./ldif-to-xml.py <path/filename>
150
151   In case of trouble, just invoke your python interpreter directly:
152
153       python ldif-to-xml.py <path/filename>
154
155   Either way a file called addressbook.xml will be generated in the current
156   directory. This xml file should be merged with or simply placed in the
157   $HOME/.sylpheed directory.
158
159   Any problems, contact Rod Senra <rodrigo.senra@ic.unicamp.br>
160
161 -----------------------------------------------------------------------
162
163 * newscache_clean.pl
164
165   WHAT IT DOES AND WHY IT DOES IT
166
167   This perl script cleans up in '$HOME/.sylpheed/newscache'. Currently
168   the newscache becomes littered with old directories and files - when
169   you subscribe to a newsgroup a sub-directory gets created for it in
170   ~/.sylpheed/newscache/[nntpserver], should you unsubscribe from the 
171   group the sub-directory does not get deleted. Until this is done 
172   internally this script will take care of some tidying up.
173   
174   This script removes directory trees of nntp servers that you no longer
175   have an account for. Where an account exists it removes directories
176   and files of those groups to which you are no longer subscribed.
177
178   HOW TO USE IT
179
180   Issue the following command from the 'tools' directory:
181   
182         perl newscache_clean.pl
183         
184   This script uses the File::Path module, if you don't already have it
185   installed, you can find it at the CPAN search site <http://search.cpan.org>
186
187   Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
188
189 -----------------------------------------------------------------------
190
191 * OOo2sylpheed.pl
192
193   WHAT IT DOES
194   
195   This perl script enables OpenOffice.org to send documents to sylpheed
196   as attachments.
197
198   HOW TO USE IT
199   
200   Start up OpenOffice.org.
201   Go to 'Tools/Options/OpenOffice.org/External Programs'
202   Enter the path to this script in the 'Program' box
203   or select it by clicking on the '...' button.
204
205   You can then use 'File/Send/Document as email' to launch sylpheed
206   (if not already launched) and open a new compose window with the
207   document attached.
208
209   Tested with OpenOffice.org version 1.0
210   Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
211
212 -----------------------------------------------------------------------
213
214 * outlook2sylpheed.pl
215
216   WHAT IT DOES
217   
218   This perl script converts an Outlook generated contact list into a 
219   Sylpheed XML address book.
220
221   HOW TO USE IT
222   
223   You must export Outlook Express contact list as TXT file, choosing
224   only "Name" and "Address" fields to export.
225
226   You must exit Sylpheed before converting the contact list.
227
228   From the command line, execute the following:
229
230         outlook2sylpheed.pl fullpathname
231
232   BUGS
233
234   Only works with fields described above. If you have more complex
235   examples send them to me, and I'll try to enhance the script.
236
237   Any questions, comments or problems, contact 
238   Ricardo Mones Lastra <mones@aic.uniovi.es>
239
240 -----------------------------------------------------------------------
241
242 * sylpheed-switcher
243
244   WHAT IT DOES
245   
246   This perl script is for users who like to move between the main
247   sylpheed branch and the claws branch. Because of some differences
248   between the stored options it is better IMO to use two separate
249   '.sylpheed' directory trees. Doing that manually could prove to
250   be tiresome, and so I've written this script to automate the task.
251
252   The first time you run this script you enter the full paths,
253   including the executable itself, to both the main version of
254   sylpheed and the claws version. This information is then stored
255   in a file in your $HOME directory called '.sylpheed-switcher'
256
257   During this initial set-up, your '~/.sylpheed' directory
258   is copied to '~/.sylpheed-main' and '~/.sylpheed-claws'.
259   
260   When you run sylpheed via this script, your '~/.sylpheed' directory
261   is deleted and replaced with a symbolic link to either ~/.sylpheed-main'
262   or '~/sylpheed-claws', depending on the option you choose.
263   (On subsequent usage the symbolic link is deleted and replaced with
264   a new symbolic link).
265
266   HOW TO USE IT
267   
268   Initial set-up
269   Enter the full paths to the executable, including the executable itself,
270   example:
271   
272         ./sylpheed-switcher --claws-path=/usr/local/bin/sylpheed --main-path=
273         /usr/bin/sylpheed
274         
275   After the initial set-up, use the following:
276   
277         ./sylpheed-switcher --claws     (to run sylpheed-claws)
278         ./sylpheed-switcher --main      (to run sylpheed main)
279         
280   Additionally you can append --debug to run in debug mode.
281   Use --help for more info.     
282  
283   This script uses the File::Path and Getopt::Long modules, if you don't already 
284   have them installed, you can find them at the CPAN search site 
285   <http://search.cpan.org>
286
287   Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
288
289 -----------------------------------------------------------------------
290
291 * update-po
292
293   WHAT IT DOES
294   
295   This script is a message catalog translator's tool, it updates the .po 
296   files named on the command line.
297
298   HOW TO USE IT
299
300   This script needs to be copied to and run from the 'po' directory.
301   
302         ./update-po lang.po lang2.po ...
303
304   to update one or more <yourlang>.po files from the sourcecode files
305   named in POTFILES.in. The old .po file is save in a .po.old file.
306
307   For example, when you want to update fr.po, run ./update-po fr.po, 
308   then edit fr.po to update your translation.
309
310   Author: Wilbert Berendsen <wilbert@oswf.org>
311
312 -----------------------------------------------------------------------
313
314