# pptxtoimages
[](https://pypi.org/project/pptxtoimages/)
[](https://pepy.tech/project/pptxtoimages)
[](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 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. Install pre-commit hooks (optional but recommended)
- This ensures your code is auto-formatted (e.g., by black) before each commit.
### Versioning
- You may use `bump2version` to suggest version changes only if authorized by the project maintainer.
Please respect versioning boundaries – we welcome contributions, but all official releases are maintained and approved manually by the maintainer.
6. Open a pull request
---
## Links
- **[Download on PyPI](https://pypi.org/project/pptxtoimages/)**
- **[View Download Stats](https://pepy.tech/project/pptxtoimages)**
- **[View Source on GitHub](https://github.com/brkcvlk/pptxtoimages)**
- **[Report Issues](https://github.com/brkcvlk/pptxtoimages/issues)**
## Support This Project
If you find pptxtoimages helpful or useful, please consider giving it a star on GitHub!
Your support helps the project grow and motivates further development.
- **[Star this project on GitHub](https://github.com/brkcvlk/pptxtoimages)**
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact
Created by Burak Civelek
Feel free to reach out for questions or suggestions!
Raw data
{
"_id": null,
"home_page": null,
"name": "pptxtoimages",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "pptx, converter, slides, images, python",
"author": "Burak Civelek",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1b/7c/83cb220bc36d56a8442522fd32785ec4e2e0cc9ff00475acb1a3d3aedfdb/pptxtoimages-0.1.14.tar.gz",
"platform": null,
"description": "# pptxtoimages\n\n[](https://pypi.org/project/pptxtoimages/)\n[](https://pepy.tech/project/pptxtoimages)\n[](LICENSE)\n\n## Overview\n\n**pptxtoimages** is a lightweight Python package to convert `.pptx` PowerPoint presentations into high-quality image files (PNG by default). \nIt uses LibreOffice (`soffice`) to convert `.pptx` files to PDF, then converts PDF pages to images using `pdf2image`. \n\nThis 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.\n\n---\n\n## Features\n\n- Convert `.pptx` slides to images automatically \n- Output images saved in PNG format by default \n- Supports batch processing of multi-slide presentations \n- Cross-platform support (Windows, Linux, macOS) with LibreOffice installed \n- CLI support for quick command line usage \n\n---\n\n## Installation\n\nMake sure you have the following prerequisites installed:\n\n- [LibreOffice](https://www.libreoffice.org/) (`soffice` command available in your system PATH) \n- [Poppler](https://poppler.freedesktop.org/) utilities installed (`poppler-utils` on Linux)\n\nThen install the package via pip:\n\n```bash\n pip install pptxtoimages\n```\n---\n\n## Usage\n### Python\n\n```\n from pptxtoimages.tools import PPTXToImageConverter\n\n # Initialize converter\n converter = PPTXToImageConverter(pptx_path)\n\n # Convert your .pptx file to images\n images = converter.convert(\"path/to/presentation.pptx\", output_dir=\"output_images\")\n\n print(f\"Converted {len(images)} slides to images.\")\n```\n\n### Command Line Interface (CLI)\nConvert a pptx file directly from the terminal :\n\n```\n pptxtoimages-cli path/to/presentation.pptx --output output_images\n```\n\nNote : For more examples and details, please check the ```example.py``` file.\n\n\n\n---\n\n## Configuration \n- Output image format is PNG by default, but can be customized in the Converter class parameters.\n\n- Output directory will be created if it does not exist.\n\n## Development\n\n#### To contribute or develop locally:\n\n1. Clone the repository\n2. Create a virtual environment and activate it\n3. Install dependencies:\n```\n pip install -r requirements.txt\n```\n4. Install pre-commit hooks (optional but recommended)\n - This ensures your code is auto-formatted (e.g., by black) before each commit.\n### Versioning\n- You may use `bump2version` to suggest version changes only if authorized by the project maintainer.\nPlease respect versioning boundaries \u2013 we welcome contributions, but all official releases are maintained and approved manually by the maintainer.\n\n6. Open a pull request\n\n---\n## Links\n\n- **[Download on PyPI](https://pypi.org/project/pptxtoimages/)**\n- **[View Download Stats](https://pepy.tech/project/pptxtoimages)**\n- **[View Source on GitHub](https://github.com/brkcvlk/pptxtoimages)**\n- **[Report Issues](https://github.com/brkcvlk/pptxtoimages/issues)**\n\n## Support This Project\nIf you find pptxtoimages helpful or useful, please consider giving it a star on GitHub!\nYour support helps the project grow and motivates further development.\n\n- **[Star this project on GitHub](https://github.com/brkcvlk/pptxtoimages)**\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n\n## Contact\n\nCreated by Burak Civelek\n\nFeel free to reach out for questions or suggestions!\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Convert .pptx presentations to image files easily.",
"version": "0.1.14",
"project_urls": {
"Bug Report": "https://github.com/brkcvlk/pptxtoimages/issues",
"Documentation": "https://github.com/brkcvlk/pptxtoimages#readme",
"Download Stats": "https://pepy.tech/project/pptxtoimages",
"Source": "https://github.com/brkcvlk/pptxtoimages"
},
"split_keywords": [
"pptx",
" converter",
" slides",
" images",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7941ae11b9c3c7e444269ddd2798999a1964bab810f56ffca59d5ed5480deaa7",
"md5": "fb65eeae7ca2a0479b0c988c8eff83ae",
"sha256": "46ea2a0d142e057c896fa56c3a1b91169c2281e5260d5bb3ec4d87c3c098090d"
},
"downloads": -1,
"filename": "pptxtoimages-0.1.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fb65eeae7ca2a0479b0c988c8eff83ae",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5977,
"upload_time": "2025-07-16T15:54:48",
"upload_time_iso_8601": "2025-07-16T15:54:48.424287Z",
"url": "https://files.pythonhosted.org/packages/79/41/ae11b9c3c7e444269ddd2798999a1964bab810f56ffca59d5ed5480deaa7/pptxtoimages-0.1.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1b7c83cb220bc36d56a8442522fd32785ec4e2e0cc9ff00475acb1a3d3aedfdb",
"md5": "293be78bcefdfeeb416d54768bd7b830",
"sha256": "f3d6c8bed87c6131fd94ca1ed56e8cf1c2d3b3aab7813a5a4fc3934370588c32"
},
"downloads": -1,
"filename": "pptxtoimages-0.1.14.tar.gz",
"has_sig": false,
"md5_digest": "293be78bcefdfeeb416d54768bd7b830",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 5414,
"upload_time": "2025-07-16T15:54:49",
"upload_time_iso_8601": "2025-07-16T15:54:49.370193Z",
"url": "https://files.pythonhosted.org/packages/1b/7c/83cb220bc36d56a8442522fd32785ec4e2e0cc9ff00475acb1a3d3aedfdb/pptxtoimages-0.1.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 15:54:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brkcvlk",
"github_project": "pptxtoimages",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pdf2image",
"specs": []
},
{
"name": "bump2version",
"specs": []
},
{
"name": "black",
"specs": []
},
{
"name": "pre-commit",
"specs": []
}
],
"lcname": "pptxtoimages"
}
JSON
