Recoll downloads

Source Rpm/deb packages Known bugs Other binary packages Bsd port Filters Translations

General information and release notes

Installing over an older version: version 1.12 indexes are mostly compatible with 1.11, but some new, relatively minor, features (ie: duplicates collapsing) depend on a full index rebuild.
If installing over 1.10 or older, you need a full rebuild. The best way to do this is to just delete the old xapiandb directory, especially if the index was created by an older version. (ie: rm -rf ~/.recoll/xapiandb/). On very old indexes, recollindex -z may sometimes end with a backend doesn't implement metadata error, which is wasteful because you then need to delete xapiandb and run the indexing again.

The download page for Recoll 1.11 is still available.

Instructions: Installation / building manual.

Most binary packages on this page need a Qt 3.3 runtime environment (QT 4.x is specified for a few). They are statically linked with Xapian, which you don't need to install separately.

Optional packages used by document filters: take a look at the list and decide what you need to install.

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 changes file), there is probably no necessity to upgrade anyway.

Updated filters

New and updated filters are sometimes available before the next Recoll release. The most notable current set is for the Open XML office document formats, not included for Recoll releases older than 1.10.5.

Source

Current version: 1.12.4: recoll-1.12.4.tar.gz. Changes. Bugs.

Preview/Beta version betarecoll-20091214.tar.gz. This is a preview of the future 1.13. The changes are described under development version in the Changes file. This version is still a bit experimental, but has interesting new functionality (no revolutionary changes though). It is the version that I use everyday, so I hope it is reasonably stable.

In order to build Recoll from source, you will need to install the Xapian core development libraries. You will find source and binary packages on the Xapian download page. Recoll 1.12 needs at least xapian 1.0.5, I suggest using the latest 1.0 Xapian (1.0.17 currently). It's at least quite preferable to use a Xapian version after 1.0.12 as they don't need the NEAR patch any more.

Qt: You can build with Qt 3.3 or Qt 4. Recoll will automatically be configured to build with Qt 4 if the version of qmake found in $PATH:$QTDIR/bin is for Qt 4 (you can also set the QMAKE variable to explicitely choose the desired version, like QMAKE=qmake-qt4).
There seems to be a few issues in Qt 4.4.0 (2008-08-23), resulting in problems when displaying the Recoll result list.
Qt 4.3, 4.4.x and 4.5 seem to work fine.
There have been reports (12-2009) that Recoll did not work with Qt 4.6, but I could not reproduce the problem.

Older recoll releases: 1.12.3. 1.12.2. 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.

A separate source file contains a KDE kicker applet to start a Recoll search from the KDE toolbar: recoll_applet-1.10.0.tgz. This is a very slightly modified version of the find_applet. It will work with any recoll version after 1.10.

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.

Ubuntu

There are Personal Package Archives on launchpad.net for Xapian, Recoll and kio-recoll. These were built from the latest versions, for a set of Ubuntu series. You just need to add the PPAs to your system software sources (the instructions are on the PPA page), and you can then install the normal package manager to install or update Recoll and Xapian. To avoid messages about signature errors, you will have to import the Recoll and Xapian public keys: 


gpg --keyserver keyserver.ubuntu.com --recv 9DA85604
gpg --export --armor 9DA85604 | sudo apt-key add -
gpg --keyserver keyserver.ubuntu.com --recv A0735AD0
gpg --export --armor  A0735AD0 | sudo apt-key add -

RPMS

The executables inside the binary rpms which follow have a static link to Xapian 1.0.16, there is no real dependency except Qt 3 or Qt 4.
Some Fedora and Mandriva packages unfortunately think that they depend on exiftool (which is needed by the little used jpeg info filter), due to excessive rpmbuild cleverness.
You need to install the Xapian library development package if you want use the source rpms.

Fedora

Fedora Core 6 with Qt 3.3.8 recoll-1.12.3-1.i386.rpm. Source: recoll-1.12.3-1.src.rpm This package usually also installs and runs on Fedora 9.

Fedora Core 10 with Qt 4 recoll-1.12.4-1.fc10.i586.rpm. Source: recoll-1.12.4-1.fc10.src.rpm

OpenSUSE

OpenSUSE 11.0 with qt3: recoll-1.12.3-0.i586.rpm. Source: recoll-1.12.3-0.src.rpm

OpenSUSE 11.1 with qt4: recoll-1.12.4-0.i586.rpm. Source: recoll-1.12.4-0.src.rpm

If you build from source on OpenSUSE 11, note that the default qt4 version on some systems is 4.4.0 which will badly display the the result list icons. Use qt3 or install a newer version of qt4.

Mandriva

Mandriva 2008 with Qt 4: recoll-1.12.4-1mdv2008.1.i586.rpm. Source: recoll-1.12.4-1mdv2008.1.src.rpm

Binary bundles

These are just prebuilt trees (without the source files). The executables were built with xapian 1.0.8 (patched for the NEAR bug) and libiconv 1.9.2 (where relevant) as static libraries. They depend on miscellaneous versions of Qt. For Solaris, you should be able to find a Qt package on sunfreeware.

Installation instructions here.

FreeBSD

The FreeBSD ports track the Recoll releases quite closely, so there is actually little point in using the following. Only for the really impatient:

FreeBSD 7.2 i386 Qt 4.5.2: recoll-1.12.4-FreeBSD-7.2-RELEASE-p4.tgzz

Solaris

Note to Solaris users: you need to perform the initial indexing pass with "recollindex", not the recoll GUI indexing thread. See errata.

Solaris 8 SPARC: recoll-1.12.3-SunOS-5.8.tgz.

Recoll also builds and runs on Solaris 10, but, given the situation (2008) of open source packages for Solaris (very old Qt on the Companion CD, inconsistent versions of the compiler and non-threaded version of Qt on sunfreeware), I've come to the temporary conclusion that you are better off building than trying to install packages. The approach I tried in 2008 and which worked was to:

Obviously, there are other ways to do it (use CC, install some place else ... ), but I tried this one.

FreeBSD ports

There are ports for both xapian-core and recoll in the standard tree, you may just need to update your ports (cvsup, portsnap), or you can get the ports from the FreeBSD site. xapian port recoll port.

Translations

Most of the translations for 1.12 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 .qm file should be copied to /usr/[local/]share/recoll/translations

recoll_xx.ts is a blank Recoll 1.12 message file, handy to work on a new translation.

Updated 1.12 translations that became available after the release:

Ukrainian. recoll_uk.ts recoll_uk.qm

Russian. recoll_ru.ts recoll_ru.qm