Recoll search

## Recoll kio slave

Use this module to perform Recoll searches from any program with a KIO interface.

The module can work in two modes:

- Html interface, close to a simplified QT Recoll interface.
- File manager interface, Only with KDE 4.1 and newer, which presents results as directory entries

With recent KDE versions (now: 2016), the file manager interface works in Dolphin, and both the file manager and the HTML interface work in Konqueror.

You will undoubtedly obtain strange effects from time to time. If you have any remarks or ideas about improving kio_recoll, or observe an interesting and reproducible sequence, please report it.

The module is particularly unhelpful with search hits inside email folders, which Konqueror or Dolphin have no way to access.

### HTML interface

This works more or less like the Recoll QT GUI, much simplified. The Recoll manual describes the queries that can be performed.

Most pages in the interface should quite self-explanatory.

You normally enter this interface by entering "recoll:" or "recoll:/" in the Konqueror URL entry, and following the "search" link. You can also directly enter "recoll:/search.html".
In most circumstances, entering a link like recoll:/john smith will also yield an HTML result list.

Compared to QT Recoll, the nice point is that you can click or drag/drop the icons to access the results in the standard desktop way.

### File manager interface

The path part of the URI is taken as a Recoll query language string and executed. The results are displayed as directory entries.

There are several ways to enter this interface:

- Dolphin will only present the file manager interface. Enter recoll:/some query or recoll: some query in the address bar. Note: single-slash, not double, you will get something like "Protocol unknown" if you enter 2 slashes.
- Konqueror: this supports both the file manager and HTML interfaces. You can force using the file manager interface in the following ways:
  - Using "recollf" as protocol name instead of "recoll". This is probably the easiest option inside open dialogs.
  - Using an URL ending with a '/', ie:

    > recoll:/red apples ext:html/

  - If you would like to use the file manager view most of the time, you can set the `RECOLL_KIO_ALWAYS_DIR` environment variable or the `kio_always_dir` recoll.conf variable to 1. The HTML interface will then only be accessible through the search link in the top "recoll:" view.

No search result details (samples, relevance etc.) are available, but this interface allows multiple selections and copies, usage inside any KDE open dialog, etc.

To avoid swamping the interface with too many thousands of results, the result count is limited to 10000 by default. You can change this value by setting the `kio_max_direntries` parameter in your recoll configuration file (typically ~/.recoll/recoll.conf)

Recoll Search