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.39 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.39.0

  • Indexing: enable indexing non-alphanumeric characters as separate terms by listing them in the indexedpunctuation configuration variable. This is a very small change with almost no impact on the normal indexing when not used, but, when configured, it allows discriminating searches for, e.g., 1.50% and $1.50.

  • Fixed menus floating around under Gnome/Wayland (also in 1.38.2).

  • Fixed preview window mistakenly using a QTextBrowser instead of a proper HTML engine because of a build glitch (also in 1.38.2)

  • Fixed GUI not loading zh_CN messages.

  • Updated simplified Chinese translation.

Minor releases at a glance

  • 1.39.5

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

  • 1.39.4

    • GUI: only use the qApp colorscheme if the user has not explicitly set dark mode

    • GUI: wayland: fix getting the app font family and size. Doing it in a separate thread did not work.

    • GUI: wayland fix preview window not shown after dialog warning that stored text would be used.

  • 1.39.3

    • Fix document modification dates set by handlers being sometimes ignored.

    • GUI: filter some garbage values from the MIME list in adv. search.

    • GUI: fix setting the restrict file types checkbox from saved search.

    • Fix groff option (-man → -mandoc) for indexing man pages.

    • Fix testing lyx version

    • Fix gnumeric indexing (bad order of templates in xsl sheet).

    • Fix syntax warnings in powerpoint Python handler.

    • Update simdutf version to 5.3.0. The previous one crashed on some cpus.

    • Fix meson build ordering issues (trying GUI build before lib done).

  • 1.39.2

    • Update the version of the simdutf bundled Unicode converter library. The older one was crashing on some processors.

  • 1.39.1

    • GUI: add possibility for switch light/dark mode according to the desktop setting. Needs qt 6.5+ and does not work on all desktops.