pdfdo

Everyday PDF operations from the command line.

Install

uvx pdfdo               # run without installing
uv tool install pdfdo   # install permanently
pipx install pdfdo      # alternative

Use

pdfdo                                        # interactive menu
pdfdo img2pdf scan1.jpg scan2.jpg -o out.pdf # lossless, keeps original JPEG data
pdfdo merge a.pdf b.pdf -o joined.pdf
pdfdo split report.pdf -d parts/
pdfdo extract report.pdf 2-last -o tail.pdf
pdfdo delete report.pdf 3 -o trimmed.pdf
pdfdo rotate scan.pdf 1,2 -a 90 -o upright.pdf
pdfdo pdf2img report.pdf -d pages/ --dpi 300
pdfdo compress big.pdf -o small.pdf
pdfdo protect private.pdf -o locked.pdf
pdfdo unlock locked.pdf -o open.pdf
pdfdo info report.pdf
pdfdo --version

Page ranges accept 1,3,5-8 and the keyword last, as in 2-last.

protect and unlock prompt for the password if -p is omitted, which keeps it out of your shell history. Every command that writes refuses to overwrite an existing file unless you pass --force.

Licence

MIT

Releases

Tagging vX.Y.Z publishes to PyPI via trusted publishing and attaches standalone binaries for Windows, macOS and Linux to the GitHub release.

Those binaries are unsigned, so macOS Gatekeeper and Windows SmartScreen will warn on first run. Installing with uv tool install pdfdo or pipx install pdfdo avoids the warning entirely.