Installing over an older version and other notes

Ubuntu commands installed as snap packages can’t create arbitrary files under /tmp. This is for example the case by default for pdftk which is used by Recoll to extract PDF attachments. For best results, set TMPDIR to a location which belongs to you (e.g. inside your home, with something like export TMPDIR=~/tmp in your shell startup script). Recoll could conceivably work around the problem all by itself, but I find it in bad taste to create temporary files in an arbitrary location inside your home.

1.20-35 indexes are fully backward compatible. No need to reindex when upgrading.

Always reset the index if you do not know by which version it was created (e.g.: you’re not sure it’s at least 1.18). The best method is to quit all Recoll programs and delete the index directory (rm -rf ~/.recoll/xapiandb), then start recoll or recollindex.

recollindex -z will do the same in most, but not all, cases. It’s better to use the rm method, which will also ensure that no debris from older releases remain (e.g.: old stemming files which are not used any more).

On Windows, the index is located by default in C:/Users/[me]/AppData/Local/Recoll/xapiandb

Case/diacritics sensitivity is off by default. It can be turned on only by editing recoll.conf ( see the manual). If you do so, you must then reset the index.

Changes in Recoll 1.35

  • GUI: If the desktop open method is enabled (default), use it even for files with MIME types which we do not know anything about (these used to not have an Open link in results).

  • GUI: preview: add menu entries to reload document as plain text or HTML: helps viewing some docs which display badly as HTML in dark mode because they explicitely specify dark foreground color (e.g. some rtf docs).

  • GUI: allow setting up a script to create missing thumbnails (for the result list). See the thumbnailercmd configuration parameter.

  • Windows: support UNC //server/share/path paths.

  • Unix: add optional support for using the statx() stx_btime field (birth date) in addition to the modification time for indexing and searching. This code was contributed by:

  • Unix: add support for installing the recoll library in the standard $libdir location, so that the KDE modules can be built outside the source tree and dynamically linked. This installation mode is still not the default and can be enabled with configure --enable-publiclib

  • Allow using wildcards for specifying MIME types for which we don’t compute an MD5 (e.g. video/*).

  • Fix bug causing the phrase slack to increase when queries contained multiple phrases.

  • Audio handler: use consistent ' | ' separator when multiple values are found for a field.

  • Unix monitoring indexer: fix the followlinks parameter only working for the first member of the topdirs list.

  • Unix indexer: fix the memory size limitation for handlers (filtermaxmbytes) not working when set over 2 GB.

  • GUI: fix the Webengine version copying the icon instead of the target document when the icon is dragged from the result list.

  • GUI: avoid listing the original term among the possible spelling replacements when no results.

  • Python: export new method db.getDoc(udi). Have doc.setbinurl() accept bytes in addition to bytearray.

  • Unix: Fix the tar handler to work with actual binary paths.

Minor releases at a glance