Plugins Directory » Redmine More Previews

26225 Author: Stephan Wenzel
Code repository:
Registered on: 2020-11-13 (12 months ago)
Current version: 2.0.3
Compatible with: Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x
User ratings:   (14)

Preview various file types in redmine's preview pane. Works for issue attachments, documents module, files module and repositories.

This plugin is designed to work with own plugins. That is plugins for plugins. To preview files this plugin converts the previewed file content to either

  • pdf
  • png, jpg or gif
  • html or inline html
  • text, or
  • xml

The appropriate conversion type(s) is/are up to the plugin developer. The available conversion option can be chosen on the plugin configuration page. The plugin was developed with thread safety in mind. With caching enabled, it should stand even higher loads.

Currently, there exist the following plugins:

This plugin requires LibreOffice to be installed on your system. LibreOffice must be reachable with "soffice" to the user, the redmine service is executed by.

Libre uses LibreOffice to do the conversion. Libre converts almost everything LibreOffice can convert:

.csv , .doc , .docm , .docx , .dotm , .dotx , .fodg , .fodp , .fods , .fodt , .odb , .odc , .odf , .odg , .odi , .odm , .odp , .ods , .odt , .otg , .oth , .otp , .ots , .ott , .oxt , .potm , .potx , .ppt , .pptm , .pptx , .rtf , .sda , .sdc , .sdd , .sdp , .sds , .sdw , .sgl , .smf , .stc , .std , .sti , .stw , .sxc , .sxd , .sxg , .sxi , .sxm , .sxw , .vor , .xls , .xlsm , .xlsx , .xltm , .xltx

to either pdf, html, inline, png, jpg or gif.

Please note, that not all conversions have been thoroughly tested yet. Please send files for a conversion test to me, if you are uncertain if your files get converted an can be viewed in a browser. Further, please note that the conversion accuracy strongly depends on the availability of installed fonts. Please consult the LibreOffice portals to see how to install fonts.

Currently, thoroughly tested are: .csv, .doc, .docx, .ppt, .pptx, .xls, .xlsx, .oddt, .rtf

This plugin requires no additional software to be installed on your system.

Cliff converts

.mime, .eml

to html.

You can view the .eml file almost like in a professional email viewer, see mail headers and download attachments. Cliff will sweep the .eml files from scripts, event attributes beginning with "on…", url() in css styles and external images. To do an unsafe preview, you can press a button do so and if you trust the .eml or .mime file

Mark uses Pandoc to do the conversion. Currently supported is:

.md, .textile, .html

Peek lets you preview pdf-Files in the browser. Peek uses imagemagick to do the conversion. Imagemagick uses Ghostscript as a delegate to handle pdf files. Pdf previews can be the full pdf or a png, jpg or gif of the first page. Please note, that the conversion resolution strongly depends on your ImageMagick's configuration in the delegates file. Please consult ImageMagick's configuration help to edit the delegates file.

Zippy lets you preview zip, tgz or tar-Files in the browser. Click on an entry to download one individual file from within the compressed file.


NilText lets you see, which data are available for a file conversion. NilText not suited for production use. You can peruse this plugin to learn about the plugin functionality. Please note, that this plugin may reveal a password of a repository. Like all other plugins, this plugin is deactivated by default.


Go to Administration -> Plugins -> Redmine More Previews Configuration

