Recoll Kio Slave

## Recoll KDE KIO worker

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, which presents results as directory entries
- HTML interface, close to a simplified QT Recoll interface, only usable in Konqueror.

The choice of interface is mostly determined by the protocol name. recoll for the file interface, hrecoll for the HTML one..

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)

### HTML interface

Konqueror only.

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 "hrecoll:" or "hrecoll:/" in the Konqueror URL entry, and following the "search" link. You can also directly enter "hrecoll:/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.