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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| zip_img2pdf-1.0.0.tar.gz | 9.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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