ultimate-pdf 0.1.0

A powerful Python library and CLI for PDF processing.

Ultimate PDF

A powerful, dependency-light Python CLI for everyday PDF tasks — merge, split, compress, rotate, encrypt/decrypt, and inspect PDF files from your terminal.

Built on pypdf and PyMuPDF, with a Typer interface.

Installation

pip install ultimate-pdf

Requires Python 3.10+.

Usage

After installing, the ultimate-pdf command is available:

ultimate-pdf --help
ultimate-pdf version

Merge

Combine multiple PDFs into one:

ultimate-pdf merge a.pdf b.pdf c.pdf --output merged.pdf

Split

Split a PDF by page ranges, every N pages, or selected pages:

# One file per page range (writes into a directory)
ultimate-pdf split input.pdf --pages 1-3 --output out_dir/

# Every 2 pages into a separate file
ultimate-pdf split input.pdf --every 2 --output out_dir/

# Only selected pages
ultimate-pdf split input.pdf --select 1,3,5 --output out_dir/

Compress

Reduce file size:

ultimate-pdf compress input.pdf --output smaller.pdf
# Omit --output to write '<input>_compressed.pdf'

Rotate

Rotate pages by 90, 180, or 270 degrees:

ultimate-pdf rotate input.pdf --angle 90 --output rotated.pdf
# Rotate only specific pages
ultimate-pdf rotate input.pdf --angle 180 --pages 1,2 --output rotated.pdf

Encrypt / Decrypt

ultimate-pdf encrypt input.pdf --password secret --output locked.pdf
ultimate-pdf decrypt locked.pdf --password secret --output unlocked.pdf

Info

Show metadata and page count:

ultimate-pdf info input.pdf

License

MIT — see LICENSE.