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-30 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.31

  • GUI: modified shortcuts were not read from the preferences !

  • Query language. Add support for "issub" pseudo field to select standalone (issub:0) or embedded (issub:1) results.

  • Aspell: execute the command to retrieve the suggestions instead of loading the library. This will avoid an aspell error from crashing the whole program.

  • GUI: we didn’t show the last snippet in "Show snippets"

  • GUI: fix issue with Ctrl+0 in result table.

  • Indexer: add "Flushing" state, which will be displayed by the GUI and explain pauses while indexing.

Minor releases at a glance

  • 1.31.5

    • Fix temporary files cleanup when using tesseract OCR on PDF files.

  • 1.31.4

    • Linux/Mac: Bug in threads management could result in index corruption or crash after signal interrupt.

    • Highligthing for group (phrase/near): eliminate some spurious matches.

    • Fix page number string detection which could sometimes prevent correct highlighting in snippets.

    • Avoid query completer consuming excessive resources on unstripped indexes.

    • Fix some cases where different instances of the indexer could use different pid/lock files.

    • Fix processing on some unicode dash and apos character variations.

    • PST: fix indexing in marginal cases. Extract message dates.

  • 1.31.2 : this has a few minor changes which are not strictly bug fixes: too lazy to switch to 1.32

    • Add support for .ipynb iPython/Jupyter notebook format.

    • Implement Alt+/ shortcut to search the menu entries and possibly execute the result.

    • Fix configuration GUI button margins on Mac OS.

    • Add *.pyc pycache .pytest_cache .tox and .direnv to the default skipped names list.

    • Add /opt/homebrew/bin to the helper search path when built under Mac Homebrew.

    • Linux: let recollindex adjust its OOM killer "badness" on startup.

    • simple search: add Ctrl+H as keyboard shortcut for "show history".

    • Renamed the fragment buttons configuration file from fragbuts.xml to fragment-buttons.xml.

    • Zip archives: set the modification date attribute for members.

    • ost/pst filter: fix not fetching the message dates.

    • Anchored searches: remove unwarranted slack increase. The anchor term should behave like a normal one for slack computations.

    • Fix djvu issues on Windows.

  • 1.31.1 very short existence because of missing files in dist. Otherwise see 1.31.2

  • 1.31.0

    • Windows: KNOWN BUG: the dvu text extraction script does not work. You can get a working one to be copied into c:/program files (x86)/recoll/share/filters here