Metadata-Version: 2.4
Name: pptxtoimages
Version: 0.1.1
Summary: Convert .pptx presentations to image files easily.
Author: Burak Civelek
License: MIT
Keywords: pptx,converter,slides,images,python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pdf2image
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# pptxtoimages

[![PyPI version](https://img.shields.io/pypi/v/pptxtoimages.svg)](https://pypi.org/project/pptxtoimages/)
[![License](https://img.shields.io/github/license/brkcvlk/pptxtoimages.svg)](LICENSE)

## 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](https://www.libreoffice.org/) (`soffice` command available in your system PATH)  
- [Poppler](https://poppler.freedesktop.org/) utilities installed (`poppler-utils` on Linux)

Then install the package via pip:

```bash
    pip install pptxtoimages
```
---

## Usage
### Python

```
    from pptxtoimages.tools.convert import Converter

    # Initialize converter
    converter = Converter()

    # Convert your .pptx file to images
    images = converter.pptx_to_images("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!



