maryamma94/ppt-generator repository overview

This tool converts a set of images into a PowerPoint presentation using a predefined template. It is fully containerised with Docker, so no Python or PowerPoint installation is required.

⁠Requirements

• Docker
  • Windows / macOS: Docker Desktop
  • Linux: Docker Engine

⁠Folder Setup

Create a working directory anywhere on your computer and add two subfolders:

your-folder/ ├── fig_results/ └── output/

• fig_results/ Place all images (.png, .jpg, .jpeg) you want to include in the PowerPoint here.

• output/ The generated PowerPoint file (.pptx) will be saved here.

⁠Pull the Docker Image (One-Time Step)

Run the following command to download the image from Docker Hub:

docker pull maryamma94/ppt-generator:latest

Run the PowerPoint Generator Run the command from inside your-folder.

⁠Windows (PowerShell)

docker run --rm `
  -v "${PWD}\fig_results:/app/fig_results" `
  -v "${PWD}\output:/app/output" `
  maryamma94/ppt-generator:latest

⁠Linux / macOS

docker run --rm \
  -v "$(pwd)/fig_results:/app/fig_results" \
  -v "$(pwd)/output:/app/output" \
  maryamma94/ppt-generator:latest

⁠Output

• A new PowerPoint file (.pptx) will be created in the output/ folder
• Each run generates a new PowerPoint file
• One slide is created per image
• Images are resized to fit the slide while preserving aspect ratio