Nautilus - Thumbnailer for LibreOffice documents



When you use Gnome Shell under Ubuntu or Debian, all LibreOffice files are displayed thru some generic icons in Nautilus.

openoffice-iconAs each LibreOffice file is a ZIP archives and is embedding by default a thumbnail of the first document page, it becomes possible to use this first page thumbnail as a Nautilus thumbnail.

To make it even more visual, the thumbnail can be outdrawn by the document type official icon. You will then get a display much more visual.

This article explains all the steps needed to configure Nautilus to display thumbnails of LibreOffice documents including document type icon and first page content, providing a simple and efficient LibreOffice documents preview. It is using some very basic tools.

This procedure has been tested under Ubuntu Precise 12.04 LTS and Ubuntu Gnome 14.04 LTS. It should be applicable to many Gnome based distributions.
It has also been tested under Lubuntu 14.04 LTS with PCManFM.

Here is the display you get in Nautilus with the generic icons :


And, here is the display you will get with the OpenOffice thumbnailer active :


If you just want to install the LibreOffice thumbnailer on your system, without any specific explanation, you can jump to Thumbnailer Installation.

1. Pre-requisite

The thumbnailer script uses different tools :

  • gvfs-copy (to copy files from remote filesystem)
  • mimetype (to detect mimetype of libreoffice documents)
  • unzip (to extract document thumbnails)
  • composite (to generate thumbnails)

Under Ubuntu, these tools can be easily installed :

# sudo apt-get install gvfs-bin libfile-mimeinfo-perl unzip imagemagick

2. Thumbnailer Script

When Nautilus needs to generate a thumbnail for a file, it is calling a 'thumbnailer'. This program (or script) is in charge of generating the thumbnail in a PNG format with a given height.

As LibreOffice file are in fact ZIP archives and the archive is embedding by default a thumbnail of the first document page, first step is to extract the embedded thumbnail from the archive. It is always stored under Thumbnails/thumbnail.png.

Once extracted, in can be transformed with a specific mask and then applied on the original document type icon.

After resizing, this will give the final Nautilus thumbnail.


The following script is a LibreOffice document 'thumbnailer' doing this job :

# ---------------------------------------------------
# Thumbnailer for LibreOffice & OpenOffice documents
# Procedure :
# Depends on :
#   * unzip
#   * composite (imagemagick package)
#   * gvfs-copy (gvfs-bin package)
# Parameters :
#   $1 - URI of office file
#   $2 - full path of generated thumbnail
#   $3 - height of thumbnail in pixels
# Revision history :
# 04/08/2013, V1.0 - Creation by N. Bernaerts
# 15/11/2014, V2.0 - Use URI to handle network shares
# ---------------------------------------------------

# check tools availability
command -v gvfs-copy >/dev/null 2>&1 || exit 1
command -v unzip >/dev/null 2>&1 || exit 1
command -v composite >/dev/null 2>&1 || exit 1

# path where to get icons used for generation

# get parameters

# get filename extension
FILE_EXT=$(echo "$FILE_URI" | sed 's/^.*\.\(.*\)/\1/')

# generate temporary local filename

# copy input file to temporary local file
gvfs-copy "${FILE_URI}" "${TMP_FILE}"

# get the file mime type (application/vnd.oasis.opendocument...)
MIMETYPE=$(mimetype -b "${TMP_FILE}")

# get document type (text, spreadsheet, graphics or presentation)
DOCTYPE=$(echo "${MIMETYPE}" | sed 's/.*: //' | sed 's/^.*opendocument.\([^-]*\).*/\1/')

# generate thumbnail according to document type
unzip -p "${TMP_FILE}" Thumbnails/thumbnail.png | composite -gravity center \( -resize x244 - \) ${ICONPATH}/lo-${DOCTYPE}.png ${ICONPATH}/lo-mask.png \( -resize x${HEIGHT} \) "${FILE_THUMB}"

# remove temporary local file
rm ${TMP_FILE}

It is using some icons available from my GitHub repository that need to be stored under /usr/local/sbin/lo-thumbnailer-icons :

All these icons are used by the thumbnailer script.

3. Thumbnailer Integration

To allow Nautilus to use the proper thumbnailer for LibreOffice documents, you need to declare the previous script as the thumbnailer for all the mime type of these documents (application/vnd.oasis.opendocument...).

This declaration is done via a lo.thumbnailer file placed under /usr/share/thumbnailers. This file follows a specific format, where association between the mime type and the thumbnailer is done.

A complete description of this file format is available from Gnome Developers site on the page Installing a Thumbnailer Program.

As we want to get thumbnails even for file which are accessed thru a network share, we will use the file URI instead of it's plain filename. This will allow the thumbnailer script to handle the files thru GVFS.

[Thumbnailer Entry]
Exec=/usr/local/sbin/lo-thumbnailer %u %o %s

4. Thumbnailer Installation

You can download and install the complete LibreOffice Thumbnailer environment from my GitHub repository :

# wget
# chmod +x
# ./

You can now purge your thumbnails to allow them to re-generate and restart nautilus to reload the thumbnailer scripts.

# rm -r $HOME/.cache/thumbnails
# nautilus -q

Please note that if you run Lubuntu, thumbnails should be removed under $HOME/.thumbnails and thumbnailer will work after next reboot.

You can now enjoy to see your LibreOffice documents displayed as thumbnails.

Hope it helps.

Signature Technoblog

This article is published "as is", without any warranty that it will work for your specific need.
If you think this article needs some complement, or simply if you think it saved you lots of time & trouble,
just let me know at This email address is being protected from spambots. You need JavaScript enabled to view it.. Cheers !

icon linux icon debian icon apache icon mysql icon php icon piwik icon googleplus