- recoll.py:

    * add mount_prefix parameter, set this to location where _local_
      filesystem covered by index is mounted, used to create
      download path, see explanation in settings.yml
    * add preview support for audio, video and image types
 - settings.yml:
    * add mount_prefix plus explanation on how to use it
 - templates/.../files.html
    * add generic media preview support

searx/engines/recoll.py

  @using-api   yes
  @results     JSON
  @stable      yes
- @parse       url, content, size, abstract, author, mtype, time, \
-              filename, label
+ @parse       url, content, size, abstract, author, mtype, subtype, time, \
+              filename, label, type, embedded
 """
 
 from json import loads
-from searx.url_utils import urlencode
+from searx.url_utils import urlencode, quote
 from datetime import date, timedelta
 
 # engine dependent config
 # parameters from settings.yml
 base_url = None
 search_dir = ''
+mount_prefix = None
 dl_prefix = None
 
+# embedded
+embedded_url = '<{type} controls height="166px" ' +\
+    'src="{url}" type="{mtype}"></{type}>'
 
+
+# helper functions
 def get_time_range(time_range):
     sw = {
         'day': 1,
 
     for result in response_json.get('results', []):
         title = result['label']
-        url = result['url'].replace('file:///export', dl_prefix)
+        url = result['url'].replace('file://' + mount_prefix, dl_prefix)
         content = u'{}'.format(result['snippet'])
 
         # append result
             if result[parameter]:
                 item[parameter] = result[parameter]
 
+        # facilitate preview support for known mime types
+        if 'mtype' in result:
+            (mtype, subtype) = result['mtype'].split('/')
+            item['type'] = mtype
+            item['subtype'] = subtype
+
+            if mtype in ['audio', 'video']:
+                item['embedded'] = embedded_url.format(
+                    type=type,
+                    url=quote(url.encode('utf8'), '/:'),
+                    mtype=result['mtype'])
+
+            if mtype in ['image'] and subtype in ['bmp', 'gif', 'jpeg', 'png']:
+                item['img_src'] = url
+
         results.append(item)
 
     if 'nres' in response_json:

searx/settings.yml

     # This engine uses a custom 'files' result template
     #
     # set base_url to the location where recoll-webui can be reached
+    # set mount_prefix to the location where the file hierarchy is mounted on your _local_ filesystem
     # set dl_prefix to a location where the file hierarchy as indexed by recoll can be reached
+    # 
+    # For example:
+    #
+    #     Recoll indexes a local filesystem mounted in /export/documents/reference
+    #     The Recoll search inteface can be reached at https://recoll.example.org/
+    #     The contents of this filesystem can be reached though https://download.example.org/reference
+    #
+    #        set base_url to https://recoll.example.org/
+    #        set mount_prefix to /export/documents
+    #        set dl_prefix to https://example.org
+    #
+    #     the resulting url will be https://download.example.org/reference
+    # 
     # set search_dir to the part of the indexed file hierarchy to be searched, use an empty string
     #     to search the entire search domain
 
     # this entry (with search_dir set to an empty string) covers the entire recoll search domain
-  - name : library
-    engine : recoll
-    shortcut : lib
+  - name: library
+    engine: recoll
+    shortcut: lib
     base_url: 'https://recoll.example.org/'
-    search_dir : ''
-    dl_prefix : 'https://download.example.org'
-    timeout : 30.0
-    categories : files
-    disabled : True
+    search_dir: ''
+    mount_prefix: /export
+    dl_prefix: 'https://download.example.org'
+    timeout: 30.0
+    categories: files
+    disabled: True
 
     # this entry only searches the 'reference' directory
-  - name : library reference
-    engine : recoll
+  - name: library reference
+    engine: recoll
     base_url: 'https://recoll.example.org/'
-    search_dir : reference
-    dl_prefix : 'https://download.example.org'
-    shortcut : libr
-    timeout : 30.0
-    categories : files
-    disabled : True
+    search_dir: reference
+    mount_prefix: /export
+    dl_prefix: 'https://download.example.org'
+    shortcut: libr
+    timeout: 30.0
+    categories: files
+    disabled: True
 
   - name : reddit
     engine : reddit

searx/templates/oscar/result_templates/files.html

 {{ result_sub_header(result) }}
 
 {% if result.embedded %}
-    <small> &bull; <a class="text-info btn-collapse collapsed cursor-pointer media-loader disabled_if_nojs" data-toggle="collapse" data-target="#result-media-{{ index }}" data-btn-text-collapsed="{{ _('show media') }}" data-btn-text-not-collapsed="{{ _('hide media') }}">{{ icon('music') }} {{ _('show media') }}</a></small>
+    <small> &bull; <a class="text-info btn-collapse collapsed cursor-pointer media-loader disabled_if_nojs" data-toggle="collapse" data-target="#result-media-{{ index }}" data-btn-text-collapsed="{{ _('show media') }}" data-btn-text-not-collapsed="{{ _('hide media') }}">
+    {% if result.mtype == 'audio' %}{{ icon('music') }}
+    {% elif result.mtype == 'video' %} {{ icon('film') }}
+    {% endif %} {{ _('show media') }}</a></small>
 {% endif %}
 
 {% if result.embedded %}