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 to 1.42 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/[yourlogin]/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.42.0

  • GUI: Added "single application" mode, where starting a new instance just activates an existing one.

  • GUI: added default preference option for a more passive search entry completion.

  • GUI: New idxlocalguisettings config switch to decide that some GUI settings will be local to the index (only the result table setup at the moment). The settings are stored in $RECOLL_CONFDIR/recollgui.ini

  • GUI: preview: position the search result a few lines below the top.

  • GUI: preview: fix copy to clipboard, and other glitches.

  • New libreoffice-based handler for Apple Office documents (pages, numbers, keynote).

  • Raw indexes: fix date processing bug.

  • Improve mass result extraction performance (e.g. from Python) by only retrieving the UDI if explicitly needed.

  • Mac: support Apple Office formats, using soffice for conversion (slow).

Minor releases at a glance

  • 1.42.1

    • Repair GUI history features, broken by lazy UDI extraction in 1.42.0

    • Fix line numbers issue in orgmode handler