tools/README

   1 * eud2gc.py
   2
   3   WHAT IT DOES
   4
   5   This python-script is a quick hack to convert an Eudora (v.3?) addressbook
   6   to vCard (GnomeCard) format.
   7
   8   HOW TO USE IT
   9
  10   You may do whatever you want with it! (Also regarding copying)
  11
  12   However, the script is intended to use like this:
  13
  14                         eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
  15
  16   Be careful not to overwrite your original GnomeCard.gcrd!
  17   (But of course you might want to add the converted stuff to it)
  18
  19   Copyleft some time long ago (around 1999?) by Jeroen Versteeg
  20   (j.m.versteeg@student.utwente.nl)
  21
  22 -----------------------------------------------------------------------
  23
  24 * filter_conv.pl
  25
  26   WHAT IT DOES
  27
  28   This perl script provides easy conversion of your filtering rules
  29   form sylpheed's old filter system to the new filtering system used
  30   in sylpheed-claws. It reads 'filterrc' and outputs 'filteringrc'.
  31
  32   HOW TO USE IT
  33
  34   Issue the following command:
  35
  36         perl filter_conv.pl
  37
  38   That's it, the new filtering system is now implemented with your
  39   previous rules applied.
  40
  41   Any problems, contact Paul <claws@thewildbeast.co.uk>
  42
  43 -----------------------------------------------------------------------
  44
  45 * gif2xface.pl
  46
  47   WHAT IT DOES
  48
  49   This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
  50   into an X-Face graphic suitable for inclusion into custom headers of
  51   Sylpheed. An X-Face allows to quickly identify (or be identified as)
  52   the sender of a mail message in a xface-capable MUA (like sylpheed).
  53
  54   HOW TO USE IT
  55
  56   After obtaining the desired image for your X-Face you should:
  57     * scale it to 48x48 pixels (Image->Scale image on Gimp)
  58     * down color depth to b/w (Image->Mode->Indexed selecting "Use
  59       Black/White palette" and the desired dithering options (prior to
  60       indexing doing Image->Colors->Threshold allows you to select the
  61       b/w level if you don't want a dithered (dotty) image))
  62     * save file as non-interlaced GIF
  63   Then do:
  64
  65       ./gif2xface < filename.gif > filename.xface
  66
  67   In filename.xface will be the X-Face header ready to use.
  68   You can add a custom header in Sylpheed through Configuration->
  69   Preferences per account, "Send" tab, check "Add user-defined header"
  70   then "Edit..." if you want to add it via Sylpheed interface, or do
  71
  72       echo "0:" `cat filename.xface` > ~/.sylpheed/customheaderrc
  73
  74   if you want to create the custom headers file yourself (Warning: this
  75   method is valid only if you don't have any other custom header set or
  76   they will be lost!).
  77
  78   Any problems, contact Ricardo Mones Lastra <mones@aic.uniovi.es>
  79
  80 -----------------------------------------------------------------------
  81
  82 * ldif-to-xml.py
  83
  84   WHAT IT DOES
  85
  86   This python script converts the netscape ldif format address book to
  87   the sylpheed xml format.
  88
  89   HOW TO USE IT
  90
  91   Inside Netscape export your address book to a file.
  92   From the command line, execute:
  93
  94       ./ldif-to-xml.py <path/filename>
  95
  96   In case of trouble, just invoke your python interpreter directly:
  97
  98       python ldif-to-xml.py <path/filename>
  99
 100   Either way a file called addressbook.xml will be generated in the current
 101   directory. This xml file should be merged with or simply placed in the
 102   $HOME/.sylpheed directory.
 103
 104   Any problems, contact Rod Senra <rodrigo.senra@ic.unicamp.br>
 105
 106 -----------------------------------------------------------------------
 107
 108