= Recoll on Windows
Jean-Francois Dockes <jf at dockes.org>

image:recoll-windows10-thumb.png[link="recoll-windows10.png"]

Recoll for Windows was built on Windows 7, and tried on Windows 7 and
10. It now seems quite stable (12 November 2015)

Recoll is free and licensed under the GPL. You will be asked to accept the
license during the installation. For a regular user, and in a nutshell, the
license means that you are free to do what you want with the program (use,
copy, share, etc.). If you are a developper and intend to modify and
distribute the program, you probably know the GPL. Else you should read it.
  
I would very much like to get some feedback from actual Windows users (I am
only a visitor to Windows...). Is this useful at all ? What would make it
more useful ? You can use the Disqus comments section at the bottom of this
page, send an email, or use the
https://bitbucket.org/medoc/recoll/issues[BitBucket Recoll issues tracker].

NOTE: Especially, I would very much like information about system
compatibility. It seems that Recoll does not work on Windows XP, and there is
little I can do about it. I know that it runs on Windows 7 32 bits, and
Windows 10 64 bits (my two Virtualbox instances). I have a report that the
installer crashes on Windows 7 64 bits, but I would really like more data
points. Please send me news of your success or failure.

Procedure: 

- Download the Recoll setup file from the
  http://www.recoll.org/windows/recoll-setup-1.22.0-20160317.exe[Recoll
  web site], or (probably faster) from 
  https://bitbucket.org/medoc/recoll/downloads/recoll-setup-1.22.0-20160317.exe[BitBucket].

- Execute the setup file. This is a vanilla installer generated by Inno
  Setup, and it will ask the usual questions. If you have no administrative
  rights, take care to select a target directory where you can write.

- Download and install
  https://www.python.org/ftp/python/2.7.10/python-2.7.10.msi[Python
  2.7.10].
  *_On the `Customize installation` screen, select "Add python.exe to Path"_*
  
- Optional: download and install the 7-zip program from
  http://www.7-zip.org/. This is only useful if you need to index files
  compressed with Unix methods (not needed for zip files).

- Start recoll. It will ask if you want to customize the configuration.
  The default is to index the content of your user directory. Then start
  indexing. This can take some time.

The default result list font is particularly ugly. Change it from 
`Preferences->GUI Configuration->Result List->Result List Font`
  
For those of you who would like to build themselves and possibly work on
improving the Windows version, the link:recoll-mingw.html[build instructions].

== Recoll Windows tips and tricks

(not much for now...)

When filtering the search with a `dir:` clause, an absolute path
should be specified as `/c/mydir` instead of `c:/mydir`

== Known problems:

- There is no real-time or scheduled indexing as on Linux. For now, you
  create and update the index by using the `File` menu (or executing
  `recollindex.exe` from a command window).

Changes in 20160317

- Small change to the setup script so that administrative rights are not
  required. 

Changes/fixes in 20160129

- Changed the method used for checking that index data is up to date with
  documents. This will impose a re-indexing of all data, but it was
  necessary because the previous method was incorrect.
- Fixed crash which occured after changing some configuration parameters.
- Warn when editing a temporary copy of a document (e.g. a temp file
  extracted from a zip archive.
  
Changes in 20151202

- Fixed mbox parsing. This was getting the message separators completely
  wrong, and taking a lot of time to do it. This should be especially
  welcome by Thunderbird users.

- Fixed email attachement processing. A fault in the code which saved
  attachment data to disk for further processing resulted in a practical
  fuzzing experiment on the input processors. Especially, frequent crashes
  in the image tag extractor caused very ennoying Windows popups about
  a Python error.


Fixed in 20151115 and later

- A relatively rare crash which seemed to occur mostly on some email
  messages
- Forgotten MIME settings for .cs, .js and .css

Fixed in 20151112 and later

- Forgotten dll prevents the unrtf program to work, so no rtf indexing.

Fixed in 20151109 (hopefully?)

- The GUI sometimes crashes when you click `Preview` or `Open`. This does
  not occur often, and usually for one of the first tries after starting
  the program. Don't despair. This seems to be fixed in the latest version
  (20151109), but I am not 100% certain that it is gone.

++++
<h2 id="comments">Comments</h2>

      <div id="disqus_thread"></div>
      <script type="text/javascript">
        var disqus_shortname = 'lesbonscomptes'; 
        (function() {
            var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
            dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
            (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
        })();
      </script>
      <noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
      <a href="http://disqus.com" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
++++
