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.40 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.40.0

  • Python API: added module to compute an UDI for the filesystem indexer. Added an addOrUpdate() "metaonly" parameter for updating only the metadata.

  • Python API: added a module for computing an FS indexer path UDI (to complement the above).

  • Text splitter: better reporting of problem terms.

Minor releases at a glance

  • 1.40.3

    • Fix a few minor issues in synonym handling: fix phrase searches with multi-word synonyms, perform white-space normalization while reading the synonyms file.

    • Indexer: use SCHED_IDLE instead of maximum nice. Can be disabled by setting idxniceprio to 19 or less.

  • 1.40.2

    • Fixed issues in the side directory tree: very long paths (resulting in a hashed UDI in the index) caused many issues.

    • Add Markdown indexer with front matter parser.

    • Real time indexing for MacOS.

  • 1.40.1

    • GUI: fix very ennoying bug where the snippets links don’t open the PDF at the indicated page.

    • GUI: fixes some preview window issues under Wayland.