Personal tools
Integrate an alternative PDF viewer in Lotus Domino

Give me a choice....

Dec 09, 2014

Integrate an alternative PDF viewer in Lotus Domino

All browsers has its own PDF plug-in for PDF files, Acrobat Reader is for IE. But...have you ever had problems with it? I will! That's why I looked for another solution.

Everything starts googling "acrobat reader gray screen loading": as result you could obtain tons of pages suggesting you any kind of solution (that, in my case, doesn't works!). The problem? Open a pdf file using Acrobat Reader IE plugin.

Acrobat Reader hang

Is your website still littered with unfriendly commands to your users like "In order to read this document, you must install Acrobat Reader"?

The main problem is that, in Internet Explorer, I can't open the pdf with Acrobat. The result is a gray box and IE seems to be in hang

The main idea is to discard Acrobat plugin and to adopt another viewer: let's try with ViewerJS.

General overview

The heavy lifting in ViewerJS is done by PDF.js project.

PDF.js is a Portable Document Format (PDF) viewer that is built with HTML5.

PDF.js is community-driven and supported by Mozilla Labs. Their goal is to create a general-purpose, web standards-based platform for parsing and rendering PDFs.

Install ViewerJS on Lotus Domino

In order to use this with Domino, download the package and simply extract ViewerJS folder under domino/html server path.

Now, the easy trick to use it is to modify URLs used to open PDF attachment. For example, if something like:


should be changed in:


Focus on ViewerJS/index.html#.. string, that's the way to tell browser to use ViewerJS


With this approach, Acrobat Reader is skipped and ViewerJS is used to display the pdf.

comments powered by Disqus