|Source||Rpm/deb packages||Known bugs||Other binary packages||Bsd port||Filters||Translations|
The download page for Recoll 1.13 is still available.
Recoll Installation / building manual.
Current release notes.
The indexing filters 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.
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.
New and updated filters are sometimes available before the next Recoll release.
Current release distribution: 1.14.4:
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.14 needs at least xapian 1.0.12. It is compatible with all later Xapian releases, including the 1.2.x series.
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 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.
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:
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.
Most binary packages on this page need a Qt 4 runtime environment (Qt 3.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.
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: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 -For Jaunty and newer releases, the procedure has been simplified, and the 2 following commands perform the whole procedure:sudo add-apt-repository ppa:xapian-backports/ppa sudo add-apt-repository ppa:recoll-backports/ppa
Except if specified otherwise, the
executables inside the binary rpms which follow have a
static link to Xapian (1.0.16-21), 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'll need to install the Xapian, Qt, and zlib development packages if you want use the source rpms.
Recoll is present in the standard Fedora package repositories starting from F-12.
Fedora 12 and newer Recoll is now included in the regular Fedora package repositories.
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.
These are just prebuilt trees (without the source files). Xapian is statically linked. They still depend on Qt. For Solaris, you should be able to find a Qt package on sunfreeware.
The FreeBSD ports track the Recoll releases quite closely, so there is actually little point in using the following (except that the port is currently (10-2010) broken).
FreeBSD 7.3 i386 Qt 4.6.1. Statically linked to Xapian 1.2.3 with --disable-sse: recoll-1.14.2-FreeBSD-7.3-STABLE.tgz
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.14.2-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.
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.
Most of the translations for 1.13 are incomplete (and I forgot to update the message files for 1.14, ugh). 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.).
recoll_xx.ts is a blank Recoll 1.14 message file, handy to work on a new translation.