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.13 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
.recoll/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.12 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). 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.
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. There is currently an update icalendar (ics) filter for 1.13.
Source
Current release distribution: 1.13.04:
recoll-1.13.04.tar.gz. Recoll 1.13.04 fixes stemming, which was broken in 1.13. Changes. Bugs.
You can also download the brand new recoll-1.14.0.tar.gz. The KIO slave in 1.14 does not compile because of a missing include. Patch here.
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 1.13 needs at least xapian 1.0.5, I suggest using the latest 1.0 Xapian (1.0.18 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.Compiling with Xapian 1.2: because of some small include file issues, Recoll 1.13 does not compile with Xapian 1.2. You can apply this small patch to fix the problem. With the patch applied, Recoll works just fine with the latest and greatest Xapian.
- X11 development files.
- zlib development files.
Qt development files 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/should 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,4.5 and 4.6 seem to work fine.
KDE kicker applet:
the applet can start a Recoll search from the KDE toolbar. It is in a separate source file. 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.
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.13.02. 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.
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 or here), and you can then use the normal package manager to install or update Recoll and Xapian. To avoid messages about signature errors, if not done at the previous step, you may have to explicitely import the Recoll and Xapian public keys (as root):
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
Except if specified otherwise, the
executables inside the binary rpms which follow have a
static link to Xapian (1.0.16-18), 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, Qt, and zlib development
packages if you want use the source rpms.
Fedora
Fedora 6 with Qt 3.3.8 recoll-1.13.04-1.i586.rpm. Source: recoll-1.13.04-1.src.rpm This package usually also installs and runs on Fedora 9.
Fedora 10 and 12 with Qt 4 These builds are not statically linked, but depend on the regular Xapian and zlib rpms from the Fedora repositories.
FC10 recoll-1.13.04-2.fc10.i586.rpm. Source: recoll-1.13.04-2.fc10.src.rpm
FC12 recoll-1.13.04-1.fc12.i586.rpm. Source: recoll-1.13.04-1.fc12.src.rpmMore builds contributed by Terry, thanks. 64 bits versions are included and the spec file is improved and should help those who want to rebuild from the source rpms. Normally linked (need Xapian and zlib libraries):
Fedora 11 with Qt 4 i586 recoll-1.13.04-1.fc11.i586.rpm. 64 bits version recoll-1.13.04-1.fc11.x86_64.rpm.
Fedora 12 with Qt 4 64 bits version recoll-1.13.04-1.fc12.x86_64.rpm.
Fedora 13 with Qt 4 i686 recoll-1.13.04-1.fc13.i686.rpm. 64 bits version recoll-1.13.04-1.fc13.x86_64.rpm.
OpenSUSE
OpenSUSE 11.0 with qt3: recoll-1.13.04-0.i586.rpm. Source: recoll-1.13.04-0.src.rpm
OpenSUSE 11.2 with qt4: recoll-1.13.04-0.i586.rpm. Source: recoll-1.13.04-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.13.04-1mdv2008.1.i586.rpm. Source: recoll-1.13.04-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.6.1: recoll-1.13.04-FreeBSD-7.3-PRERELEASE.tgz
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.13.04-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:
- Install gcc 3.4.6 and gnu make from the sunfreeware packages (go to /usr/local). I guess that the gcc in /usr/sfw should be ok too here.
- Compile xapian-core and install it (with prefix /usr/local).
- Configure and install Qt. The following config worked for me, with Qt 3.3.8:
./configure -platform solaris-g++ -prefix /usr/local/Trolltech/Qt-3.3.8/ -threadThen make. Weirdly, I had to add the Qt build lib/ directory to LD_LIBRARY_PATH at some point during the build).- Set QTDIR=/usr/local/Trolltech/Qt-3.3.8 and QMAKESPEC=/usr/local/Trolltech/Qt-3.3.8/mkspecs/solaris-g++ and add $QTDIR/bin to the PATH then configure, make and install Recoll
- Don't forget to use recollindex for the first index build, recoll does not work for this (exception handling mystery probably).
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.13 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.13 message file, handy to work on a new translation.
Updated 1.13 translations that became available after the release:
None for now :(