CLI reference

Flag Reference

All available flags for pdfjob, with availability per edition.

CE Community Edition — free, no license
PRO Pro Edition — with -license

Input / Output

Flag Description CE PRO
-original file First PDF file — the original reference required
-modified file Second PDF file — the modified version required
-o file

Output report PDF path

default: diff_report.pdf

-pages range

Page range to compare

e.g. "1-10" or "1,3,7-12" — default: all pages

⚠ CE caps comparison at 10 pages regardless of range

-dpi value

Render resolution in DPI

default: 150

⚠ CE maximum is 150 DPI — higher values are capped automatically

max 150

Comparison

Flag Description CE PRO
-t value

Color distance threshold — lower = more sensitive

range: 0.0–1.0 — default: 0.05

0.01 = very subtle · 0.10 = obvious only

-render-workers n

Render workers per file; A and B render in parallel

default: 2

-comparison-workers n

Parallel page comparison workers

default: 4

-anti-alias-blur n

Box blur radius applied to both images before comparing

default: 0 (disabled) · 1 = light · 2 = stronger

suppresses anti-aliasing and rendering noise

-min-diff-pct value

Minimum diff% to flag a page as different

default: 0.0 — use 3.0 with -align to suppress AA noise

Alignment

Flag Description CE PRO
-align

Auto-align pages to compensate a global pixel shift between versions

default: true — two-pass coarse/fine search using MAD

-align-thr value

Rough diff% above which alignment is attempted

default: 3.0 — a fast downsampled check runs first; alignment only triggers if this threshold is exceeded

-max-offset n

Maximum pixel offset to search when aligning

default: 50

License

Flag Description CE PRO
-license file

Path to the license file — activates Pro edition

also: set $PDFJOB_LICENSE or place pdfjob.lic next to the binary

omitting this flag runs as Community Edition

not needed

enables Pro

-license-info

Show licensee name, expiry, machine binding status, and exit

requires a valid -license file

-machine-id

Print this machine's license ID and exit

format: AAAA-BBBB-CCCC-DDDD-EEEE-FFFF-0000-1111-XY

last 2 chars (XY) are check digits — send this ID to obtain a license

-check-machine-id id

Verify the check digits of any machine ID string and exit

exit 0 = valid · exit 1 = invalid check digits

accepts IDs with or without dashes

Edition summary

CE Community Edition Free

# runs as CE — no license needed

pdfjob -original a.pdf -modified b.pdf

  • All comparison and alignment flags
  • Max 10 pages per comparison
  • Max 150 DPI render resolution
PRO Pro Edition Licensed

# -license activates Pro

pdfjob -original a.pdf -modified b.pdf \

-dpi 300 -license pdfjob.lic

  • All flags, no limits
  • Unlimited pages and DPI
  • -license-info available