A Toolkit for PDF Files.
This is a port of pfdtk into Java. The current goal is to make a translation as faithful as it is reasonable and to fix any issues present in the original (correctness takes precedence over compatibility, see the differences), leaving possible improvements and refactoring for later. So far all code has been manually translated and it passes the test suite of php-pdftk, but a lot more testing is needed. Due to the differences between C++ and Java, it is likely that a few bugs have sneaked in with respect to the original; any help in catching them will be appreciated.
Installation on Debian/Ubuntu
An official pdftk-java package is available for Debian >= 10 and Ubuntu >= 18.10. There is also a package in a third-party repository intended for earlier OS releases that can be installed as follows:
sudo add-apt-repository ppa:malteworld/ppa
sudo apt update
sudo apt install pdftk
Dependencies
- jdk >= 1.7
- commons-lang3
- bcprov
- gradle >= 4.0 or ant (build time)
- ivy (optionally for ant, for resolving dependencies at build time)
Building and running with Gradle
If you have gradle installed you can produce a standalone jar with:
gradle shadowJar
Alternatively, a pre-built jar is also available.
This can then be run with just java installed like:
java -jar build/libs/pdftk-all.jar
The build configuration is relatively simple so it should work with most versions of gradle since 4.0 (tested 4.0, 4.10.3 and 5.0) but if you have problems try installing gradle wrapper at a particular version and then running the wrapper:
gradle wrapper --gradle-version 5.0
./gradlew shadowJar
Building and running with ant
With ivy:
$ ant
Without ivy: install bcprov and commons-lang3, make a directory lib and link bcprov.jar and commons-lang3.jar into it. Then:
$ ant jar
To run:
$ java -cp build/jar/pdftk.jar:lib/bcprov.jar:lib/commons-lang3.jar com.gitlab.pdftk_java.pdftk
Known differences with pdftk
The following differences with respect to the original version of pdftk are intended. Issue reports about other differences are welcome.
- Does not ask for owner password if not needed.
- Does not report some structure-only form fields.
- Reports some missing values in multi-valued form fields.
Source organization
java/com/ contains the translated Java sources. Currently these are a few large files, but they should be split into one class per file.
java/pdftk/ contains the sources for an old, yet-to-be-determined version of the iText library. They were modified in the original C++ sources, hence it is not obvious whether they can be replaced by a more recent vanilla version.