pptxtoimages 0.1.2

Convert .pptx presentations to image files easily.

pptxtoimages

Overview

pptxtoimages is a lightweight Python package to convert .pptx PowerPoint presentations into high-quality image files (PNG by default).
It uses LibreOffice (soffice) to convert .pptx files to PDF, then converts PDF pages to images using pdf2image.

This project aims to provide an easy-to-use, open-source tool for developers who need to quickly generate slide images from PowerPoint files for further processing, presentations, or video creation.

---

Features

• Convert .pptx slides to images automatically
• Output images saved in PNG format by default
• Supports batch processing of multi-slide presentations
• Cross-platform support (Windows, Linux, macOS) with LibreOffice installed
• CLI support for quick command line usage

---

Installation

Make sure you have the following prerequisites installed:

• LibreOffice (soffice command available in your system PATH)
• Poppler utilities installed (poppler-utils on Linux)

Then install the package via pip:

    pip install pptxtoimages

---

Usage

Python

    from pptxtoimages.tools import PPTXToImageConverter

    # Initialize converter
    converter = PPTXToImageConverter(pptx_path)

    # Convert your .pptx file to images
    images = converter.convert("path/to/presentation.pptx", output_dir="output_images")

    print(f"Converted {len(images)} slides to images.")

Command Line Interface (CLI)

Convert a pptx file directly from the terminal :

    pptxtoimages-cli path/to/presentation.pptx --output output_images

Note : For more examples and details, please check the example.py file.

---

Configuration

• Output image format is PNG by default, but can be customized in the Converter class parameters.

• Output directory will be created if it does not exist.

Development

To contribute or develop locally:

1. Clone the repository
2. Create a virtual environment and activate it
3. Install dependencies:

    pip install -r requirements.txt

4. Use bump2version to manage versioning
5. Run tests and linting (if any)
6. Open a pull request

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

Created by Burak Civelek

Feel free to reach out for questions or suggestions!