orimajp/jodconverter

JODConverter automates document conversions using LibreOffice or Apache OpenOffice. http://www.jodconverter.org

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.orimajp:jodconverter:'
	}

	dependencies {
		implementation("com.github.orimajp:jodconverter:")
	}

	<dependency>
	    <groupId>com.github.orimajp</groupId>
	    <artifactId>jodconverter</artifactId>
	    <version></version>
	</dependency>


                            
    libraryDependencies += "com.github.orimajp" % "jodconverter" % ""


                            
    :dependencies [[com.github.orimajp/jodconverter ""]]

Readme

JODConverter <sup> LibreOffice</sup> / <sub>Apache OpenOffice</sub>

I created this fork because I had to do some changes to the original project and now it is time to share my work with the community.

What you want to know...

Documentation: The JODConverter documentation (work in progress) can be found here.
SIGAR: This fork does not depend on SIGAR. JODConverter only needs to retrieve office processes (PIDs) and kill office processes (using PID). It should work just fine without SIGAR with the actual process managers base on an older version of JODConverter. But I added the ability to use any process manager you would like to implement. More details on this feature later. For now, just look at the DefaultOfficeManagerBuilder class documentation.
Dependencies: See this for core project dependencies.
Tests: JODConverter is supposed to work just fine on Windows, MacOS and Unix/Linux. Any confirmation would be welcome so we could build a list of official supported OS distributions.

Usage

Using Gradle:

compile 'org.jodconverter:jodconverter-core:4.0.0-RELEASE'

Using Maven:

<dependency>
  <groupId>org.jodconverter</groupId>
  <artifactId>jodconverter-core</artifactId>
  <version>4.0.0-RELEASE</version>
</dependency>

Building the Project

Using LibreOffice libraries:

gradlew clean build -x test -x integTest

Using OpenOffice libraries:

gradlew clean build -x test -x integTest -PuseOpenOffice

Building Cli Executable

gradlew clean build -x test -x integTest distZip

Thanks To...

I cannot say exactly where you could find some similitude between my source code and the one of these forks/projects but here are my favorite/inspiration forks/projects:

XWiki fork: Nice choice if you can afford using the SIGAR tools (which I couldn't sadly).
Nuxeo fork: Nice choice if you don't want to use SIGAR and don't came across an unresponsive office process following a timeout exception that drives you crazy.
documents4j project: Nice choice if you want 100% perfect conversion using MS Office. But work only on Windows out of the box (Local implementation) and not totally free (since MS Office is not free).

A special thanks to:

@michelole who created a pull request in these two forks with a stress test that made my office process to crash every times! I don't know him but my first commit was when I was able to build my things with his stress test on!!

Original JODConverter

JODConverter (Java OpenDocument Converter) automates document conversions using LibreOffice or OpenOffice.org.

The previous home for this project is at Google Code, including some wiki pages.