- Home
- Downloads
- Documentation
- Installation
- Support

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

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.2.tar.gz.

### 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 -

> 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

### 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 4Recoll is now included in the regular Fedora package repositories. The following are just in case they're not up to the version you want. 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.rpm

> More 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/ -thread

>   Then 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 <literal>.qm</literal> file should be copied to /usr/[local/]share/recoll/translations

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 :(