Metadata-Version: 2.4
Name: pdfdo
Version: 0.1.0
Summary: Interactive PDF toolkit for the command line
License-Expression: MIT
Requires-Python: >=3.11
Requires-Dist: img2pdf>=0.6
Requires-Dist: pikepdf>=10.0
Requires-Dist: pypdf[crypto]>=6.0
Requires-Dist: pypdfium2>=5.0
Requires-Dist: questionary>=2.1
Requires-Dist: rich>=15.0
Requires-Dist: typer>=0.27
Description-Content-Type: text/markdown

# 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.
