Recoll is a desktop full-text search tool.

Recoll finds documents based on their contents as well as their file names.

Recoll will index an MS-Word document stored as an attachment to an e-mail message inside a Thunderbird folder archived in a Zip file (and more...). It will also help you search for it with a friendly and powerful interface, and let you open a copy of a PDF at the right page with two clicks. There is little that will remain hidden on your disk.

The current Recoll version is 1.26.1 (Release notes, known bugs, Release history).

Recoll is based on the very capable Xapian search engine library, for which it provides a powerful text extraction layer and a complete, yet easy to use, Qt graphical interface.

XAPIAN 1.4 RECOLL GUI FREEZES: Xapian 1.4 needs Recoll 1.23.6 or newer. Details and affected Linux distributions

Recoll has extensive documentation. If you run into a problem, or want to propose improvements, you are welcome to use the mailing list or problem tracker. Even if you are already using Recoll, maybe there are still a few useful search tricks that you don't know about. A quick look at the search tips might prove useful ! Also the Faqs and Howtos section, and some contributed result list formats.

Going dark ? Have a look at how to adapt the Recoll GUI to dark desktop themes.

Recoll could not exist without a rich free software environment. See the credits. Thanks !


Recoll now has a Gnome Shell Search Provider. See the downloads page.
Version 1.26.1. Multiple small improvements. See the release notes.
Version 1.25.23. Fixes a nasty bug in the mbox parser. Needed if you want to index gmail exports. Other small fixes. See the release notes.
Version 1.25.22. Small bug fixes. See the release notes.
New nmh Python recoll front-end from Krullen Van De Trap.
Version 1.25.21. Repair result table highlighting. Windows: fix big mbox file access (e.g. for Thunderbird).
Version 1.25.20. Fixes the Windows version not deleting its temporary files, and a number of smaller issues.
Version 1.25.19. Fix issues with the OCR and XMP functions of the PDF handler.
Version 1.25.18. Fix the Qt Webengine version of the result list (the OpenSUSE version was broken).
Version 1.25.17. Fix result table highlighting. Improvements in synonyms handling. See the release notes.
Version 1.25.15. Fixes kio build issue and Python module memory leak. See the release notes.
Version 1.25.13. Fixes GUI crash. See the release notes.
Version 1.25.11. Small change yielding a significant input handler performance improvement for pdf and xls files with a lot of content. See the release notes.
Version 1.25.4. Full switch to Python3, new completer tool. See the release notes.
Version 1.24.5. Fixes an ennoying bug with recollindex -z resetting the index format to the one compatible with Xapian 1.2 and problematic with Xapian 1.4.
Version 1.24.3 is out and becomes the new main version. See the Release notes
Version 1.23.8 is out and should fix the "error 9 on netlink descriptor" crash.
Version 1.24.0 is out. It changes the snippet generation method to adapt to the new default index format in Xapian 1.4. See the release notes.
Version 1.23.7 fixes an ennoying bug with dir: filtering (potential missing results for directory names with upper-case characters).
Version 1.23.6 is released to provide a workaround to the Xapian 1.4 snippets generation issue. It will create indexes with the previous 'Chert' index format by default. If your index is in 'Glass' format and you are experiencing the UI freezes, you will need to delete it, by actually running rm -rf on the directory, (typically rm -rf ~/.recoll/xapiandb) before restarting the indexing.
Release 1.23.5 has a few changes and fixes and supports the (still experimental) new version of the Web browser extension. Also, I split the Debian/Ubuntu packages into command-line/GUI parts (recollcmd/recollgui), with a top recoll packages which depends on both, and this causes conflicts during the upgrade. For upgrading, either first delete the recoll package, then upgrade and reinstall recoll, or fix the issues with apt -f upgrade
Finalizing the move to the new site, I am closing the old BitBucket project. The existing BitBucket issues have been archived.
The source code repository and issue tracker are moving to a new place.
Release 1.23.2 has gotten much better at processing PDF XMP data.
I experimented with installing the Recoll Web UI with Apache, and found out that this is really easy, actually both easier to set up and more useful than running it standalone. Recently added: instructions for running with Nginx instead of Apache.
Recoll on MS-Windows Recoll for MS-Windows. Still a few things missing (like real-time monitoring), but it does work, and it has a proper installer, so you can easily get rid of it if you don't like it. Have a look.. This is an almost-native port, based on Qt and the Windows API, no need for Cygwin. Thanks to Christian Motz for helping with the filter interface (and the rest). I would love some feedback!
The aspell command used for orthographic suggestions is broken on Debian Jessie (because of an aspell packaging issue), and this will not be fixed for the Debian release. See the simple workaround here.
A nice new application to complement Recoll: recollfs implements a Fuse filesystem where Recoll queries are represented as directories, the contents of which are links to the result documents.
While working on a Recoll-Mutt interface I discovered incidentally that the Recoll Webui Web interface works quite well with the links web browser inside a terminal window. This appears to be an interesting solution for people looking for a search interface usable in a non-GUI environment.
Thanks to some of its users, Recoll now has filters to index and retrieve Lotus Notes messages (some implementation notes from an early user), and there is also now a Web browser interface for querying your Recoll indexes.
A problem with a simple workaround has caused several reported recollindex crashes recently (for 1.17). If you store and index Mozilla/Thunderbird email out of the standard location (~/.thunderbird), you should add the following at the end of your configuration file (e.g.: ~/.recoll/recoll.conf):

              mhmboxquirks = tbird
Adjust the path to your local value of course... Without this hint, recollindex has trouble finding the message delimiters inside the folder files, and will possibly use all the computer's memory and crash. Apart from crashes, which only occur for very big folders, this also causes incorrect mail indexing.
A new user-contributed script for those who use real-time indexing on laptops: stop or start indexing according to AC power status. See the details on the Wiki.
We now have a Chinese user manual: Recoll现在有中文手册咯: Recoll中文手册,HTML

On the side

We rent a big country house in the Aude area, in the south of France (see map on the site). If you are looking for a wonderful country place with a pool to spend holidays with a big bunch of family and/or friends in a nice historical but very quiet area, this may be it.