## Recoll KDE KIO slave

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

The module used to work in two modes:

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

The HTML interface has been broken for some time (2022), and only the file manager interface currently works (in, e.g., Dolphin or 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.

### File manager interface

The path part of an URI with a recoll: scheme (e.g. recoll: some query) is taken as a Recoll query language string and executed. The results are displayed as directory entries.

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 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)

### (Obsolete) HTML interface

This used to work in Konqueror, but appears to be broken in recent Konqueror versions. Doc kept for nostalgy.

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.