Manuell¶

Wer eine neuere Version (4.2.4) einsetzen möchte, kann sich ein fertiges Installationspaket vom Autor herunterladen http://www.pdfsam.org/download-pdfsam-basic/ und dieses mit gdebi installieren.

Nun kann PDFSam einfach mit dem Befehl:

pdfsam 

gestartet werden.

Enhanced Edition¶

Die Enhanced Edition ist nicht als fertiges Paket verfügbar. Um die erweiterten Funktionen der Enhanced Edition zu nutzen, ist es nötig, das Programm aus dem Quelltext selbst zu kompilieren. Dieser kann über die Downloadseite 🇬🇧 ⮷ oder alternativ bei SourceForge ⮷ heruntergeladen werden. Außerdem müssen noch die folgenden Pakete für eine erfolgreiche Kompilierung installiert sein:

• openjdk-6-jdk (universe, das Java Development Kit (JDK) für Entwickler )

• openjdk-6-source (universe, Java Quellcode)

• openjdk-6-jre-lib (universe, plattformunabhängige Java-Bibliotheken)

• ant (universe, plattformunabhängiges Build-Tool)

Befehl zum Installieren der Pakete:

sudo apt-get install openjdk-6-jdk openjdk-6-source openjdk-6-jre-lib ant 

Oder mit apturl installieren, Link: apt://openjdk-6-jdk,openjdk-6-source,openjdk-6-jre-lib,ant

Nach der Installation dieser Pakete kann das Programm kompiliert werden. Zuerst wird die Datei pdfsam-<CURRENT_VERSION>-out-src.zip in ein beliebiges Verzeichnis entpackt ^[4], z.B. den persönlichen Ordner. Nun wechselt man in dieses Verzeichnis. Dort befinden sich nun verschiedene .zip-Dateien, welche alle in dieses Verzeichnis entpackt ^[4] werden müssen.

Die Datei ~/pdfsam-<CURRENT_VERSION>-out-src/pdfsam-maine/ant/build.properties wird mit einem Editor geöffnet ^[3], um die Pfade anzupassen. Hier ein Beispiel:

#deploy target destination dir (if you want to deploy)
pdfsam.deploy.dir=../build/pdfsam-basic

#root dir where every src directory is located
workspace.dir=../

#where classes will be compiled, jars distributed, javadocs created and release created
build.dir=../build

#version to build
pdfsam.version=enhanced

#libraries
itext.jar.name=iText-2.0.7
log4j.jar.name=log4j-1.2.15
dom4j.jar.name=dom4j-1.6.1
jaxen.jar.name=jaxen-1.1
bcmail.jar.name=bcmail-jdk14-138
bcprov.jar.name=bcprov-jdk14-138
looks.jar.name=looks-2.1.4
jcmdline.jar.name=pdfsam-jcmdline-1.0.3
emp4j.jar.name=emp4j-1.0.0
pdfsam-console.jar.name=pdfsam-console-1.1.4e
pdfsam-split.jar.name=pdfsam-split-0.4.5
pdfsam-merge.jar.name=pdfsam-merge-0.6.4
pdfsam-cover.jar.name=pdfsam-cover-0.2.4e
pdfsam-encrypt.jar.name=pdfsam-encrypt-0.2.4e
pdfsam-mix.jar.name=pdfsam-mix-0.1.3e
pdfsam-unpack.jar.name=pdfsam-unpack-0.0.3e
pdfsam-langpack.jar.name=pdfsam-langpack

Nun kann das Programm kompiliert werden, und man sollte es ohne Probleme starten können.

#Kompilieren
cd ~/pdfsam-<CURRENT_VERSION>-out-src/pdfsam-maine/ant/
ant
#In das Programmverzeichnis wechseln
cd ~/pdfsam-<CURRENT_VERSION>-out-src/build/pdfsam-maine/release/dist/pdfsam-enhanced
#Ausführen
java -jar pdfsam-<CURRENT_VERSION>.jar 

Ab hier kann man die im Abschnitt Installation beschriebenen Schritte durchführen, um den Programmstart zu erleichtern.

Deutsche Sprache¶

Beim ersten Aufruf startet PDFsam in englischer Sprache. Um die deutsche Sprache einzustellen, wählt man den Reiter "Settings". Dort wählt man die Sprache German, speichert ab mit einem Klick auf "Save" und schließt das Programm. Beim nächsten Start von PDFsam sind die Menüs und Schaltflächen-Beschriftungen auf Deutsch.

Die Konfigurationsdaten werden im Ordner ~/.pdfsam/ im Homeverzeichnis gespeichert.

PDF-Dateien zusammenfügen¶

PDFsam 2.2.0

Um mehrere PDF-Dateien zusammen zu fügen, muss man den Reiter "Zusammenführen" (Merge) aktivieren und die "Hinzufügen"-Taste betätigen. Es erscheint ein Menü, in dem man die zu vereinenden PDF-Dateien auswählt. Diese erscheinen nun im Menü wieder. Nun den Ausgabepfad und die Ausgabedatei angeben, dies geschieht mit der "Durchsuchen"-Taste. Mit der "Starten"-Taste wird nun der Prozess gestartet.

