recoll / website / download.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

    <title>Recoll download</title>

    <meta name="generator" content="HTML Tidy, see">
    <meta name="Author" content="Jean-Francois Dockes">
    <meta name="Description" content=
    "recoll is a simple full-text search system for unix and linux
    based on the powerful and mature xapian engine">
    <meta name="Keywords" content=
    "full text search, desktop search, unix, linux">
    <meta http-equiv="Content-language" content="en">
    <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
    <meta name="robots" content="All,Index,Follow">

    <link type="text/css" rel="stylesheet" href="styles/style.css">

    <div class="rightlinks">
	<li><a href="index.html">Home</a></li>
	<li><a href="doc.html">Documentation</a></li>
	<li><a href="usermanual/rcl.install.html">Installation</a></li>
	<li><a href="index.html#support">Support</a></li>
    <div class="content">

      <h1>Recoll downloads</h1>

      <div class="intrapage">
	<table width=100%>
	      <td><a href="#source">Source</a></td>
              <td><a href="#packages">Packages (.rpm and .deb)</a></td>
              <td><a href="BUGS.html">Known bugs</a></td>
	      <td><a href="#ports">Mac ports</a></td>
	      <td><a href="filters/filters.html">Filters</a> </td>
	      <td><a href="#translations">Translations</a></td>

      <h2><a>General information</a></h2>

      <p>The current version is 1.18.1. <a href="release-1.18.html">
          Release notes</a>.</p>

      <p>The download page for Recoll 1.17 is
	<a href="download-1.17.html">still available</a>.</p>

      <p>Recoll <a href="usermanual/rcl.install.html">
	  Installation / building manual</a>.</p> 

      <p>The indexing filters used for some document types may need
        external packages not installed on your system by default, and
        not installed automatically with Recoll: <a
	href="features.html#doctypes"> take a look at the list</a> and
	decide what you need to
	install. Also <a href="filters/filters.html">new or updated
	filters</a> sometimes become available after a release. As a
	rule, all filters are compatible with all Recoll
	versions. Any compatibility problem will be explicitely

      <p>The Recoll term explorer tool in phonetic mode (marginally
	useful and optional) uses the <b>aspell</b> package, version
	0.60 (utf-8 support) or newer.</p>

      <p>If you find problems with this page, the package or its
	installation, <em>please</em> <a href="">
	  report them</a>.</p>

      <h4>What do the release numbers mean?</h4>

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

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

      <p>Z changes for <a href="BUGS.html">bug fixes</a> only, 
	and moving from X.Y.Z to X.Y.Z+u should in general involve
	little risk of regression. But, <em>any</em> change can bring
	problems, if you are not affected by the corrected bugs (check
	the <a href="release-1.18.html">release file</a>), there is
	probably no necessity to upgrade anyway.</p>

      <h2><a name="source">Source</a></h2>

      <h3>Current release distribution: 1.18.1:</h3> 
      <!-- Attention: source packages must remain here, not in a
        subdirectory, because of all the places they're referred from
        (package watches) -->
       <p><a href="recoll-1.18.1.tar.gz">recoll-1.18.1.tar.gz</a>.

      <p>I sometimes release a source tarfile when I consider that the
      current development version is stable enough. The current
      snapshot contains commits up to 2240 (see 
       <a href="">the
       changelog</a>, and a synthetic abstract in the
       current <a href="release-1.16.html">1.16 release notes</a>).
       <p><a href="betarecoll-2240.tar.gz">betarecoll-2240.tar.gz</a>.</p>

      <h3>Prerequisites for building from source:</h3>
	 <li>C++ compiler. Its absence sometimes manifests itself by
	 strange messages about iconv_open (fixed after 1.13.04).</li>

         <li><p>Xapian core development libraries. Most Linux distributions
           carry them in their package repository. Or you will find source and
	   binary packages on the 
           <a href="">
           Xapian download page</a>. <br /> 
           Recoll should still work with Xapian 1.0, but it is highly
           recommended to use a Xapian 1.2 version.</p> 

           <p><em>Note on building Xapian for older CPUs:</em> 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&nbsp;4 or AMD Athlon&nbsp;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.


        <li>X11 development files.</li>

        <li>zlib development files.</p>

        <li><p>Qt development files: Qt 4.4 or newer. The Recoll GUI
            will not build with Qt releases older than 4.4.</p></li>

        <li><p>Qt webkit development: Qt WebKit is quite often
            distributed apart from the main Qt lib. It is possible to
            configure Recoll not to use Qt WebKit (see 

        <li>Python development package: you can avoid needing this by
          configuring with --disable-python-module.</li>


      <h3>Source repository:</h3>
      <p>The <span class="application">Recoll</span> source repository is
        hosted on 
      <a href=""></a>. 
        The trunk is usually a bit on the bleeding edge, but there is
        always a maintenance branch for the current production version.</p>

      <h3>Older recoll releases:</h3>
        <a href="recoll-1.17.3.tar.gz">1.17.3</a>.
        <a href="recoll-1.16.2.tar.gz">1.16.2</a>.
        <a href="recoll-1.15.9.tar.gz">1.15.9</a>.
        <a href="recoll-1.14.4.tar.gz">1.14.4</a>.
        <a href="recoll-1.13.04.tar.gz">1.13.04</a>.
	<a href="recoll-1.12.4.tar.gz">1.12.4</a>.
	<a href="recoll-1.11.4.tar.gz">1.11.4</a>.
	<a href="recoll-1.10.6.tar.gz">1.10.6</a>.
	<a href="recoll-1.9.0.tar.gz">1.9.0</a>.
	<a href="older/recoll-1.8.2.tar.gz">1.8.2</a>.
	<a href="older/recoll-1.7.6.tar.gz">1.7.6</a>.
	<a href="older/recoll-1.6.3.tar.gz">1.6.3</a>.
	<a href="older/recoll-1.5.11.tar.gz">1.5.11</a>. 
	<a href="older/recoll-1.4.3.tar.gz">1.4.3</a>. 
	<a href="older/recoll-1.3.3.tar.gz">1.3.3</a>.
	<a href="older/recoll-1.2.3.tar.gz">1.2.3</a>.
	<a href="older/recoll-1.1.0.tar.gz">1.1.0</a>.
	<a href="older/recoll-1.0.16.tar.gz">1.0.16</a>.

      <h2><a name="packages">Packages</a></h2>

      <p>Packages or ports for Recoll are available in the standard
        repositories for many distributions.</p>
      <p>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.</p>
      <p>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.</p>

      <h3><a name="debian">Debian</a></h3>

      <p>The Debian Recoll packages are usually fairly up to date (at
        least in testing), just use the appropriate Debian repository.</p>

      <h3><a name="ubuntu">Ubuntu</a></h3>

        <p>There are Personal Package Archives on for 
          <a  href="">
            Recoll, kio-recoll and recoll-lens</a>. These were built from the
          latest versions, for a set of Ubuntu series. starting at
          Lucid. The installation is very simple:
          sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
          sudo apt-get update
          sudo apt-get install recoll

        <h3><a name="mint">Linux Mint</a></h3>
        <p>The Ubuntu PPA works perfectly for Mint 13 (and probably
          other releases too). Just follow the instructions for Ubuntu.</p>
	<p>You'll need to install the Xapian, Qt, Qt-Webkit and zlib
	  development packages if you want use the source rpms.</p>
      <p>Recoll is present in the standard Fedora package
	repositories starting from F-12. The new versions are tracked quite
	closely, so I don't build the rpms any more (email me if you need

        <p>Recoll is in the KDE:Extra repository

I now use the OpenSUSE build service to create Recoll OpenSUSE packages. 
        You just need to add the repository to your
        software sources (Yast2->software->Software repositories).<br>
        <a href="">
          Repository list (supported Suse versions)</a>. 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.</p>


        <p>Mageia version 2: 
	  <a href="mageia2/recoll-1.18.1-1.mga2.i586.rpm">
          <a href="mageia2/recoll-debug-1.18.1-1.mga2.i586.rpm">
            recoll-debug-1.18.1-1.mga2.i586.rpm</a>. <br>
	<a href="mageia2/recoll-1.18.1-1.mga2.src.rpm">

      <h2><a name="ports">Ports</a></h2> 

      <h3>Mac port</h3>

      <p>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).</p>
      <p>Recoll is in MacPorts and really easy to install:</p>
        <li><a href="">
            Install MacPorts</a>.</li>
        <li>Type "sudo port install recoll"</li>

      <p>Recoll is then available from the command line and as an icon in
        the usual MacPorts applications place.</p>

      <h2>Building on Solaris</h2>
      <p>I did not test building the GUI on Solaris for this version. You
          will need at least Qt 4.4. The old hints
          in <a href="download-1.14.html">the previous page</a> may
          still be valid.</p>
        <p>Someone did test the indexer and Python module build, they
          do work, with a few minor glitches. Be sure to use
          GNU <b>make</b> and <b>install</b>.</p>

      <h2><a name="translations">Translations</a></h2>

      <p>Most of the translations for 1.18 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 <a href="">me</a> and earn
	my gratefulness (and your less multilingual

      <p>You can use the <em>.ts</em> file to alter the translations if you
	wish (use Qt's <em>linguist</em> tool to edit the source file,
	then <em>lrelease</em> to produce the <em>.qm</em> file.).
	The <literal>.qm</literal> file should be copied to 
	<span class="filename">/usr/[local/]share/recoll/translations</span>

      <p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank
	Recoll 1.18 message file, handy to work on a new translation.</p>

      <p>A Czech translation for 1.18, thanks to Pavel
	<a href="translations/recoll_cs.ts">recoll_cs.ts</a>
	<a href="translations/recoll_cs.qm">recoll_cs.qm</a>

      <h3>Updated 1.18 translations that became available after the

      <p>A Greek translation for 1.17, thanks to Dimitrios
	<a href="translations/recoll_el.ts">recoll_el.ts</a>
	<a href="translations/recoll_el.qm">recoll_el.qm</a>
      <p>Note that, if you are running an older release,
        you may find updated messages by looking inside the
        appropriate maintenance branch
        on <a href="">bitbucket</a>.</p>