Recoll downloads

Source Rpm/deb packages Known bugs Other binary packages Bsd and Mac ports Filters Translations

General information

The current version is 1.15.9. Release notes.

The download page for Recoll 1.14 is still available.

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.

Updated filters

New and updated filters are sometimes available before the next Recoll release.

Source

Current release distribution: 1.15.9:

recoll-1.15.9.tar.gz. 1.15.9 only fixes an architecture-dependant startup crash in 1.15.8. You do not need to upgrade if 1.15.8 does not crash instantly on startup on your system.

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.15 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: Qt 4.4 or newer. The Recoll GUI will not build with Qt releases older than 4.4.

KDE3 kicker applet:

the applet can start a Recoll search from the KDE3 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. KDE 3 only.

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.15.7. 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.

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. For Ubuntu versions from 9.10 (Karmic), only two commands are needed:
sudo add-apt-repository ppa:xapian-backports/xapian-1.2
sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
For Ubuntu 9.04 (Jaunty) and older, to avoid messages about signature errors, 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 -
       

RPMS

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.

Fedora

Recoll is present in the standard Fedora package repositories starting from F-12.

These builds are not statically linked, but depend on the regular Xapian and zlib rpms from the Fedora repositories.
Fedora 12 recoll-1.15.8-1.fc12.i586.rpm. Source: recoll-1.15.8-1.fc12.src.rpm
Fedora 13 recoll-1.15.8-1.fc13.i586.rpm. Source: recoll-1.15.8-1.fc13.src.rpm
Fedora 14 recoll-1.15.8-1.fc14.i586.rpm. Source: recoll-1.15.8-1.fc14.src.rpm

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.

Mandriva

Mandriva linux one 2010 with Qt 4 and a static link to Xapian 1.2.3 with the --without-sse configure option.: recoll-1.15.8-1mdv2010.2.i586.rpm. Source: recoll-1.15.8-1mdv2010.2.src.rpm

Binary bundles

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.

Installation instructions here.

FreeBSD

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.4 i386 Qt 4.7.1 Statically linked to Xapian 1.2.3 with --disable-sse: recoll-1.15.8-FreeBSD-7.4-STABLE.tgz

Solaris

I did not test building on Solaris for this version. You will need at least Qt 4.4. The old hints in the previous page may still be valid.

Ports

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.

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).

There is a MacPorts Portfile available for Recoll 1.15.9. It is not in the official MacPorts tree though, but you can use it outside the tree anyway.

The following is based on the the MacPort documentation. Procedure:

Install MacPorts if it's not there yet.
Download the recoll Portfile tree (tar file).
Decide where you want the local port tree to leave (it's tiny), ie: /Users/myself/macports.
Edit /opt/local/etc/macports/sources.conf, and insert a URL pointing to your local repository before the rsync one:
```
    file:///Users/myself/macports
    rsync://rsync.macports.org/release/ports [default]
```

Extract the port tar file inside your local tree:

    cd /Users/myself/macports
    tar xvzf /path/to/the/downloaded/macport-recoll-1.15.9.tar.gz

Use the MacPorts portindex command in the local repository's directory to create or update the index of the ports in your local repository:
```
    cd ~/Users/myself/macports
    portindex
```
Once the local port is added to the PortIndex, it becomes available for searching or installation as with any other Portfile in the MacPorts tree.
Install :) :
```
    sudo port install recoll
```

Recoll is then available from the command line. There is probably a way to run it in a clicky way, but some more advanced mac user will have to point me to it...

Translations

Most of the translations for 1.15 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.15 message file, handy to work on a new translation.

Updated 1.15 translations that became available after the release:

None for now :(