Skip to content

README.md

Latest commit

 

History

History
74 lines (49 loc) · 1.53 KB

README.md

File metadata and controls

74 lines (49 loc) · 1.53 KB

PDF to Images Conversion (Python)

A lightweight Python service for converting PDF files into images using pdftoppm. It generates one PNG image per page in the PDF.

🚀 Features

  • Converts PDF files to PNG images.
  • Outputs one image per page in the PDF.
  • Lightweight and easy to use.

⚙️ Requirements

  • Python 3.7 or higher.
  • pdftoppm installed on the system (part of poppler-utils).

🔧 Installation

  1. Clone the repository:

    git clone https://github.com/m-ah07/PDF-to-Images-Conversion-python.git

  2. Install pdftoppm (if not already installed):

    sudo apt install poppler-utils

📖 Usage

Example

Use the provided example script in the examples/ directory:

from src.pdf_to_images import PdfToImages

pdf_path = "sample.pdf"
output_dir = "output"

converter = PdfToImages(pdf_path, output_dir)
images = converter.convert()

print(images)

Place a sample PDF in the examples/ folder and run the script:

python examples/example.py

📂 Directory Structure

PDF-to-Images-Conversion-python/
├── examples/
│   └── example.py
├── src/
│   └── pdf_to_images.py
├── LICENSE
├── .gitignore
└── README.md

🤝 Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue to report bugs or suggest features.

🌟 Show Your Support

If you found this project helpful, please consider giving it a ⭐ on GitHub. Your support means the world to us!