diff options
authorjao <>2022-07-22 21:42:18 +0100
committerjao <>2022-07-22 23:34:05 +0100
commit101a4b081648bad9332a644dbb6bf5f7b0f4cd1f (patch)
parente0e76be59dbd140bd8b9d5f10c4f60fe4a9740f3 (diff)
consult recoll with live preview
-rw-r--r--img/consult-recoll-preview.pngbin0 -> 85622 bytes
2 files changed, 48 insertions, 0 deletions
diff --git a/img/consult-recoll-preview.png b/img/consult-recoll-preview.png
new file mode 100644
index 0000000..dc7f3da
--- /dev/null
+++ b/img/consult-recoll-preview.png
Binary files differ
diff --git a/posts/ b/posts/
new file mode 100644
index 0000000..1a82fd0
--- /dev/null
+++ b/posts/
@@ -0,0 +1,48 @@
+#+title: consult recoll with live preview
+#+date: <2022-07-22 19:08>
+#+filetags: emacs
+Lately, i've gravitated towards /recoll/ as a unified search engine for all my
+local data, including org and text notes, documents in PDF or similar formats,
+HTML files, and local email. As a result, my little [[][consult-recoll]] package has
+gone up a few notches up in my list. i've just released version 0.5,
+featuring live previews.
+#+begin_export html
+ <!-- preview-end -->
+[[][Recoll]] is a local search engine that knows how to index a wide variety of file
+formats. It also offers a sophisticated query language, and, for some
+document kinds, snippets of the text of the document that actually match your
+query: that's always been one of my favourite features, and wanted to bring it
+to emacs.
+i found consult's [[][live previews]] a very nice venue to bring snippets into
+emacs, via a new version of [[][consult-recoll]], and there you go, just a small
+matter of programming[fn:1].
+There are several things of this package that make me happy. For one, it's
+very small (less than 200 lines of code, including comments) and does quite a
+bit, thanks to the help of consult on the emacs side and of recoll on the
+system's side. In my opinion, it's a very good example of how the operative
+environment provided by emacs brings the Unix philosophy to the next level:
+here, it's gluing together functionality provided by emacs packages
+(completing read, consult's asynchronous searches and previews, and so on),
+and the indexing and search capabilities of a totally unrelated, orthogonal
+program, recoll, which in turn delegates to a swarm of other unix programs
+(such as antiword, unrtf, poppler, pstotext and a long etc) to extract
+information from local files[fn:2]. Very pleasant!
+* Footnotes
+[fn:1] If you're not into consult, my unpublished little library [[][jao-recoll]]
+knows how to render recoll query results (including snippets) in an
+org-prettified buffer.
+[fn:2] Another way in which recoll is true to the same philosophy is in its
+nice separation of indexing, query and presentation programs; for instance,
+its CLI interface, =recollq=, is what made =consult-recoll= such a breeze.