pdf-oxide CLI — das schnellste PDF-Toolkit fürs Terminal

pdf-oxide ist ein Kommandozeilen-Werkzeug für schnelle, lokale PDF-Verarbeitung. Es nutzt denselben Rust-Kern wie die Bibliothek — keine Cloud, keine Systemabhängigkeiten. Insgesamt 23 Befehle: von text und markdown bis compress, encrypt und watermark.

Schnellinstallation (empfohlen)

Ein einzelner Befehl erkennt Betriebssystem und Architektur automatisch:

Linux / macOS

curl -fsSL oxide.fyi/install.sh | sh

Windows (PowerShell)

irm oxide.fyi/install.ps1 | iex

Weitere Installationswege

Homebrew (macOS / Linux)

brew install yfedoseev/tap/pdf-oxide

Cargo

cargo install pdf_oxide_cli

cargo-binstall (vorkompiliertes Binary)

cargo binstall pdf_oxide_cli

Vorkompilierte Binaries

Laden Sie das passende Archiv aus den GitHub Releases herunter und legen Sie die Datei in einem Verzeichnis Ihres PATH ab.

Schnellstart

# Text extrahieren
pdf-oxide text document.pdf

# In Markdown konvertieren
pdf-oxide markdown document.pdf -o output.md

# In HTML konvertieren
pdf-oxide html document.pdf -o output.html

# PDF-Informationen anzeigen (Seitenzahl, Metadaten, Verschlüsselung)
pdf-oxide info document.pdf

# Nach Text suchen (Regex möglich)
pdf-oxide search document.pdf "pattern"

Befehle

Befehl	Beschreibung	Wichtige Flags
text	Klartext extrahieren	--format plain|words|lines, --area x,y,w,h
paths	Vektorpfade extrahieren	--format json|rects|lines, --area x,y,w,h
markdown	In Markdown konvertieren	—
html	In HTML konvertieren	—
info	Metadaten und Seitenzahl anzeigen	—
search	Text suchen (Regex)	-i (Groß-/Kleinschreibung ignorieren), --pages
images	Bilder extrahieren	--area x,y,w,h, --pages
render	Seiten als PNG/JPEG rendern	--dpi N, --format png|jpeg, --quality N
merge	Mehrere PDFs zusammenführen	(mindestens 2 Dateien)
split	In Einzelseiten aufteilen	—
create	PDF aus Markdown, HTML oder Text erzeugen	--from markdown|html|text
compress	Komprimieren und optimieren	—
encrypt	Mit Passwort verschlüsseln (geplant für v0.4.0 — derzeit Platzhalter)	—
decrypt	Geschütztes PDF entschlüsseln	--password PW
rotate	Seiten drehen	--degrees 90|180|270|-90
delete	Seiten entfernen	--pages
reorder	Seiten neu ordnen	--order "3,1,2,5,4"
metadata	Metadaten lesen, bearbeiten oder entfernen	--title, --author, --subject, --keywords, --strip
watermark	Text-Wasserzeichen hinzufügen	--opacity 0.3, --rotation 45, --font-size 48, --color R,G,B
bookmarks	Dokumentgliederung auflisten	—
flatten	Anmerkungen oder Formulare abflachen	--forms, --annotations
crop	Seitenränder beschneiden	--margins L,R,T,B
forms	Formularfelder auflisten, ausfüllen oder exportieren	--fill "k=v,…", --export fdf|xfdf, --area x,y,w,h

Insgesamt 23 Befehle. pdf-oxide <Befehl> --help zeigt die vollständige Flag-Dokumentation zu jedem einzelnen Befehl.

Globale Optionen

-o, --output <PATH>        Ausgabedatei (Standard ist stdout für Textausgaben)
-p, --pages <RANGE>        Seitenbereich: "1-5", "1,3,7", "1-3,7,10-12"
    --password <PW>        Passwort für verschlüsselte PDFs
-v, --verbose              Zeitinformationen anzeigen
-q, --quiet                Nicht wesentliche Ausgaben unterdrücken
-j, --json                 Ausgabe im JSON-Format
    --no-banner            REPL-Banner überspringen

Beispiele

Seiten 1–5 als Markdown extrahieren:

pdf-oxide markdown report.pdf --pages 1-5 -o report.md

Drei PDFs zusammenführen:

pdf-oxide merge cover.pdf body.pdf appendix.pdf -o combined.pdf

Ein Wasserzeichen hinzufügen:

pdf-oxide watermark contract.pdf "DRAFT" --opacity 0.2 --font-size 72

Formularfelder ausfüllen:

pdf-oxide forms application.pdf --fill "name=Jane Doe,date=2026-02-28" -o filled.pdf

Mit Regex suchen, ohne Groß-/Kleinschreibung:

pdf-oxide search paper.pdf "neural.?network" -i

Seite 1 als PNG mit 300 dpi rendern:

pdf-oxide render report.pdf --dpi 300 --format png --pages 1 -o page1.png

Die Vektorpfad-Überlagerung eines Schaltplans als JSON extrahieren:

pdf-oxide paths schematic.pdf --format json -o paths.json

Interaktive REPL

Wird pdf-oxide ohne Argumente gestartet, öffnet sich der interaktive Modus:

$ pdf-oxide
pdf-oxide> text /path/to/doc.pdf
(extrahierter Text erscheint)
pdf-oxide> info /path/to/doc.pdf
(Metadaten erscheinen)