Installing over an older version and other notes

Note
Ubuntu commands installed as snap packages can’t create arbitrary files under /tmp. If some of the external commands used for indexing are snaps, 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.44 indexes are fully backward compatible. No need to reindex when upgrading.

1.45 indexes are also compatible both ways with a small exception for Windows indexes which may need to be queried or updated on a Linux system (portable indexes). These have a flag signalling the use of Windows file paths. If the index is reset on an older Recoll release, the flag will not be preserved and the portability will break. Updating the index with the old version may result in issues with path filtering.

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

  • Portable Recoll. Have a Recoll installation with its configuration and data on a removable volume and use it elsewhere without needing a local installation. See the manual.

  • New entry in the result list context menu to make a copy even if the result is a regular file system file.

  • New pyvirtualenv configuration parameter to specify a virtual environment for all Recoll Python commands.

  • Fix issue resulting in temporary file creation failing with long paths.

  • Misc small fixes, see the git log.