Choose the following options

  • use embed-tag or iframe-tag
  • cache previews (speeds views, may bloat your rails root's tmp folder a bit)
  • activate sub plugins above
  • for each sub plugin activate the file extension for files you want to preview (if you choose two sub plugins converting the same file type, then a warning will be issued and the last activated sub plugin will do the conversion).

Have fun!


  • English
  • German
  • Spanish
  • French
  • Japanese
  • Portugese (Brazil)
  • Portugese
  • Russian
  • Chinese

Native speakers: please help to improve localizations


  • 2.0.2 fixed missing assets bug for html conversion in non-cache mode, fixed soffice UserInstallation issue on Windows platforms
  • 2.0.1 fixed last minute bugs
  • 2.0.0 Recoded and published, supports redmine 3+, redmine 4+
  • 1.0.0 Running on Redmine 3.4.6, never published


This plugin replaces

  • redmine_preview_office,
  • redmine_preview_docx and
  • redmine_preview_pdf

Best with

This plugin ideally works together with

  • redmine_preview_inline
  • redmine_all_thumbnails

Installation notes


download plugin and copy plugin folder redmine_more_previews go to Redmine's plugins folder

go to redmine root folder

bundle install

to install necessary gems. Install LibreOfiice (for Libre) and/or Pandoc for (for Mark)

restart server f.i.

sudo /etc/init.d/apache2 restart


go to plugins folder, delete plugin folder redmine_attachment_categories

rm -r redmine_more_previews

restart server f.i.

sudo /etc/init.d/apache2 restart

PLEASE rate this software. Developing is dependent on your feedback.

If things don't work: Check Administration -> Information. Is LibreOffice installed? (needed for Libre). Is Pandoc installed ? (needed for ##mark##). Else, drop me a line, I'll be glad to help. You Feedback helps improve the plugin.

Common issues so far

  • Libre, ##mark##
    • LibreOffice / Pandoc is not installed
    • LibreOffice / Pandoc is installed, but paths are not set for the redmine process user
    • Redmine Process User does not have the privilege to run LibreOffice / Pandoc
    • First time LibreOffice starts takes a little while
    • Conversion accuracy is dependent on the availability of fonts in LibreOffice
    • LibreOffice is doing very well - but possibly cannot convert every tiny aspect of MS Office files
    • Redmine Process does not have write permission Rails tmp folder
  • Peek
    • ImageMagick is installed, but Ghostscript is not (Peek doing conversion pdf to png)
    • ImageMagick Delegates configuration is configured for low pixel resolution


2.0.3 (2021-05-21)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x.

- fixed windows glitch for

2.0.2 (2021-05-12)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x.

- fixed missing assets bug for html conversions in html mode
- fixed soffice UserInstallation issue for 'libre' plugin, running on Windows

2.0.1 (2020-11-16)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x.

2.0.1 fixed last minute issues

logo.png (8.26 KB) Stephan Wenzel, 2020-11-13 16:20

logo.png (5.27 KB) Stephan Wenzel, 2020-11-13 16:23

logo.png (4.75 KB) Stephan Wenzel, 2020-11-13 16:24

logo.png (5.85 KB) Stephan Wenzel, 2020-11-13 16:25

logo.png (6.73 KB) Stephan Wenzel, 2020-11-13 16:25

logo.png (8.91 KB) Stephan Wenzel, 2020-11-13 16:25

Overview.png (383 KB) Stephan Wenzel, 2020-11-13 17:29

Overview3.png (271 KB) Stephan Wenzel, 2020-11-13 18:33

Overview2.png (330 KB) Stephan Wenzel, 2020-11-13 18:38

Overview4.png (449 KB) Stephan Wenzel, 2020-11-13 19:01

Overview5.png (466 KB) Stephan Wenzel, 2020-11-13 19:05

User ratings

  by joao paulo lima saraiva 3 months ago

Muito bom esse plugin, deveria ser algo padrão no redmine.

  by Gilles Charles 5 months ago

Very helpfull.
Some trouble to make it works on windows server (2019) but finally reached the goal.

  by Klaus Heerlein 6 months ago

Thanks ! Exactly what I needed and works very nicely after I fixed the permissions for the \tmp directory.

  by Thomas Fengler 7 months ago

When clicking the "configure"-button I get 404.


How can we get in contact to exchange more details in order get the plugin run?

  by Immanuel Wilhelmy 8 months ago

Simple install, works great and boosts productivity and usability. Thanks for this great plugin!

  by Y Pamungkas 8 months ago

Works perfectly on 4.1.0-bitnami on google VM.
@Vlad Pol, have you try convert word to pdf?

  by wk s 9 months ago

work in V4.1.1
my step:

  by tonyq wang 9 months ago

I have installed this on ubuntu headless server for docx/xlsx.

The following install steps please reference:

  by Phuong Vo 10 months ago

Works like a champ!

  by ashraf alzyoud 11 months ago

Nice plugin work perfect in redmine 4.1

  by Markus Bender 11 months ago

Das Plugin ist auf jeden sehr sinnvoll. Läuft diese auch unter Windows in einem Bitnami Stack?

  by Thai Dong 11 months ago

  by maixm masygreen 11 months ago

Great job!

  by Vlad Pol 11 months ago

Hi! A very useful plugin, but it doesn't work properly. On Redmine 4.1.1 Word's documents imaging as blank.