PDF to Image (Python)

Simply convert PDF files into rendered image pages at high resolution.

This project was inspired by and serves as a Python alternative to the PHP package spatie/pdf-to-image.

System Overview

graph TD
    A[PDF Input] --> B{Process Type}
    B -->|Single| C[single_page.py]
    B -->|Batch| D[all_page.py]
    C --> E[First Page Export]
    D --> F[Full Document Export]
    E --> G[Output Folder]
    F --> G

Project Structure

pdf-to-image-python/
├── .gitignore          # Git ignore rules
├── PDF/                # Input PDF directory
├── output/             # Generated images directory (auto-created)
├── LICENSE             # Project license
├── README.md           # Main documentation
├── STACKS.md           # Technical stack audit
├── all_page.py         # Full PDF conversion script
├── requirements.txt    # Dependency list
└── single_page.py      # First page conversion script

Requirements

Python 3.14+
PyMuPDF library

Setup Instructions

Make sure your environment is ready before running the tool:

Create a virtual environment:
```
python -m venv venv
```
Activate the virtual environment:
```
# On Windows
venv\Scripts\activate
```
Install the dependencies:
```
pip install -r requirements.txt
```

Usage

Basic usage to convert a PDF in the most efficient way:

# Convert all pages of a PDF (provide folder or file)
python all_page.py "PDF_folder" --dpi 300 --format png

# Convert only the first page (Cover) for quick previews
python single_page.py "PDF_folder" --dpi 300 --format png

Citation

If you use this tool in your research or project, please cite it as follows:

@misc{pdf_to_image_2026,
  author = {Rembrant Oyangoren Albeos},
  title = {PDF to Image Python Utility},
  year = {2026},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/not-algorembrant/*}},
}