PPT Win32COM Editor

The Specific Problem

When modifying existing PPT presentations, we often need to adjust fonts, unify colors, change paragraph spacing, or batch-replace text. However, libraries like python-pptx discard complex elements from the original file: gradient backgrounds, shadows, arrow connectors, FREEFORM shapes, and SmartArt. This ruins the professional appearance and breaks the original layout and visual effects.

Core Capabilities and Workflow

This skill uses win32com (PowerPoint COM interface) to directly edit the existing PPT file, preserving all elements. The core workflow includes:

• Backing up the original file: Automatically copy to *_backup.pptx before any modification.
• Opening with win32com: Launch PowerPoint via COM and load the target file.
• Executing modifications: Supports common operations such as:
• Replacing fonts globally
• Changing text colors throughout
• Adjusting paragraph spacing
• Iterating over all slides and text boxes for content editing
• Saving and closing: Save the file and close the COM connection after edits.

The key advantage is editing in place rather than rebuilding, thus retaining all shapes, images, connectors, and effects.

Applicability and Caveats

• Environment requirements: Must run on Windows with Microsoft PowerPoint (2016 or later) installed.
• COM exclusivity: PowerPoint cannot be in use by the user during operation to avoid COM interface conflicts.
• Color order: PowerPoint COM's .RGB property is actually BGR (blue-green-red), requiring conversion to the correct RGB value in code.
• 1-based indexing: For example, Slides(1) refers to the first slide, not starting from 0.
• Use case: Only for modifying existing PPTs; for new PPTs, use other tools like pptx-generator.

In summary, this skill is suitable for global beautification and batch editing tasks where preserving complex PPT elements is essential.