# PDF to Image (Python)

![License](https://img.shields.io/github/license/unban-algorembrant/pdf-to-image-python)
![Repo Size](https://img.shields.io/github/repo-size/unban-algorembrant/pdf-to-image-python)
![Last Commit](https://img.shields.io/github/last-commit/unban-algorembrant/pdf-to-image-python)
![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)

This is a Python-based utility to convert PDF files into rendered images at high resolution. 
It converts PDFs to standard US Letter dimensions (8.5 x 11 inches) using 300 DPI by default.

This project was inspired by and serves as a Python alternative to the PHP package [spatie/pdf-to-image](https://github.com/spatie/pdf-to-image).

## Requirements

- Python 3.14+
- PyMuPDF library

## Setup Instructions

Make sure your environment is ready before running the tool:

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

## Usage

Basic usage to convert a PDF:

```bash
python pdf_to_image.py "path/to/your/document.pdf" --output "output_folder"
```

## Citation

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

```bibtex
@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/unban-algorembrant/pdf-to-image-python}},
  note = {cite: {https://github.com/unban-algorembrant/*}}
}
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.