pdf2image

A wrapper around the pdftoppm and pdftocairo command line tools to convert PDF to a PIL Image list.

pdf2image Permissive license MIT DORMANT ★ 1,978 v1.17.0 released 2024-01-07

Install

pdf2image on PyPI

pip

pip install pdf2image

uv

uv add pdf2image

poetry

poetry add pdf2image

Package facts

License	MIT (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	1 — pillow
Maintenance	dormant — 949 days since the last release
Last repo commit	2024-07-23
First released	2017-06-04
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: pdf2image-1.17.0-py3-none-any.whl

Keywords: pdf, image, png, jpeg, jpg, convert

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

About pdf2image

from the package's own PyPI description — quoted content, verbatim

pdf2image

CircleCI (image) PyPI version (image) codecov (image) Downloads (image) GitHub CI (image)

A python (3.7+) module that wraps pdftoppm and pdftocairo to convert PDF to a PIL Image object

How to install

pip install pdf2image

Windows

Windows users will have to build or download poppler for Windows. I recommend @oschwartz10612 version which is the most up-to-date. You will then have to add the bin/ folder to PATH or use poppler_path = r"C:\path\to\poppler-xx\bin" as an argument in convert_from_path.

Mac

Mac users will have to...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

pdf2image wraps the pdftoppm and pdftocairo command-line tools to convert PDF files into PIL Image objects, supporting batch conversion with configurable DPI, output formats, and page ranges.

Low install friction with a single runtime dependency on pillow. However, the package is dormant—last release was 2024-01-07 and no commits for 949 days—so bug fixes and compatibility updates may lag behind Python or dependency changes.

MIT license is permissive, allowing commercial and private use with minimal restrictions; you must include the license notice in distributions.

Usage

pip install pdf2image

from pdf2image import convert_from_path
images = convert_from_path('/path/to/document.pdf')
# images is a list of PIL Image objects, one per page

Requires poppler (pdftoppm/pdftocairo) installed on the system: on Windows download poppler separately, on macOS install via Homebrew, on Linux install poppler-utils via your package manager.

Verdict: A stable, well-established library for PDF-to-image conversion with no known vulnerabilities and permissive MIT licensing. The dormant maintenance status (949 days since last release) is a concern for long-term compatibility, but the package's maturity and narrow scope limit immediate risk. Best suited for projects where PDF rendering is not the critical path and external poppler availability is guaranteed.

Needs verification

Whether the 949-day gap reflects true abandonment or stable-enough-to-ignore maintenance patterns for this use case.
Compatibility of version 1.17.0 with Python 3.11+ given the dormant status and unspecified python_support.
Current GitHub repository activity and community adoption metrics beyond the last recorded commit date.

pdf to image conversionconvert pdf pages to png jpegpdf to pil imagebatch pdf renderingextract pdf as imagespdftoppm wrapper pythonpdf page to picture