Recoll user manual i Recoll user manual Recoll user manual ii Copyright © 2005-2020 Jean-Francois Dockes Recoll user manual iii COLLABORATORS TITLE : Recoll user manual ACTION NAME DATE SIGNATURE WRITTEN BY Jean-Francois September 15, 2021 Dockes REVISION HISTORY NUMBER DATE DESCRIPTION NAME Recoll user manual iv Contents 1 Introduction 1 1.1 Giving it a try . .1 1.2 Full text search . .1 1.3 Recoll overview . .2 2 Indexing 4 2.1 Introduction . .4 2.1.1 Indexing modes . .4 2.1.1.1 Unix-like systems: choosing an indexing mode . .4 2.1.2 Configurations, multiple indexes . .5 2.1.3 Document types . .5 2.1.4 Indexing failures . .6 2.1.5 Recovery . .6 2.2 Index storage . .6 2.2.1 Xapian index formats . .7 2.2.2 Security aspects . .7 2.2.3 Special considerations for big indexes . .7 2.3 Index configuration . .8 2.3.1 Multiple indexes . .8 2.3.1.1 In practise: creating and using an additional index . .8 2.3.2 Index case and diacritics sensitivity . .9 2.3.3 Indexing threads configuration (Unix-like systems) . .9 2.3.4 The index configuration GUI . 10 2.4 Removable volumes . 11 2.4.1 Indexing removable volumes in the main index . 11 2.4.2 Self contained volumes . 11 2.5 Unix-like systems: indexing visited Web pages . 12 2.6 Unix-like systems: using extended attributes . 13 2.7 Unix-like systems: importing external tags . 13 2.8 The PDF input handler . 14 Recoll user manual v 2.8.1 XMP fields extraction . 14 2.8.2 PDF attachment indexing . 15 2.9 Recoll and OCR . 15 2.10 Periodic indexing . 15 2.10.1 Running the indexer . 15 2.10.2 recollindex command line . 16 2.10.3 Linux: using cron to automate indexing . 16 2.11 Unix-like systems: real time indexing . 16 2.11.1 Automatic daemon start with systemd . 17 2.11.2 Automatic daemon start from the desktop session . 17 2.11.3 Miscellaneous details . 18 3 Searching 19 3.1 Introduction . 19 3.2 Searching with the Qt graphical user interface . 19 3.2.1 Simple search . 20 3.2.2 The result list . 20 3.2.2.1 Customising the applications . 21 3.2.2.2 No results: the spelling suggestions . 21 3.2.2.3 The result list right-click menu . 21 3.2.3 The result table . 22 3.2.4 Unix-like systems: running arbitrary commands on result files . 23 3.2.5 Unix-like systems: displaying thumbnails . 23 3.2.6 The preview window . 23 3.2.6.1 Searching inside the preview . 24 3.2.7 The Query Fragments window . 24 3.2.8 Complex/advanced search . 25 3.2.8.1 Advanced search: the "find" tab . 25 3.2.8.2 Advanced search: the "filter" tab . 26 3.2.8.3 Advanced search history . 26 3.2.9 The term explorer tool . 27 3.2.10 Multiple indexes . 27 3.2.11 Document history . 28 3.2.12 Sorting search results and collapsing duplicates . 28 3.2.13 Keyboard shortcuts . 28 3.2.14 Search tips . 28 3.2.14.1 Terms and search expansion . 28 3.2.14.2 Working with phrases and proximity . 30 3.2.14.3 Others . 30 Recoll user manual vi 3.2.15 Saving and restoring queries (1.21 and later) . 31 3.2.16 Customizing the search interface . 31 3.2.16.1 The result list format . 33 3.2.16.1.1 The paragraph format . 33 3.3 Searching with the KDE KIO slave . 34 3.3.1 What’s this . 34 3.3.2 Searchable documents . 35 3.4 Searching on the command line . 35 3.5 The query language . 36 3.5.1 General syntax . 37 3.5.2 Special field-like specifiers . 38 3.5.3.