Recoll user manual

Jean-Francois Dockes

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be found at the following location: GNU web site.

This document introduces full text search notions and describes the installation and use of the Recoll application. It currently describes Recoll 1.20.


Table of Contents

1. Introduction
1.1. Giving it a try
1.2. Full text search
1.3. Recoll overview
2. Indexing
2.1. Introduction
2.1.1. Indexing modes
2.1.2. Configurations, multiple indexes
2.1.3. Document types
2.1.4. Recovery
2.2. Index storage
2.2.1. Xapian index formats
2.2.2. Security aspects
2.3. Index configuration
2.3.1. Multiple indexes
2.3.2. Index case and diacritics sensitivity
2.3.3. The index configuration GUI
2.4. Indexing WEB pages you wisit
2.5. Extended attributes data
2.6. Importing external tags
2.7. Periodic indexing
2.7.1. Running indexing
2.7.2. Using cron to automate indexing
2.8. Real time indexing
2.8.1. Slowing down the reindexing rate for fast changing files
3. Searching
3.1. Searching with the Qt graphical user interface
3.1.1. Simple search
3.1.2. The default result list
3.1.3. The result table
3.1.4. Displaying thumbnails
3.1.5. The preview window
3.1.6. Complex/advanced search
3.1.7. The term explorer tool
3.1.8. Multiple indexes
3.1.9. Document history
3.1.10. Sorting search results and collapsing duplicates
3.1.11. Search tips, shortcuts
3.1.12. Customizing the search interface
3.2. Searching with the KDE KIO slave
3.2.1. What's this
3.2.2. Searchable documents
3.3. Searching on the command line
3.4. Path translations
3.5. The query language
3.5.1. Modifiers
3.6. Search case and diacritics sensitivity
3.7. Anchored searches and wildcards
3.7.1. More about wildcards
3.7.2. Anchored searches
3.8. Desktop integration
3.8.1. Hotkeying recoll
3.8.2. The KDE Kicker Recoll applet
4. Programming interface
4.1. Writing a document input handler
4.1.1. Simple input handlers
4.1.2. "Multiple" handlers
4.1.3. Telling Recoll about the handler
4.1.4. Input handler HTML output
4.1.5. Page numbers
4.2. Field data processing
4.3. API
4.3.1. Interface elements
4.3.2. Python interface
5. Installation and configuration
5.1. Installing a binary copy
5.1.1. Installing through a package system
5.1.2. Installing a prebuilt Recoll
5.2. Supporting packages
5.3. Building from source
5.3.1. Prerequisites
5.3.2. Building
5.3.3. Installation
5.4. Configuration overview
5.4.1. The main configuration file, recoll.conf
5.4.2. The fields file
5.4.3. The mimemap file
5.4.4. The mimeconf file
5.4.5. The mimeview file
5.4.6. The ptrans file
5.4.7. Examples of configuration adjustments