Installing over an older version and other notes

Note
 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-29 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.29

  • New shortcuts editor. Will both help with discovering what keyboard shortcuts exist, and allow changing their values.

  • Some automatic translation inside some of the long-lagging GUI message files, thanks to crowdin.com

  • Config option for redirecting the messages from external helpers.

  • New -d recollindex option to purge indexed file data from the page cache. Could improve indexing impact on machine performance in some cases.

Minor releases at a glance

  • 1.29.2

    • GUI: fix bad background in result table dark mode.

    • ms openxml: process a variety of derived/aux formats as the base ones (.pptm etc.)

    • Python module: add method to retrieve the full snippets list.

    • Allow setting a per-handler-type indexing timeout.

    • Small bug fixes.

  • 1.29.1

    • Changed the way shortcuts are stored in the preferences file. Incompatible with the (never released) 1.29.0 method.