Skip to main content

zip-img2pdf

Losslessly convert the raster images in a zip archive into a single PDF file.

zip-img2pdf extracts the images from a zip archive and combines them into one PDF using img2pdf, which embeds images losslessly without re-encoding.

Installation

pip install zip-img2pdf

Requires Python 3.8 or newer.

Usage

zip-img2pdf <input.zip>

This converts the images inside input.zip into input.pdf (the output is named after the zip by default).

Options

Option Description
-o, --output Output PDF path (defaults to the zip's name)
--title Sets the PDF title metadata
--author Sets the PDF author metadata
--subject Sets the PDF subject metadata
--keywords Sets the PDF keywords (repeatable)
--creator Sets the PDF creator metadata
--producer Sets the PDF producer metadata
--pagesize Uniform page size (e.g. A4, A3, Letter, 210mmx297mm; append ^T for landscape)
--fit How to place images on the page: into, fill, exact, shrink, enlarge (default shrink)
--debug Enable debug-level logging

Examples

zip-img2pdf scans.zip --title "My Scans" --author "Zhang San"
zip-img2pdf photos.zip -o album.pdf --pagesize A4 --fit into

Supported image formats

jpg, jpeg, png, bmp, gif, webp, tif, tiff

Files are sorted naturally by name (img2 comes before img10), and subfolders are searched recursively.

License

MIT

Release files for zip-img2pdf 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zip-img2pdf 1.0.0
File Size Uploaded
zip_img2pdf-1.0.0.tar.gz 9.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for zip-img2pdf 1.0.0
File Interpreter ABI Platform
zip_img2pdf-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 20.2 kB

Release files / zip_img2pdf-1.0.0.tar.gz

Download URL zip_img2pdf-1.0.0.tar.gz
Size 9.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d422b1f2c1f1c980046861f5486c2af89097f54b24aa35f25eda8297921da5b2
BLAKE2b-256 checksum
How to use checksums
aa9d7fab1e820530360acc268fd0438611d859061290885f1b2c2ef8d805c2af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.

Transparency log

Release files / zip_img2pdf-1.0.0-py3-none-any.whl

Download URL zip_img2pdf-1.0.0-py3-none-any.whl
Size 10.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
506394a955d0511ae389ba200b554e514848f37f9e0aadec94cf860eaf611bbb
BLAKE2b-256 checksum
How to use checksums
0129caf720bdf37761aaa4a686414f9c09b1d4d8ad98d0c3fdf394166ea0821a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page