wps-ppt-automation

# WPS/PowerPoint Automation (Windows)

Use the bundled Python script to control PowerPoint or WPS Presentation via COM.

## Requirements

- Windows with **Microsoft PowerPoint** or **WPS Presentation** installed.
- Python + **pywin32** (`python -m pip install pywin32`).

## Quick start

```bash
python {baseDir}/scripts/wps_ppt_automation.py read --input "C:\path\file.pptx"
python {baseDir}/scripts/wps_ppt_automation.py export --input "C:\path\file.pptx" --format pdf --output "C:\path\out.pdf"
```

## Commands

### read
Extract all slide text.

```bash
python {baseDir}/scripts/wps_ppt_automation.py read --input "C:\path\file.pptx" --output "C:\path\out.txt"
```

### notes
Extract speaker notes.

```bash
python {baseDir}/scripts/wps_ppt_automation.py notes --input "C:\path\file.pptx" --output "C:\path\notes.txt"
```

### outline
Export slide titles as outline.

```bash
python {baseDir}/scripts/wps_ppt_automation.py outline --input "C:\path\file.pptx" --output "C:\path\outline.txt"
```

### export
Export to PDF or images (PNG).

```bash
python {baseDir}/scripts/wps_ppt_automation.py export --input "C:\path\file.pptx" --format pdf --output "C:\path\out.pdf"
python {baseDir}/scripts/wps_ppt_automation.py export --input "C:\path\file.pptx" --format images --outdir "C:\out\slides"
```

### replace
Find/replace text across slides.

```bash
python {baseDir}/scripts/wps_ppt_automation.py replace --input "C:\path\file.pptx" --find "old" --replace "new" --save "C:\path\out.pptx"
```

### slides
Insert or delete slides.

```bash
python {baseDir}/scripts/wps_ppt_automation.py insert-slide --input "C:\path\file.pptx" --index 2 --save "C:\path\out.pptx"
python {baseDir}/scripts/wps_ppt_automation.py delete-slide --input "C:\path\file.pptx" --index 3 --save "C:\path\out.pptx"
```

### font
Unify font name/size across slides.

```bash
python {baseDir}/scripts/wps_ppt_automation.py font --input "C:\path\file.pptx" --name "Microsoft YaHei" --size 20 --save "C:\path\out.pptx"
```

### theme
Apply a theme (.thmx).

```bash
python {baseDir}/scripts/wps_ppt_automation.py theme --input "C:\path\file.pptx" --theme "C:\path\theme.thmx" --save "C:\path\out.pptx"
```

### extract-images
Export embedded images.

```bash
python {baseDir}/scripts/wps_ppt_automation.py extract-images --input "C:\path\file.pptx" --outdir "C:\out\images"
```

## Notes

- If WPS is installed, try `--app wps`; otherwise default uses PowerPoint.
- Use `--visible true` if you need to watch the UI.
- Avoid batch usage; this skill is for single-presentation operations.