Recoll downloads
+ +Source | +Packages (.rpm and .deb) | +Known bugs | +Mac ports | +Filters | +Translations | +
General information
+ +The current version is 1.18.2. + Release notes.
+ +The download page for Recoll 1.17 is + still available.
+ +Recoll + Installation / building manual.
+ +The indexing filters used for some document types may need + external packages not installed on your system by default, and + not installed automatically with Recoll: take a look at the list and + decide what you need to + install. Also new or updated + filters sometimes become available after a release. As a + rule, all filters are compatible with all Recoll + versions. Any compatibility problem will be explicitely + mentionned.
+ +The Recoll term explorer tool in phonetic mode (marginally + useful and optional) uses the aspell package, version + 0.60 (utf-8 support) or newer.
+ +If you find problems with this page, the package or its + installation, please + report them.
+ +What do the release numbers mean?
+ +The Recoll releases are numbered X.Y.Z. The X + would only change for really major modifications like a big + change in the index format, and possibly won't ever reach + 2.
+ +Y is for functional modifications. These may bring bugs, so + if you don't need the new features, you may want to wait a little, + and especially skip the first release (X.Y.0), at least for a few + weeks.
+ +Z changes for bug fixes only, + and moving from X.Y.Z to X.Y.Z+u should in general involve + little risk of regression. But, any change can bring + problems, if you are not affected by the corrected bugs (check + the release file), there is + probably no necessity to upgrade anyway.
+ +Source
+ +Current release distribution: 1.18.2:
+ + + + + +Prerequisites for building from source:
+-
+
- C++ compiler. Its absence sometimes manifests itself by + strange messages about iconv_open (fixed after 1.13.04). + +
Xapian core development libraries. Most Linux distributions + carry them in their package repository. Or you will find source and + binary packages on the + + Xapian download page.
+ +
+ Recoll should still work with Xapian 1.0, but it is highly + recommended to use a Xapian 1.2 version.Note on building Xapian for older CPUs: The + build configurations for Xapian releases 1.0.21 and + 1.2.1 or newer enable the use of SSE2 floating point + instructions. These instructions are not available in CPUs + older than Intel Pentium 4 or AMD Athlon 64. When + building for such a CPU, you need to add the --disable-sse + flag to the Xapian library configure command. If this is + not done, the problem signals itself by "Illegal + instruction" crashes (SIGILL) in recollindex and recoll. +
+ +
+
+ - X11 development files. + +
- zlib development files. + +
Qt development files: Qt 4.4 or newer. The Recoll GUI + will not build with Qt releases older than 4.4.
+
+ Qt webkit development: Qt WebKit is quite often + distributed apart from the main Qt lib. It is possible to + configure Recoll not to use Qt WebKit (see + configure --help).
+
+ - Python development package: you can avoid needing this by + configuring with --disable-python-module. + +
Source repository:
+The Recoll source repository is + hosted on + bitbucket.org. + The trunk is usually a bit on the bleeding edge, but there is + always a maintenance branch for the current production version.
+ +Older recoll releases:
++ 1.18.1. + 1.17.3. + 1.16.2. + 1.15.9. + 1.14.4. + 1.13.04. + 1.12.4. + 1.11.4. + 1.10.6. + 1.9.0. + 1.8.2. + 1.7.6. + 1.6.3. + 1.5.11. + 1.4.3. + 1.3.3. + 1.2.3. + 1.1.0. + 1.0.16. +
+ +Packages
+ +Packages or ports for Recoll are available in the standard + repositories for many distributions.
+However they are often a bit older or built with older Xapian + releases. Here follow a number of updated packages and + instructions for a number of distributions.
+All binary packages on this page need a Qt 4 (4.4 at least) runtime + environment. To make things easier, on systems where Xapian is + not available from the standard package repositories, the + Recoll package will have a static link to Xapian so that you + do not need to build/install it separately.
+ +Debian
+ +The Debian Recoll packages are usually fairly up to date (at + least in testing), just use the appropriate Debian repository.
+ +Ubuntu
+ +There are Personal Package Archives on launchpad.net for + + Recoll, kio-recoll and recoll-lens. These were built from the + latest versions, for a set of Ubuntu series. starting at + Lucid. The installation is very simple: +
+ sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on + sudo apt-get update + sudo apt-get install recoll ++ +
Source code for the lens (also included in the main
+ recoll tar file):
+ For 1.18 installations:
+ recoll-lens-1.18.1.2997.tar.gz
+ For 1.17:
+ recoll-lens-1.17.2.2697.tar.gz
The packages in the standard repository and on the PPA + are a bit different in the sense that the Python extension + is included in the PPA package, but it's a separate + package in the standard repository. This can give rise to + errors about overwriting the Python module when switching + between versions. Typically, the error message would be + like the following:
+ ++ ErrorMessage: trying to overwrite '/usr/lib/python2.7/dist-packages/recoll.so', which is also in package recoll 1.18.1-1~ppa1~quantal1+ +
If this happens, you just need to delete + the previous package(s) before installing the other one(s) + instead of performing an upgrade.
+ +++ +Notes for Ubuntu Lucid
+ ++ +
+- Under lucid you will need to add the + + Xapian backports PPA to provide the libxapian22 + package
+ +- The rclepub filter apparently needs Python + 2.7. You will need to install it and modify the first + line of the filter script to execute python2.7 + instead of python.
+ +
Linux Mint
+ +The Ubuntu PPA works perfectly for Mint 13 (and probably + other releases too). Just follow the instructions for Ubuntu.
+ +RPMS
+You'll need to install the Xapian, Qt, Qt-Webkit and zlib + development packages if you want use the source rpms.
+ +Fedora
+ +Recoll is present in the standard Fedora package repositories + starting from F-12. The new versions are tracked quite + closely, so I don't build the rpms any more (email me if you need + one).
+ +OpenSUSE
+++ +Recoll is in the KDE:Extra repository + + + You just need to add the repository to your + software sources (Yast2->software->Software repositories).
+
+ + Repository list (supported Suse versions). After adding the + appropriate repository to your software sources, you will be + able to install recoll and kio_recoll from the software + management interface. The Xapian dependancy will also be + satisfied from the build service repository. Some of the older + repositories do not build antiword, just tell the software manager + to "break" recoll by installing anyway, and get antiword + somewhere else.
Mageia
++ ++ +Mageia version 2: + + mageia2/recoll-1.18.1-1.mga2.i586.rpm, + + recoll-debug-1.18.1-1.mga2.i586.rpm.
+
+ Source: + + recoll-1.18.1-1.mga2.src.rpm +
Ports
+ +Mac port
+ +It seems that Recoll will sometimes find data that Spotlight + misses (especially inside pdfs apparently, which is probably + more to the credit of poppler than recoll itself).
+Recoll is in MacPorts and really easy to install:
+-
+
- + Install MacPorts. +
- Type "sudo port install recoll" +
Recoll is then available from the command line and as an icon in + the usual MacPorts applications place.
+ +Building on Solaris
+I did not test building the GUI on Solaris for this version. You + will need at least Qt 4.4. The old hints + in the previous page may + still be valid.
+Someone did test the indexer and Python module build, they + do work, with a few minor glitches. Be sure to use + GNU make and install.
+ +Translations
+ +Most of the translations for 1.18 are incomplete + The source translation files are included in the source + release. If your language has some english messages left and + you want to take a shot at fixing the problem, you can send + the results to me and earn + my gratefulness (and your less multilingual + compatriot's)...
+ +You can use the .ts file to alter the translations if you
+ wish (use Qt's linguist tool to edit the source file,
+ then lrelease to produce the .qm file.).
+ The
recoll_xx.ts is a blank + Recoll 1.18 message file, handy to work on a new translation.
+ +A Czech translation for 1.18, thanks to Pavel + recoll_cs.ts + recoll_cs.qm +
+ + +Note that, if you are running an older release, + you may find updated messages by looking inside the + appropriate maintenance branch + on bitbucket.
+ + +