Unten im Statusfeld wird man über den Fortschritt der Aktion informiert. Hat alles geklappt, erscheint in der letzten Zeile die Meldung

Total processed pages

gefolgt von der Seitenzahl des Ausgabedokuments. Fehlermeldungen färbt PDFsam rot ein, so dass man auf den ersten Blick sehen kann, ob etwas schiefgegangen ist. Das passiert beispielsweise, wenn man versehentlich eine Datei in einem anderen Format als PDF auswählt.

PDF-Dateien aufteilen¶

PDFSam kann auch ein einzelnes PDF-Dokument mit zwei oder mehr Seiten aufteilen und so z.B. aus einem fünfseitigem Dokument fünf einzelne PDF-Dateien erstellen.

Auf den Reiter "Teilen" (Split) wechseln und das PDF auswählen, das geteilt werden soll. Dazu die Taste "Durchsuchen" wählen. Ist das geschehen, sieht man weiter unten im Menü die Optionen zur Aufteilung:

• "in Einzelseiten zerlegen" (Burst) - erzeugt aus jeder Seite des Dokuments eine eigene Datei

• "Zerteile nach je "n" Seiten" - mit dieser Option erhält man Dateien mit einer frei wählbaren Seitenzahl

• "Zerteile nach geraden Seiten" - man erhält für jede Seite mit gerader Seitenzahl ein neues Dokument

• "Zerteile nach ungeraden Seiten" - man erhält für jede Seite mit ungerader Seitenzahl ein neues Dokument.

Unter der Option "Ausgabeordner" gibt man entweder das Originalverzeichnis der Quelldatei ein, oder man setzt einen Haken bei "Bitte Wählen" - So kann man einen anderen Ausgabeordner wählen. Die Bezeichnungen der Ausgabedateien beginnen mit einer Zahl, gefolgt von der unter "Präfix der Ausgabedateien" eingestellten Zeichenkette und dem Namen der Originaldatei.

PDF-Dateien splitten¶

Zerlegt die Datei "x.pdf" alle 6 Seiten:

pdfsam-console -f x.pdf -o . -s NSPLIT -n 6 split 

PDF-Dateien zusammenfügen¶

Zum Zusammenfügen der Dateien "1.pdf" und "2.pdf" zu "12.pdf" muss folgender Befehl verwendet werden:

pdfsam-console -f 1.pdf -f 2.pdf -o ./12.pdf concat 

Zum Zusammenfügen der pdf-Dateien im Ordner "pdfs" in alphabetischer Reihenfolge zu "zusammen.pdf" ist folgender Befehl zu benutzen:

pdfsam-console -d ./pdfs -o ./zusammen.pdf concat 

Optionen zum Zusammenfügen lassen sich auf der Hilfeseite nachlesen:

pdfsam-console -h concat 

Mit bestimmter Java-Version starten¶

Unabhängig von der systemweit eingerichteten Java-Version ist es in bestimmten Situationen erforderlich, PDFSam explizit mit einer anderen Java-Version zu starten. Ein Beispiel für OpenJDK 8 und Ubuntu 16.04:

• 32-Bit:

  /usr/lib/jvm/java-8-openjdk-i386/jre/bin/java -jar /PFAD/ZU/pdfsam/pdfsam-VERSION.jar 

• 64-Bit:

  /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -jar /PFAD/ZU/pdfsam/pdfsam-VERSION.jar 

Version 4.x¶

Diese Version setzt zwingend Java 11 oder neuer und JavaFX voraus. Während von Problemen in Kombination mit OpenJDK berichtet wurde, war der Einsatz unter Oracle Java ohne Fehler möglich.

PDFSam startet nicht¶

Wenn PDFSam nur den Start-Dialog anzeigt, danach aber abbricht, kann man PDFSam über die Console starten, um die Fehlerursache zu ermitteln; dazu im Terminal den Befehl pdfsam ausführen. Wenn dann die folgende Meldung ausgegeben wird, hat man evtl. die falsche Java-Version installiert/verwendet.

~$ pdfsam
Graphics Device initialization failed for :  es2, sw
Error initializing QuantumRenderer: no suitable pipeline found
java.lang.RuntimeException: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
	at com.sun.javafx.tk.quantum.QuantumRenderer.getInstance(QuantumRenderer.java:280)
	at com.sun.javafx.tk.quantum.QuantumToolkit.init(QuantumToolkit.java:222)
	at com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:260)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:267)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:158)
	at com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:658)
	at com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:678)
	at com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
	at java.base/java.lang.Thread.run(Thread.java:834)
Caused by: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
	at com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.init(QuantumRenderer.java:94)
	at com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.run(QuantumRenderer.java:124)
	... 1 more
Exception in thread "main" java.lang.RuntimeException: No toolkit found
	at com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:272)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:267)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:158)
	at com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:658)
	at com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:678)
	at com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
	at java.base/java.lang.Thread.run(Thread.java:834) 

Der obige Fehler tritt z. B. auf Ubuntu 20.04 mit PDFSam 4.0.4 in Verbindung mit dem Oracle-JDK 11.0.12 auf. Mit OpenJDK 11.0.18 startet PDFSam hingegen ohne Fehler.

JAVACMD=/usr/lib/jvm/jdk-11.0.12/bin/java pdfsam 

sudo update-alternatives --config java