You can run BuildVu directly from the command line which is useful for running the converter from another language or script.
- You must download buildvu.jar
- Requires Java 8 or later (see version compatibility)
- Run from the same location as the buildvu jar or provide an absolute path
java -Xmx512M -jar buildvu.jar /inputDirectory/ /outputDirectory/
You may want provide more memory by increasing the Xmx value.
HTML or SVG mode?
The default output mode is HTML. To generate 100% SVG content (which provides a more accurate conversion), you can set -Dorg.jpedal.pdf2html.svgMode=true
java -Dorg.jpedal.pdf2html.svgMode=true -jar buildvu.jar /inputDirectory/ /outputDirectory/
IDRViewer or Content mode?
The default mode generates the document inside the IDRViewer. To generate just the raw content to be used inside your own custom solution, you can set -Dorg.jpedal.pdf2html.viewMode=content
java -Dorg.jpedal.pdf2html.viewMode=content -jar buildvu.jar /inputDirectory/ /outputDirectory/
How are the settings controlled?
When running from command line, settings are controlled by passing in system properties. Available settings and their values can be found in the Javadocs. The key classes are:
- HTMLConversionOptions (Settings available for the HTML mode)
- SVGConversionOptions (Settings available for the SVG mode)
- IDRViewerOptions (Settings available for the IDRViewer mode)
- ContentOptions (Settings available for the Content mode)
java -Dorg.jpedal.pdf2html.compressImages=true -jar buildvu.jar /inputDirectory/ /outputDirectory/
Encrypted PDF Files:
BuildVu includes functionality to decrypt encrypted PDF files but if you wanted to specify an alternative provider then you can still do so using -Dorg.jpedal.securityprovider. Remember to add the security provider to the classpath if needed e.g.
Office Document Support:
Although BuildVu's primary function is to convert PDF files to HTML5, it is also possible to enable conversion of Office documents to HTML5 by utilising LibreOffice to pre-convert office documents to PDF.
After you have installed LibreOffice, simply pass in the absolute path to the LibreOffice executable as a system property to enable conversion of Office documents to HTML5 from command line.
java -Dorg.jpedal.pdf2html.libreOfficeExecutablePath="/path/to/soffice" -jar buildvu.jar /inputDir/ /outputDir/
Conversion will fail if a PDF file with the same filename as the office document already exists.
If you are running LibreOffice on Linux you may find that some files do not convert correctly if they make use of fonts that are not available on Linux. We would recommend installing Google Noto Fonts to increase the likelyhood that missing fonts will be substituted with a fallback.