Thanks for contributing to Recoll development !

Never hesitate to contact me if you have a question or issue:


  • Download and install Python 2.7.15. IMPORTANT: On the Customize Python` screen, select "Add python.exe to Path"

Not Good !


Ok !


  • Optional: download and install the 7-zip program from This is only useful if you need to index files compressed with Unix methods (not needed for zip files).

  • Download the Recoll 1.24.2 setup file.

  • Execute the setup file. This is a vanilla installer generated by Inno Setup, and it will ask the usual questions.

The previous version (1.23) is still available: Recoll setup file.

Feel free to download both 1.23 and 1.24 setup files, so that you can choose later if you wish. Just know that switching versions needs deleting the Xapian index (delete C:/Users/[ME]/AppData/Local/Recoll/xapiandb), otherwise the old format will stay in use when going 1.23 → 1.24, and strange things may happen when going the other way.


  • 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 Recoll manual !

  • I have also started a small Recoll on MS-Windows FAQ.


Please use the Recoll issues tracker for reporting problems, or contact me by email: jfd at

Known problems:

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

  • Indexing is quite slow compared to the Linux version (up to 10 times slower, but still usable), 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. The Linux and Windows index formats are compatible, so, if you have shared Linux/Windows data, it’s best to process it on Linux.

  • 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 1.23.8 20180120

  • Fixed PDF indexing, which was broken in the September 2017 version.

  • Fixed using rebuild index, which used to end up with a partially deleted and unusable index, with the only solution being a manual delete of the index directory. In the current version, the rebuild will still fail in some rarer cases, but a restart of the GUI will fix the problem.

  • Fixed: setting the log level to 4 or higher can cause the GUI to deadlock while displaying results.

Changes in 1.23.3 20170904

  • Fixed having a drive root (e.g.: c:/) in the topdirs (things to index) list would not work (it indexed nothing).

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.