Externals tools used by recoll
De wiki_pcwiki2
Aller à la navigationAller à la recherche
Référence: http://www.lesbonscomptes.com/recoll/features.html#doctypes
File types indexed natively
* text.
* html.
* maildir, mh, and mailbox ( Mozilla, Thunderbird and Evolution mail ok).
Evolution note: be sure to remove .cache from the skippedNames list in the GUI Indexing preferences/Local Parameters/ pane i
f you want to index local copies of Imap mail.
* gaim and purple log files.
* Scribus files.
* an pages (needs groff).
* Dia diagrams.
* Excel and Powerpoint for Recoll versions 1.19.12 and later.
* Tar archives. Tar file indexing is disabled by default (because tar archives don't typically contain the kind of documents
that people search for), you will need to enable it explicitely, like with the following in your $HOME/.recoll/mimeconf file:
[index]
application/x-tar = execm rcltar
Z* ip archives.
* Konqueror webarchive format with Python (uses the tarfile standard library module).
* Mimehtml web archive format (support based on the mail filter, which introduces some mild weirdness, but still usable).
File types indexed with external helpers Many document types need the iconv command in addition to the applications specifically listed. The XML ones The following types need xsltproc from the libxslt package for recoll versions before 1.22, and in addition, python-libxslt1 and python-libxml2 for 1.22 and newer. Quite a few also need unzip: * Abiword files. * Fb2 ebooks. * Kword files. * Microsoft Office Open XML files. * OpenOffice files. * SVG files. * Gnumeric files. * Okular annotations files.
Other formats
The following need miscellaneous helper programs to decode the internal formats.
* pdf with the pdftotext command, which comes with poppler, (the package name is quite often poppler-utils).
Note: the older pdftotext command which comes with xpdf is not compatible with Recoll
New in 1.21: if the tesseract OCR application, and the pdftoppm command are available on the system, the rclpdf filter has the capability to run OCR.
See the comments at the top of rclpdf (usually found in /usr/share/recoll/filters) for how to enable this and configuration details.
Opening PDFs at the right page: the default configuration uses evince, which has options for direct page access and pre-setting the search strings
(hits will be highlighted). There is an example line in the default mimeview for doing the same thing with qpdfview (qpdfview --search %s %f#%p).
Okular does not have a search string option (but it does have a page number one).
* msword with antiword. It is also useful to have wvWare installed as it may be be used as a fallback for some files which antiword does not handle.
* Wordperfect with the wpd2html command from libwpd. On some distributions, the command may come with a package named libwpd-tools or such,
not the base libwpd package.
* Lyx files (needs Lyx to be installed).
* Powerpoint and Excel with the catdoc utilities up to recoll 1.19.12. Recoll 1.19.12 and later use internal Python filters for Excel and Powerpoint,
and catdoc is not needed at all (catdoc did not work on many semi-recent Excel and Powerpoint files).
* CHM (Microsoft help) files with Python, pychm and chmlib.
* GNU info files with Python and the info command.
* EPUB files with Python and this Python epub decoding module, which is packaged on Fedora, but not Debian.
* Rar archives (needs Python), the rarfile Python module and the unrar utility. The Python module is packaged by Fedora, not by Debian.
Note that the free version of unrar ("unrar-free") fails for many files with the message "Failed the read enough data".
* 7zip archives (needs Python and the pylzma module).
This is a recent addition, and you need to download the filter from the filters pages for all Recoll versions prior to 1.21.
* iCalendar(.ics) files (needs Python, icalendar).
* Mozilla calendar data See the Howto about this.
* postscript with ghostscript and pstotext. Pstotext 1.9 has a serious issue with special characters in file names, and
you should either use the version packaged for your system which is probably patched, or apply the Debian patch which is stored here for convenience.
See http://packages.debian.org/squeeze/pstotext and http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356988 for references/explanations.
To make things a bit easier, I also store an already patched version.
I added an install target to the Makefile... This installs to /usr/local, use make install PREFIX=/usr to change.
So all you need is:
tar xvzf pstotext-1.9-patched.tar.gz
cd pstotext-1.9-patched
make
make install
* RTF files with unrtf. Please note that up to version 0.21.3, unrtf mostly does not work with non western-european character sets.
Many serious problems (crashes with serious security implications and infinite loops) were fixed in unrtf 0.21.8,
so you really want to use this or a newer release. Building Unrtf from source is quick and easy.
* TeX with untex. If there is no untex package for your distribution, a source package is stored on this site (as untex has no obvious home).
Will also work with detex if this is installed.
* dvi with dvips.
* djvu with DjVuLibre.
* Audio file tags. Recoll releases 1.14 and later use a Python filter based on mutagen for all audio types.
* Image file tags with exiftool. This is a perl program, so you also need perl on the system.
This works with about any possible image file and tag format (jpg, png, tiff, gif etc.).
* Midi karaoke files. Recoll versions up to and including 1.23 use, the midi module, and some help from chardet.
There is probably a python-chardet package for your distribution, but you will quite probably need to build the midi package.
This is easy but see the notes here. Recoll 1.24 and later have incorporated the midi decoding module (modified and ported to python3),
and just need the standard Python 'six' module and chardet.
* MediaWiki dump files: Thomas Levine has written a handler for these, you will find it here: rclmwdump.
https://bitbucket.org/tlevine/recoll/src/0127be78bffdd8a294067966a3ba7b2663d7b0cf/src/filters/rclmwdump?at=default&fileviewer=file-view-default