---
id: pdf2image
version: "1.17.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

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

License: permissive · Maintenance: dormant · Popularity: top 1,000 on PyPI

## Install

pip install pdf2image
uv add pdf2image
poetry add pdf2image

## Description

# pdf2image
[![CircleCI](https://circleci.com/gh/Belval/pdf2image/tree/master.svg?style=svg)](https://circleci.com/gh/Belval/pdf2image/tree/master) [![PyPI version](https://badge.fury.io/py/pdf2image.svg)](https://badge.fury.io/py/pdf2image) [![codecov](https://codecov.io/gh/Belval/pdf2image/branch/master/graph/badge.svg)](https://codecov.io/gh/Belval/pdf2image) [![Downloads](https://pepy.tech/badge/pdf2image/month)](https://pepy.tech/project/pdf2image) [![GitHub CI](https://github.com/Belval/pdf2image/actions/workflows/documentation.yml/badge.svg)](https://belval.github.io/pdf2image)

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](https://github.com/oschwartz10612/poppler-windows/releases/) which is the most up-to-date. You will then have to add the `bin/` folder to [PATH](https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/) or use `poppler_path = r"C:\path\to\poppler-xx\bin" as an argument` in `convert_from_path`.

### Mac

Mac users will have to...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/pdf2image) · [View on PyPI](https://pypi.org/project/pdf2image/)