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

  • New recollindex command line option to write diagnostics about not indexed documents to a text file, and make it accessible from the "special indexing" GUI menu.

  • New recollindex command line option to print the indexing status for a list of paths, e.g.: find /mydir | recollindex --notindexed

  • New recollindex command line options to compact the webcache, or extract all entries to a target directory.

  • Web indexing: allow multiple versions of a page to exist in the index, and add a parameter to specify the page erase period.

  • GUI: new View menu options to adjust the font size, with Ctrl+Plus/Ctrl+Minus shortcuts.

  • GUI: new popup menu option to copy the simple file name.

  • GUI: webcache editor: new menu entry to save a webcache entry to a file.

  • GUI: automate redisplaying the search results when switching between dark and regular display modes.

  • GUI result table: fix the date format.

  • GUI result table: shortcuts for jumping to a specific row.

  • GUI result table: allow showing document text instead of metadata in the detail area.

  • GUI: add menu entries to copy a result document text to the clipboard.

  • GUI: move the dark/regular choice out of the View menu into the preferences.

Minor releases at a glance

  • 1.30.1

    • 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

    • GUI: fix the table header background color for the dark mode on Windows, it was too clear and the text was unreadable.

    • Use the textfilemaxbs value to limit the size of indexed HTML size. Some gigantic files are sometimes wrongly identified as HTML by xdg-mime, causing out of memory errors.

    • New Japanese translation by Shin-ichi Abe (JW).

    • GUI preferences: move the result table choices to a separate tab.

    • GUI: add an option to disable showing metadata while hovering. Show the document text when jumping with Ctrl+xxx if this is the default for a mouse click.

    • Fix dependency issue for building the KDE KIO slave