Image 01


Jean-Francois Dockes Paris, France

Utilities 41 comments

by medoc
Score 78.4%
May 06 2014
Just not to let this thread unclosed: the filenames field finally got to work for not entirely clear reasons, but anyway, all was well that ended well :)
- Feb 16 2011
Thanks, I'll take a closer look at this when I'm back in 10 days.
- Feb 16 2011
This is becoming seriously mysterious !

We need to check what happens during indexing.

- Set loglevel to 6 in the config (either from indexing preferences or by editing recoll.conf)
- Create a small text file inside the indexed area, ie:
echo atextfile > bogus.txt

- try to index it:
recollindex -i bogus.txt

- You should see in the log the data record created for the file:
:5:../rcldb/rcldb.cpp:1128:Rcl::Db::add: new doc record:

If the filename field is not there, this is an indexing issue, else it's a query issue, we'll concentrate on the appropriate area at the next step.
If you need to repeat the test, run "recollindex -e bogus.txt" to erase the index data for the file first (else no reindexing will be performed).

I'm leaving for ten days this afternoon, I'll get back to this then, if you're patient enough to still be around :) - Feb 16 2011
(seems I can't reply to the last comment, so replying here).

Normally ALL documents have file names stored as a field in the index. And they also all have titles, because if no internal title (ie: html <title> or email Subject:) is found, then the file name is copied in there.

So I don't understand why you don't see the file names.

Maybe try to empty ~/.recoll/fields in case there is something weird in there, then retry the recollindex -z (sorry about the repetition).
- Feb 15 2011
Oh yes, and when a document does not have an internal title (ie: text/plain), recoll uses the file name as stand in, so that in this case filename==title
- Feb 15 2011
filename is the short name for the file (without the path). For people who give meaningful names to files it's sometimes actually more interesting than the document title. This depends on local taste and type of document, it was added as a separate field following popular request :)

By the way the command to reset the index would be recollindex -z, not recoll -z, but maybe that's what you did. - Feb 15 2011
About the file name column: if a previous version of recoll was installed, you need a full reindex (recollindex -z). Else, this is a bug, please get in touch with me (

Size column: right-click on the table header, you should be able to customize the columns to your content (else, see email address above...)

Indentation: this is not intentional, I've seen it happen, it seems to depend on the Qt version. Try to reset the result list paragraph format (in the query preferences, just set it to empty to restore the default). Maybe you can try to update Qt too. If nothing works, please get in touch.


- Feb 15 2011
Parsing recollq text output from a C++ program must not be fun, there would be a point in using the internal APIS. If you just look at the code in recollq.cpp (or the Python C++ module), you get a relatively safe/stable api because I'd have to change recollq + the php/python/kioslave and whatever other modules if I touched it.

I'll try the recoll runner !

You can get in touch with me at jfd at recoll. org if you want. - Sep 19 2010
Probably the best approach for custom search interfaces would be to use the Python API which can access most, if not all, Recoll functionality (and I'm willing to extend it). Of course there is a .so with a C++ api behind this, but I think that the C++ api is quite unwieldy and it would be better to use the Python one.
(and sorry I did not answer earlier, I rarely look at this page, and don't get email when comments are added).

- Sep 18 2010
Sorry I did not answer this, I don't seem to get email when comments are added. I think that the current PPA versions for recent Ubuntu releases use qt4. If the package for your release is based on qt3 (I'm a bit too conservative sometimes), you'll have to build from source.


jf - Sep 18 2010
There is now (1.14) a "filename" field which you can use in a custom result paragraph format, ie, <b>%(filename)</b> to display the file name prominently. - Sep 18 2010
There is a KIO slave in the current version. I don't find it extremely useful, but I'd gladly welcome comments (email me at

You need to build from source, the instructions for building the slave are inside the source tree:

- Jun 22 2009