README 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857
  1. --------------------------------------------------------------------------------
  2. Contents of the tools directory:
  3. --------------------------------------------------------------------------------
  4. Action scripts:
  5. cm-reparent.pl Fix thread parenting for two or more messages
  6. cm-break.pl Remove thread parenting for one or more messages
  7. ddg_search.pl Search DuckDuckGo for selected text
  8. google_msgid.pl Search groups.google.com for selected message-id
  9. multiwebsearch.pl Search any search engine for the selected text
  10. textviewer.sh Attempt to view an attachment as plain text
  11. uudec Decode and display uuencoded images
  12. uuooffice Decode uuencoded attachments and open them with
  13. OpenOffice
  14. Addressbook conversion:
  15. csv2addressbook.pl Import Becky, Thunderbird, Kmail, Gmail and Fox
  16. Mail address books
  17. eud2gc.py Convert Eudora address book to Gnomecard
  18. kmail2claws-mail.pl Import a Kmail address book (KDE2)
  19. kmail2claws-mail_v2.pl Import a Kmail address book (KDE3)
  20. mew2claws-mail.pl Import a Mew address book
  21. outlook2claws-mail.pl Import an Outlook generated contact list
  22. tb2claws-mail Import The Bat! address books
  23. vcard2xml.py Import an Evolution vCard
  24. Mailbox conversion:
  25. calypso_convert.pl Import mbox files with attachments from Calypso
  26. convert_mbox.pl Import mbox files
  27. kmail-mailbox2claws-mail.pl Convert a kmail mailbox to a Claws Mail mailbox
  28. tbird2claws.py Integrate a Thunderbird folder tree into Claws
  29. Other tools:
  30. acroread2claws-mail.pl Send PDFs from Adobe Reader 7
  31. claws-mail-compose-insert-files.pl
  32. Insert files into a new Compose window
  33. filter_conv_new.pl Convert new-style Sylpheed filters to filtering
  34. filter_conv.pl Convert old-style Sylpheed filters to filtering
  35. fix_date.sh Replace/Add a message's Date field (coreutils,
  36. dos2unix, grep and sed are required in PATH)
  37. mairix.sh A wrapper to mairix, to enable global searches in
  38. mail folders
  39. nautilus2claws-mail.sh Send files from Nautilus
  40. popfile-link.sh Open messages in POPFile control center to edit
  41. their status
  42. textviewer.pl Display various attachments as text
  43. thunderbird-filters-convertor.pl
  44. Convert Thunderbird filtering rules
  45. Extra tools:
  46. gif2xface.pl Convert a 48x48 GIF file to an X-Face header
  47. update-po Update the .po files named on the command line.
  48. --------------------------------------------------------------------------------
  49. Detailed Descriptions:
  50. --------------------------------------------------------------------------------
  51. Action scripts
  52. --------------
  53. * cm-reparent.pl
  54. WORKS ON: selected messages (two or more)
  55. COMMAND: cm-reparent.pl %F
  56. Thread the selected messages based on date, old to new
  57. * cm-break.pl
  58. WORKS ON: selected messages (one or more)
  59. COMMAND: cm-break.pl %F
  60. Break thread references for the selected messages
  61. * ddg_search.pl
  62. WORKS ON: selection
  63. COMMAND: |ddg_search.pl
  64. Search duckduckgo.com for selected text using the default Claws Mail browser
  65. * google_msgid.pl
  66. WORKS ON: selection
  67. COMMAND: |google_msgid.pl
  68. Lookup selected message-id in google using mozilla. Edit the script to use
  69. different browsers.
  70. * multiwebsearch.pl
  71. WORKS ON: selection
  72. see further down for details
  73. * textviewer.sh
  74. WORKS ON: current message part
  75. COMMAND: textviewer.sh %p |
  76. Attempt to view an attachment as plain text
  77. * uudec
  78. WORKS ON: current message (or part of multipart message)
  79. COMMAND: uudec %f&
  80. Decode and display uuencoded images using uudecode.
  81. * uuooffice
  82. WORKS ON: current message (or part of multipart message)
  83. COMMAND: uuooffice %f&
  84. Decode uuencoded attachments and open them with OpenOffice
  85. * More action examples can be found at the Claws Mail FAQ
  86. http://www.claws-mail.org/faq/index.php/Actions
  87. ** multiwebsearch.pl **
  88. WHAT IT DOES
  89. This is an Actions script that allows you to search
  90. websites for the selected text. It uses the default
  91. Claws Mail browser as configured through Claws Mail's
  92. GUI and specified in ~/.claws-mail/clawsrc, and a
  93. configuration file called multiwebsearch.conf.
  94. CONFIGURATION
  95. The configuration file takes the following format:
  96. ALIAS|URL PART|URL PART
  97. ALIAS is a user-defined name; the first URL PART is the
  98. url before the search term; the second URL PART is
  99. optional and contains the remaining part of the url which
  100. comes after the search term. A sample configuration file
  101. is included.
  102. HOW TO USE IT
  103. Copy 'multiwebsearch.conf' to ~/.claws-mail/
  104. Configure an Action:
  105. a) pre-configured website
  106. Command: multiwebsearch.pl --where="ddg" --what="%s"
  107. b) dynamic
  108. Command: multiwebsearch.pl --where="%u" --what="%s"
  109. In type a) "ddg" refers to one of the configured aliases,
  110. this Action will always search the website referred to by
  111. the alias "ddg".
  112. In type b) you will be presented with a dialog box into
  113. which you type one of your configured aliases
  114. Contact: Paul Mangan <paul@claws-mail.org>
  115. --------------------------------------------------------------------------------
  116. Address book conversion
  117. -----------------------
  118. * csv2addressbook.pl
  119. WHAT IT DOES
  120. This perl script will import a Becky, Thunderbird, Kmail, Gmail and
  121. Fox Mail address book.
  122. HOW TO USE IT
  123. (You must run claws-mail at least once before running this script.)
  124. Becky >= 2.41
  125. -------------
  126. In Becky you need to do a CSV full export with titles of your
  127. address book.
  128. Run the script with the following options:
  129. perl csv2addressbook.pl --type=becky --csv=/full/path/to/file.csv
  130. Addtionally you can use the option '--name="My address book"', if
  131. you don't use this option the new Claws address book will be
  132. called 'Becky address book'.
  133. Thunderbird >= 2.0.0.6
  134. ----------------------
  135. In Thunderbird you need to export your address book as 'comma
  136. separated'.
  137. Run the script with the following options:
  138. perl csv2addressbook.pl --type=thunderbird --csv=/full/path/to/file.csv
  139. Addtionally you can use the option '--name="My address book"', if
  140. you don't use this option the new Claws address book will be
  141. called 'Thunderbird address book'.
  142. Kmail >= 1.9.7 / Kaddressbook >= 3.5.7
  143. --------------------------------------
  144. In Kaddressbook you need to export your address book as 'CSV List'.
  145. Run the script with the following options:
  146. perl csv2addressbook.pl --type=kmail --csv=/full/path/to/file.csv
  147. Addtionally you can use the option '--name="My address book"', if
  148. you don't use this option the new Claws address book will be
  149. called 'Kmail address book'.
  150. WARNING: Kmail/Kaddressbook has a bug whereby it exports badly
  151. formatted CSV if the values are quoted.
  152. Gmail
  153. -----
  154. In the Gmail web interface you need to export your address book
  155. as Outlook CSV format.
  156. Run the script with the following options:
  157. perl csv2addressbook.pl --type=gmail --csv=/full/path/to/file.csv
  158. Addtionally you can use the option '--name="My address book"', if
  159. you don't use this option the new Claws address book will be
  160. called 'gmail address book'.
  161. Fox Mail
  162. --------
  163. Export your Fox Mail address book as CSV with all possible headers.
  164. Run the script with the following options:
  165. perl csv2addressbook.pl --type=foxmail --csv=/full/path/to/file.csv
  166. Addtionally you can use the option '--name="My address book"', if
  167. you don't use this option the new Claws address book will be
  168. called 'foxmail address book'.
  169. You can also run the script with '--help' to get a brief usage message.
  170. Contact: Paul Mangan <paul@claws-mail.org>
  171. * eud2gc.py
  172. WHAT IT DOES
  173. This python-script is a quick hack to convert an Eudora (v.3?)
  174. addressbook to vCard (GnomeCard) format.
  175. HOW TO USE IT
  176. You may do whatever you want with it! (Also regarding copying)
  177. However, the script is intended to use like this:
  178. eud2gc.py <Eudora-addressbook-file> <Gnomecard-file>
  179. Be careful not to overwrite your original GnomeCard.gcrd!
  180. (But of course you might want to add the converted stuff to it)
  181. Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
  182. * kmail2claws-mail.pl
  183. WHAT IT DOES
  184. This perl script will convert an exported Kmail addressbook into a
  185. Claws Mail addressbook. If your version of Kmail is 1.37 or
  186. greater and/or your version of KAddressBook is 3.1beta1 or greater,
  187. or this script mixes up your definitions and their related data, use
  188. 'kmail2claws-mail_v2.pl' instead.
  189. HOW TO USE IT
  190. (You must run claws-mail at least once before running this script.)
  191. In Kmail's Address book choose '/File/Export List'. This will export
  192. your Kmail address book data to a *.csv file.
  193. If Claws Mail is running, close it.
  194. From the command line, execute the following:
  195. perl kmail2claws-mail.pl --kmailfile=/path/to/addressbook.csv
  196. Your Kmail address book data will now be contained in Claws Mail'
  197. address book, under the name 'Kmail Address Book'.
  198. Contact: Paul Mangan <paul@claws-mail.org>
  199. * kmail2claws-mail_v2.pl
  200. This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
  201. WHAT IT DOES
  202. This perl script will convert a Kmail address book that has been
  203. exported in csv format into a Claws Mail address book.
  204. HOW TO USE IT
  205. (You must run claws-mail at least once before running this script.)
  206. Open Kmail's Addressbook, /File/Address Book
  207. In Kmail's Addressbook choose '/File/Export/Export List...'. This
  208. will allow you to export your Kmail addressbook data to a *.csv file.
  209. If Claws Mail is running, close it.
  210. From the command line, execute the following:
  211. perl kmail2claws-mail_v2.pl --kmailfile=/path/to/addressbook.csv
  212. You can also use --help to see usage instructions.
  213. Your Kmail addressbook data will now be contained in Claws Mail'
  214. addressbook, under the name 'Kmail address book'.
  215. Contact: Paul Mangan <paul@claws-mail.org>
  216. * mew2claws-mail.pl
  217. WHAT IT DOES
  218. This perl script will convert a Mew address book into a Claws Mail
  219. address book.
  220. HOW TO USE IT
  221. (You must run claws-mail at least once before running this script.)
  222. If Claws Mail is running, close it.
  223. From the command line, execute the following:
  224. perl mew2claws-mail.pl --mew-addressbook=/path/to/mew/addressbook
  225. You can also use --help to see usage instructions.
  226. Your Mew addressbook data will now be contained in Claws Mail's
  227. addressbook, under the name 'Mew Address Book'.
  228. Contact: Jérôme Lelong <jerome.lelong@gmail.com>
  229. * outlook2claws-mail.pl
  230. WHAT IT DOES
  231. This perl script converts an Outlook generated contact list into a
  232. Claws Mail XML address book.
  233. HOW TO USE IT
  234. For text files:
  235. --------------
  236. You must export Outlook Express contact list as TXT file, choosing
  237. only "Name" and "Address" fields to export.
  238. You must exit Claws Mail before converting the contact list.
  239. From the command line, execute the following:
  240. outlook2claws-mail.pl fullpathname
  241. For csv files:
  242. -------------
  243. You must export Outlook contact list as CSV file, choosing ALL the
  244. fields available for exporting.
  245. You must exit Claws Mail before converting the contact list.
  246. From the command line, execute the following:
  247. outlook2claws-mail.pl --csv fullpathname
  248. LIMITATIONS
  249. For text files only works with fields described above. If you have
  250. more complex examples send them to me, and I'll try to enhance the
  251. script.
  252. For csv files you must export all fields (but only non empty fields
  253. are added to the created Claws Mail address book) and the number
  254. of fields expected is harcoded. Look for the $nboffields variable in
  255. the script and change its value if you are sure you exported all
  256. fields and script gives the 'unknown csv file format' error.
  257. Contact: Ricardo Mones <ricardo@mones.org>
  258. * tb2claws-mail
  259. WHAT IT DOES
  260. This perl script will convert an address book exported from The Bat!
  261. into a Claws Mail address book.
  262. HOW TO USE IT
  263. (You must run claws-mail at least once before running this script.)
  264. If Claws Mail is running, close it.
  265. Export The Bat! Address Book to CSV file format with all fields
  266. selected to YES and then start:
  267. tb2claws-mail --tbfile=/full/path/to/thebat/addressbook.csv
  268. The Bat! addressbook data will now be contained in Claws Mail'
  269. addressbook, under the name 'The Bat! Address Book'.
  270. Contact: Urke MMI <urke@gmx.net>
  271. * vcard2xml.py
  272. WHAT IT DOES
  273. This python script will convert an Evolution vCard into a Claws Mail
  274. address book.
  275. HOW TO USE IT
  276. (You must run claws-mail at least once before running this script.)
  277. If Claws Mail is running, close it.
  278. From the command line, execute the following:
  279. vcard2xml.py source_file [destination_file]
  280. When only <source_file> is specified it will overwrite (and
  281. create a backup of) the existing addressbook.
  282. When both arguments are suplied it will create a new additional
  283. addressbook named as <destination_file>.
  284. If the script encounters an error it will attempt to roll back
  285. the changes and restore the original files.
  286. Contact: Bogdan Sumanariu <bsumanariu@one5.ro>
  287. --------------------------------------------------------------------------------
  288. Mailbox conversion
  289. ------------------
  290. * calypso_convert.pl
  291. WHAT IT DOES
  292. This perl script imports mbox files that are exported by Calypso.
  293. It recreates the folder structure by scanning the "X-CalypsoFolder"
  294. header and reincludes the attachments referenced in the
  295. "X-CalypsoHtmlBody" "X-CalypsoAccount" "X-Attachment" headers.
  296. HOW TO USE IT
  297. Export the Calypso mailbox by selecting "Save to archive" and check
  298. 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'
  303. Run the script using
  304. perl calypso_convert.pl
  305. Finally, import that folder by either selecting "New mailbox" or
  306. moving it into your existing directory and recreate the folder
  307. structure manually (contentmenu from folderview).
  308. Contact: Thorsten Maerz <torte@netztorte.de>
  309. * convert_mbox.pl
  310. WHAT IT DOES
  311. This perl script converts an mbox directory's contents into
  312. Claws Mail' MH format.
  313. HOW TO USE IT
  314. Run the script using:
  315. perl convert_mbox.pl MBOX MH_DIR
  316. Move the outputted MH_DIR and its contents into your Claws Mail
  317. Mail folder; in Claws Mail right-click the top-level folder and
  318. choose 'Rebuild folder tree' from the popup menu.
  319. Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
  320. * kmail-mailbox2claws-mail.pl
  321. WHAT IT DOES
  322. This perl script converts a kmail mailbox into Claws Mail' mailbox.
  323. HOW TO USE IT
  324. Exit Claws Mail if running.
  325. Run the script using:
  326. kmail-mailbox2claws-mail.pl --kmaildir=/full/path/to/kmail/mailbox
  327. Start Claws Mail and right-click the toplevel mailbox, i.e
  328. "Mailbox (MH)", and select 'Rebuild folder tree'.
  329. You may also need to run '/File/Folder/Check for new messages
  330. in all folders'
  331. Additional options:
  332. --debug debug mode
  333. --dry-run test mode, nothing is actually written
  334. --help brief usage info
  335. Contact: Paul Mangan <paul@claws-mail.org>
  336. * tbird2claws.py
  337. WHAT IT DOES
  338. This python script integrates a Thunderbird folder tree into
  339. Claws Mail.
  340. HOW TO USE IT
  341. The script receives two parameters from command-line:
  342. <Thunderbird folder path> <Claws Mail folder path>
  343. The best way to use it is to go to inside your Thunderbird
  344. root mailfolder directory and invoke it as:
  345. <path>\python2.4 <path>\tbird2claws.py . <path to Claws Mail>\Mail
  346. Contact: Aleksandar Urosevic aka Urke MMI <urke@gmx.net>
  347. --------------------------------------------------------------------------------
  348. Other tools
  349. -----------
  350. * acroread2claws-mail.pl
  351. WHAT IT DOES
  352. This perl script enables Adobe Reader 7 to send documents to
  353. Claws Mail as attachments.
  354. HOW TO USE IT
  355. Make sure that the script is executable (chmod +x acroread2claws-mail.pl)
  356. Start up Adobe Reader 7 (acroread)
  357. Go to /Edit/Preferences/SendMail
  358. Select any email client except 'System Mail (mail)'
  359. Enter the path to this script in the alternate location box
  360. You can then use 'File/Email' or the Email toolbar button to launch
  361. claws-mail (if not already launched) and open a new compose window
  362. with the PDF attached.
  363. Contact: Paul Mangan <paul@claws-mail.org>
  364. * claws-mail-compose-insert-files.pl
  365. WHAT IT DOES
  366. This script enables inserting files into the message body of a new
  367. Claws Mail Compose window from the command line. Additionally To,
  368. Cc, Bcc, Subject and files to attach to the message can be specified.
  369. HOW TO USE IT
  370. claws-mail-compose-insert-files.pl [options]
  371. Options:
  372. --help -h
  373. --to "Person One <mail@address.net>"
  374. --cc "Person One <mail@address.net>"
  375. --bcc "Person One <mail@address.net>"
  376. --subject "My subject"
  377. --attach FILE
  378. --insert FILE
  379. For multiple recipients separate the addresses with ','
  380. e.g. --to "Person One <mail@address.net>,Person Two <mail2@address.net>"
  381. --attach and --insert can be used multiple times
  382. Contact: Paul Mangan <paul@claws-mail.org>
  383. * filter_conv_new.pl
  384. WHAT IT DOES
  385. This perl script provides easy conversion of your filtering rules from
  386. sylpheed's new filter system (>= 0.9.99) to the filtering system used in
  387. Claws Mail.
  388. It reads '~/.sylpheed-2.0/filter.xml' or '~/.sylpheed/filter.xml' and
  389. writes '~/[CLAWS CONFIG DIR]/matcherrc'
  390. HOW TO USE IT
  391. Issue the following command from the 'tools' directory:
  392. perl filter_conv_new.pl
  393. That's it, the claws' filtering system is now implemented with your
  394. previous rules applied.
  395. REQUIREMENTS
  396. XML::SimpleObject
  397. Contact: Paul Mangan <paul@claws-mail.org>
  398. * filter_conv.pl
  399. WHAT IT DOES
  400. This perl script provides easy conversion of your filtering rules
  401. from sylpheed's old filter system (< 0.9.99) to the filtering system
  402. used in Claws Mail.
  403. It reads '~/.sylpheed/filterrc' and writes '~/.claws-mail/matcherrc'
  404. HOW TO USE IT
  405. Issue the following command from the 'tools' directory:
  406. perl filter_conv.pl
  407. That's it, the new filtering system is now implemented with your
  408. previous rules applied.
  409. Contact: Paul Mangan <paul@claws-mail.org>
  410. * fix_date.sh
  411. WHAT IT DOES
  412. Add a 'Date:' header to the selected email(s) when such header
  413. is missing. The correct date is guessed from other headers
  414. that contain timestamp information (preferred: Fetchinfo
  415. header if found) or from the file or system date as a
  416. fallback. The order or preference for the date value
  417. replacement can be changed by editing the script.
  418. This script can be used to fix messages that show non
  419. RFC-compliant Date headers as well.
  420. X-Original-Date is always added too if not already existing
  421. (if so, it's left untouched), to keep track of the original
  422. value if any.
  423. An existing Date: header is not overwritten unless you use the
  424. --force switch.
  425. Non RFC-compliant dates can be overwritten using the --rfc
  426. switch. Use --strict to use strict RFC matching patterns for
  427. date values in other headers.
  428. HOW TO USE IT
  429. First you have to create an action with the following command:
  430. fix_date.sh %F
  431. On main window's message list, select the messages to be fixed
  432. and invoke the created action.
  433. Contact: wwp <wwp@claws-mail.org>
  434. * mairix.sh
  435. WHAT IT DOES
  436. It's a wrapper to mairix, a tool that makes indexed searches
  437. and shows search results in a virtual folder. Maildir, MH and
  438. mbox formats are supported, see: https://github.com/rc0/mairix
  439. HOW TO USE IT
  440. mairix.sh
  441. mairix.sh <mairix rcfile> [<mairix options>..]
  442. For instance:
  443. mairix.sh ~/.mairixrc s:word1,word2
  444. Contact: wwp <wwp@claws-mail.org>
  445. * nautilus2claws-mail.sh
  446. WHAT IT DOES
  447. This script will recursively attach a number of selected
  448. files/directories from Nautilus to a new blank e-mail.
  449. HOW TO USE IT
  450. Copy the script to $HOME/.gnome2/nautilus-scripts, chmod u+x,
  451. and restart nautilus (killall -9 nautilus). You will now have
  452. a right-click menu item: '/Scripts/nautilus2claws-mail.sh'
  453. Contact: Reza Pakdel <hrpakdel@cpsc.ucalgary.ca>
  454. * popfile-link.sh
  455. WHAT IT DOES
  456. Open selected messages in POPFile control center to edit their
  457. status. Requires that POPFile is running and that the messages
  458. have been processed by it (X-POPFile-Link: header is expected).
  459. POPFile control center opens with the web browser set in
  460. Claws Mail prefs.
  461. HOW TO USE IT
  462. popfile-link.sh <filename> [<filename>..]
  463. Contact: wwp <wwp@claws-mail.org>
  464. * textviewer.pl
  465. WHAT IT DOES
  466. This script tries to recognise an attachment by using the 'file'
  467. command and/or the file extension and then uses the available
  468. utilities to make an effort to display it as text.
  469. $ textview.pl --list
  470. will show available conversion, the top:
  471. .awk cat
  472. .bin strings
  473. .bz2 bzip2 -d < %f | strings
  474. .c cat
  475. .cc cat
  476. .csv xlscat -L
  477. If there are multiple alternatives available, they are listed in
  478. the ordder they are tried, like for .xls:
  479. .xls xlscat -L
  480. .xls catdoc -x -dutf-8
  481. .xls wvText
  482. HOW TO USE IT
  483. Go to /Configuration/Message View/External Programs and enter the
  484. path to the script in the "Command for 'Display as text'" box.
  485. Now when you right-click an attachment and choose 'Display as text'
  486. this script will be invoked.
  487. xlscat comes with the perl module Spreadsheet::Read, which is a
  488. wrapper module over several parsers and supports ods, sxc, csv, xls,
  489. xlsx, and sq. See https://metacpan.org/release/Spreadsheet-Read
  490. Contact: H.Merijn Brand <h.m.brand@xs4all.nl>
  491. * thunderbird-filters-convertor.pl
  492. WHAT IT DOES
  493. This perl script converts Thunderbird filtering rules into Claws Mail
  494. filtering rules. It can be run several times, once for each filter
  495. configuration file in Thunderbird.
  496. HOW TO USE IT
  497. The script takes 3 arguments:
  498. --tbird-file=PATH TO FILE The full path to the file to be converted
  499. --mailbox-name=NAME The name of the Claws Mail mailbox
  500. --account-name=NAME The name of the account to be used (optional)
  501. --tbird-file must point to the Thunderbird filter file (msgFilterRules.dat)
  502. that you want to convert, it must contain the full path to the file.
  503. --mailbox-name should be given the name of your mailbox in Claws Mail, e.g.
  504. if the top-level folder is 'Mailbox (MH)' then this option should be
  505. 'Mailbox'.
  506. --account-name is optional, only needed if you are creating account-specific
  507. rules. This is the name of your account in Claws Mail, which should
  508. correspond to an account that you had in Thunderbird, e.g. the acount whose
  509. rules you are converting.
  510. This script presumes that your folder hierarchy in Claws Mail matches the
  511. one that you had in Thunderbird. If you used the tbird2claws.py script to
  512. convert your Thunderbird mailbox, then the folder hierarchy should match.
  513. If the Claws Mail filtering configuration file (matcherrc) does not exist,
  514. the script will create it; if it does exist, the newly converted rules will
  515. be appended to it.
  516. REQUIREMENTS
  517. Getopt::Long
  518. URI::Escape
  519. Contact: Paul Mangan <paul@claws-mail.org>
  520. --------------------------------------------------------------------------------
  521. Extra tools
  522. -----------
  523. * gif2xface.pl
  524. WHAT IT DOES
  525. This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
  526. into an X-Face graphic suitable for inclusion into custom headers of
  527. Claws Mail. An X-Face allows to quickly identify (or be identified
  528. as) the sender of a mail message in a xface-capable MUA (like Claws
  529. Mail).
  530. HOW TO USE IT
  531. After obtaining the desired image for your X-Face you should:
  532. * scale it to 48x48 pixels (Image->Scale image on Gimp)
  533. * down color depth to b/w (Image->Mode->Indexed selecting "Use
  534. Black/White palette" and the desired dithering options (prior to
  535. indexing doing Image->Colors->Threshold allows you to select the
  536. b/w level if you don't want a dithered (dotty) image))
  537. * save file as non-interlaced GIF
  538. Then do:
  539. ./gif2xface < filename.gif > filename.xface
  540. In filename.xface will be the X-Face header ready to use.
  541. You can add a custom header in Claws Mail through Configuration->
  542. Preferences per account, "Send" tab, check "Add user-defined header"
  543. then "Edit..." if you want to add it via the Claws Mail interface, or do
  544. echo "0:" `cat filename.xface` > ~/.claws-mail/customheaderrc
  545. if you want to create the custom headers file yourself (Warning: this
  546. method is valid only if you don't have any other custom header set or
  547. they will be lost!).
  548. Contact: Ricardo Mones <ricardo@mones.org>
  549. * update-po
  550. WHAT IT DOES
  551. This script is a message catalog translator's tool, it updates the .po
  552. files named on the command line.
  553. HOW TO USE IT
  554. This script needs to be copied to and run from the 'po' directory.
  555. ./update-po lang.po lang2.po ...
  556. to update one or more <yourlang>.po files from the sourcecode files
  557. named in POTFILES.in. The old .po file is save in a .po.old file.
  558. For example, when you want to update fr.po, run ./update-po fr.po,
  559. then edit fr.po to update your translation.
  560. Contact: Wilbert Berendsen <wilbert@oswf.org> or the Claws Mail Team
  561. --------------------------------------------------------------------------------
  562. This file is Copyright 1999-2014 by the Claws Mail team.
  563. See accompanying COPYING file for license details.
  564. See each included script for copyright and license details.
  565. * cm-reparent.pl
  566. WHAT IT DOES
  567. This script tries to fix thread parenting for two or more messages
  568. HOW TO USE IT
  569. Define an action as
  570. Menu name: Reparent (fix threading)
  571. Command: cm-reparent.pl %F
  572. Then select from the message list all files that should be re-parented
  573. Then invoke the action
  574. MORE INFORMATION
  575. $ perldoc cm-reparent.pl
  576. REQUIREMENTS
  577. Date::Parse
  578. Getopt::Long
  579. Contact: H.Merijn Brand <h.m.brand@xs4all.nl>
  580. * cm-break.pl
  581. WHAT IT DOES
  582. This script tries to break thread parenting for one or more messages
  583. HOW TO USE IT
  584. Define an action as
  585. Menu name: Unthread (break threading)
  586. Command: cm-break.pl %F
  587. Then select from the message list all files that should be un-threaded
  588. Then invoke the action
  589. MORE INFORMATION
  590. $ perldoc cm-break.pl
  591. REQUIREMENTS
  592. Date::Parse
  593. Getopt::Long
  594. Contact: H.Merijn Brand <h.m.brand@xs4all.nl>