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.4

    • Python extension: fix db.getdoc() unable to use external index.

    • GUI: raise the preview window when activated again.

    • GUI: add menu entry to access the online webhelp manual.

    • Fix indexing fb2 files with imbricated sections.

    • Document using CPUQuota parameters with systemd to throttle the indexer CPU use.

    • Mac OS: add missing files in install to fix zip archive processing.

    • recollq: fix -p/-g options always showing limited number of snippets.

    • XSLT-based handlers: accept an absolute path for the stylesheet.

    • GUI preferences: fix many tooltips not shown in the index preferences section.

  • 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.