explaingit

guopenglin/image2ppt

★ 13PythonAudience · developerComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

Python tool that converts slide images into editable PowerPoint files, extracting text as real text boxes and images as movable objects.

Mindmap

mindmap
  root((repo))
    What it does
      Image to PPT conversion
      Text extraction via OCR
      Asset segmentation
    How to use
      Standalone CLI tool
      Agent skill integration
      Batch processing
    Tech stack
      Python
      OCR engine
      LibreOffice/Poppler
    Input/Output
      PNG JPG WebP formats
      Editable PPTX files
      Extracted assets folder
    Use cases
      Convert GPT screenshots
      Rebuild slide decks
      Batch image processing

Things people build with this

USE CASE 1

Convert screenshots of AI-generated slides into editable PowerPoint presentations you can customize.

USE CASE 2

Batch process dozens of slide images into separate PPTX files without manual recreation.

USE CASE 3

Extract text and images from slide photos to rebuild them as native PowerPoint objects.

USE CASE 4

Integrate slide conversion as a skill for AI agents like Claude Code or Codex.

Tech stack

PythonOCRLibreOfficePopplerpython-pptx

Getting it running

Difficulty · moderate Time to first run · 30min

Requires installing Python dependencies and a local OCR stack; macOS and Linux have direct support, Windows requires manual setup via requirements file.

Free for personal use, copying, and modification with attribution; commercial use, redistribution, SaaS, and production deployments require a paid commercial license from the author.

In plain English

DeckWeaver is a Python tool that takes images of slides, such as the screenshots that GPT or Gemini might produce, and rebuilds them as editable PowerPoint files. The README is mostly in Chinese, with an English version available in a separate file. Almost all text on the input images is recreated as real PPT text boxes, and the icons, logos, pictures, and decorative elements are extracted as separate image objects that you can move or replace inside PowerPoint. The project pitches two main use cases. The first is using it as a Skill or tool for an agent like Codex or Claude Code: you clone the repo into your skill directory, point the agent at a folder or a single image, and the agent runs the conversion through a bootstrap script. The second is using it as a standalone command line tool for people who do not want to spend tokens on a large model, do not need perfect text accuracy, and want to process many images in batch. The README says the heavy work runs locally. OCR, image segmentation, PPTX generation, and a preview check all happen on your own machine, so no cloud API key is required. It accepts common bitmap formats such as PNG, JPG, WebP, BMP, and TIFF. A bootstrap script installs Python dependencies, a local OCR stack, and LibreOffice or Poppler for preview rendering. macOS and common Linux distributions are supported directly, while Windows users are pointed at the requirements file for manual setup. A convert script is the one shot entry point, and there are flags to limit pages, skip rendering, try to detect tables, or export icon decisions for human review. The results land in an output_project folder that includes the final pptx, a structure check report, preview images, OCR files, layout JSON, and extracted assets. The author notes that complex charts are kept as movable image objects rather than rebuilt as native PPT charts. The license section says personal use, copying, and modification are free, but copies and derivatives must keep the original credit, license, and repo link. Commercial use, redistribution, SaaS integration, and internal production deployments require contacting the author for a paid commercial license at the email in the README.

Copy-paste prompts

Prompt 1
I have 50 PNG screenshots of slides. How do I use image2ppt to batch convert them all to PowerPoint files at once?
Prompt 2
Show me how to set up image2ppt as a skill in my agent's directory so Claude Code can convert slide images automatically.
Prompt 3
What flags can I pass to the convert script to skip preview rendering and detect tables in my slide images?
Prompt 4
I want to review which icons were extracted from my slides before finalizing the PPTX. How do I export icon decisions for human review?
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.