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-iconLibreOffice files are either a ZIP archives embedding a thumbnail of the first document page(.odt, .odx, ...) or a flat XML file (.fodt, .fodx, ...). With both type of documents, it is possible to use or to generate 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 Xenial 16.04 LTS and Ubuntu Gnome 16.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)
  • libreoffice (to convert first document page to PNG)
  • unzip (to extract document thumbnails)
  • mimetype (to detect mimetype of libreoffice documents)
  • netpbm tools (to convert, resize and generate thumbnails)

Under Ubuntu, these tools can be easily installed :

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

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.

LibreOffice standard files (.odt, .odx, ...) 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.

LibreOffice flat XML files (.fodt, .fodx, ...) do not contain any embedded thumbnail. So 1st page of the document needs to be converted. Conversion is handled by LibreOffice itself in headless mode. This mode allows libreoffice binary to be called in console mode without any GUI.  To avoid any conflict with a running graphical instance of LibreOffice, binary is called in a temporary user environment to do the conversion.

Once extracted or generated, thumbnail 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 :
#   * gvfs-copy (gvfs-bin package)
#   * libreoffice
#   * mimetype
#   * unzip
#   * pbmmake, pngtopnm, pnmtopng, pnmscalefixed and pnmcomp (netpbm 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
# 07/10/2017, V2.1 - Speedup with netpbm tools
# 09/03/2018, V3.0 - Add flat XML files support
# 12/03/2018, V3.1 - Handle libreoffice and soffice binaries
# ---------------------------------------------------

# check libreoffice availability
command -v "${CMD_OFFICE}" >/dev/null 2>&1 || CMD_OFFICE="soffice"
command -v "${CMD_OFFICE}" >/dev/null 2>&1 || { echo "[error] libreoffice missing"; exit 1; }

# check tools availability
command -v gvfs-copy >/dev/null 2>&1 || { echo "[error] gvfs-copy missing"; exit 1; }
command -v mimetype >/dev/null 2>&1 || { echo "[error] mimetype missing"; exit 1; }
command -v unzip >/dev/null 2>&1 || { echo "[error] unzip missing"; exit 1; }
command -v pbmmake >/dev/null 2>&1 || { echo "[error] pbmmake missing"; exit 1; }
command -v pngtopnm >/dev/null 2>&1 || { echo "[error] pngtopnm missing"; exit 1; }
command -v pnmscalefixed >/dev/null 2>&1 || { echo "[error] pnmscalefixed missing"; exit 1; }
command -v pnmcomp >/dev/null 2>&1 || { echo "[error] pnmcomp missing"; exit 1; }
command -v pnmtopng >/dev/null 2>&1 || { echo "[error] pnmtopng missing"; exit 1; }

# get parameters
SCRIPT_NAME=$(basename $0)

# get filename extension
FILE_EXT=$(echo "${FILE_URI}" | sed 's/^.*\.\([a-zA-Z0-9]*\)$/\1/')
[ "${FILE_EXT}" = "${FILE_URI}" ] && FILE_EXT="none"

# generate temporary files and directory
TMP_DIR=$(mktemp -t -d "thumb-lo-XXXXXXXX")

# set working path

# if needed, create cache directory
[ ! -d "${PATH_CACHE}" ] && mkdir --parent "${PATH_CACHE}"

# if file is a remote one
if [ "${URI_TYPE}" = "file" ]
    # convert URI to local path and extract local path
    FILE_PATH=$(printf '%b' "${FILE_URI//%/\\x}")
    # copy input file to temporary local file
    gvfs-copy "${FILE_URI}" "${TMP_LOCAL}"

# get document type (text, spreadsheet, graphics or presentation)
DOC_TYPE=$(mimetype -b "${FILE_LOCAL}" | sed 's/.*: //' | sed 's/^.*opendocument.\([^-]*\).*/\1/' | cut -d'-' -f1)

# if needed, create tag and mask
[ ! -f "${DOC_TAG}" ] && pngtopnm "${PATH_SYSTEM}/lo-${DOC_TYPE}.png" | pnmscalefixed -xysize ${SIZE} ${SIZE} - > "${DOC_TAG}"
[ ! -f "${DOC_ALPHA}" ] && pngtopnm -alpha "${PATH_SYSTEM}/lo-${DOC_TYPE}.png" | pnmscalefixed -xysize ${SIZE} ${SIZE} - > "${DOC_ALPHA}"

# check if document is a zipped one
IS_ZIPPED=$(file -ib "${FILE_LOCAL}" | cut -d';' -f2 | grep "binary")

# if file is zipped, extract thumbnail
if [ "${IS_ZIPPED}" != "" ]
    # extract thumbnail from zipped document
    unzip -p "${FILE_LOCAL}" "Thumbnails/thumbnail.png" | pngtopnm > "${TMP_PNM}"

# else, file is a flat one, generate thumbnail
    # convert first page to PNG
    ${CMD_OFFICE} "-env:UserInstallation=file://${TMP_DIR}" --headless --convert-to png --outdir "${TMP_DIR}" "${FILE_LOCAL}"

    # convert PNG to PNM
    FILE_NAME=$(basename "${FILE_LOCAL}")
    pngtopnm "${TMP_DIR}/${FILE_NAME}.png" | pnmscalefixed -xysize 256 256 - > "${TMP_PNM}"

# generate thumbnail with masks
pbmmake -white 208 256 | pnmcomp -align center -valign middle "${TMP_PNM}" - | pnmscalefixed -xysize ${SIZE} ${SIZE} - | pnmcomp -align center -valign middle -alpha "${DOC_ALPHA}" "${DOC_TAG}" - | pnmtopng -downscale - > "${FILE_THUMB}"

# remove temporary directory
rm -r "${TMP_DIR}"

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

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
# ./

This script also stop nautilus and purge previous thumbnails to allow them to re-generate.

You just need to restart Nautilus.

In case you need to purge your thumbnails cache once again, just run these commands :

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

Please note that if you run Lubuntu, thumbnails should be removed under $HOME/.thumbnails

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