= Recoll on Windows
Jean-Francois Dockes <jf at dockes.org>
:date:
:recollversion: 1.23.0-2017-01-07-78b8ad
:windir: downwin-c9d48
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 does not work on Windows XP.
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.
NOTE: As much as I have fun writing software, producing the Windows version is
just tedious. If you use Recoll on Windows, please consider contributing to
its availability: image:/donations/btn_donate_LG.gif[link="/donations/index.html"]
== Note for updating
Recoll versions 1.23.0-9c5e32-20161216 and 1.23.0-2bfd80-20161115 had been
switched to using Xapian 1.4 which has a new and different index
format. Due to issues in Xapian 1.4, I have switched back to using Xapian
1.2 as of Recoll 1.23.0-2017-01-07-78b8ad.
This simply means that, if your index was created by one of the above
versions, it will have to be recreated from scratch after installing the
current Recoll version. I advise explicitely deleting
$HOME/AppData/Local/Recoll/xapiandb, as this will avoid leaving around 1.4
files which would take space for nothing otherwise.
== Installation
- Download and install Python 2.7.10 or 2.7.11 (e.g.
https://www.python.org/ftp/python/2.7.11/python-2.7.11.msi[Python
2.7.11]). Recoll currently does not work with Python3. *_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).
- Download the
http://www.recoll.org/downloads/{windir}/recoll-setup-{recollversion}.exe[Recoll
setup file].
- Execute the setup file. This is a vanilla installer generated by Inno
Setup, and it will ask the usual questions.
//NOTE: The installer needs administrator rights in order to install to
//`C:\Program Files`. If you want to install on a machine where you have no
//administrator rights, you can use the
//http://www.recoll.org/downloads/{windir}/recoll-{recollversion}.7z[installation
//directory archive] instead and extract it anywhere, this works just the
//same (you will need the free http://www.7-zip.org/[7z] to extract it). If
//you are in this case, you can ignore the setup-related steps of the
//procedure of course.
== Configuration
- 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`
- Have a look at the
https://www.lesbonscomptes.com/recoll/usermanual/webhelp/docs/index.html[Recoll
manual] !
- I have also started a small link:recoll-windows-faq.html[Recoll on
MS-Windows FAQ].
== Support
Please use the
https://opensourceprojects.eu/p/recoll1/tickets/new/[Recoll issues tracker]
for reporting problems, or contact me by email: jfd at recoll.org.
== Known problems:
- Having a drive root (e.g.: c:/) in the topdirs (things to index) list
does not work (it indexes nothing). You need to list the sub-directories
to index. This will be fixed in a future release.
- Setting the log level to 4 or higher can cause the GUI to deadlock while
displaying results. This will be fixed in a future release.
- Indexing is very slow, especially when using external commands (e.g. for
PDF files). I don't know if this is a case of my doing something stupid,
or if the general architecture is really bad fitted for Windows. If
someone with good Windows programming knowledge reads this, I'd be very
interested by a discussion. Windows indexing can be ten times slower than
the Linux version. The index formats are compatible, so, if you have
shared Linux/Windows data, it's best to process it on Linux.
- Filtering by directory location ('dir:' clauses) used to be
case-sensitive, including drive letters. This is hopefully fixed by the
November 2016 version.
- Also, when filtering the search with a `dir:` clause, an absolute path
should be specified as `/c/mydir` instead of `c:/mydir`
- 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).
== Change Log
Changes in 20161115
- File path names case sensitivity and other small path issues should be fixed.
- Based on Xapian 1.4. New stemming languages are available (e.g. Arabic).
- Fixed date display encoding issues.
Changes in 20160414
- The setup script has changed back to needing administrator rights,
because this is what is convenient for most people. Use the installation
directory archive to install in a non-standard location without admin
rights.
- Fixed a bug which had the whole indexing stop if a script would time out
on a specific file (it will very rarely happen that a pathologically bad
file can throw an input handler in a loop).
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>
++++