pptx-image-compress/README.md

PPTX Image Compressor (CaesiumCLT only)

Version 1.0.0

Dieses Paket enthält:

PPTX-Image-Compressor-1.0.0/
├─ README.md
├─ install_and_run.bat
├─ pptx_image_compress.py
├─ bin/
│  └─ PUT_caesiumclt_here.txt
└─ samples/
   └─ README.txt

Schnellstart (ohne Admin-Rechte)

1. Lege caesiumclt.exe in den Ordner bin/ oder sorge dafür, dass es im PATH liegt.
2. Doppelklicke install_and_run.bat oder rufe es in CMD/PowerShell auf, z. B.:

install_and_run.bat -i "C:\Slides\Deck.pptx" -t 8

Die Batch lädt bei Bedarf automatisch das Windows Embeddable Python Package, entpackt es lokal und führt das Tool aus.

Was das Tool macht

• Entpackt die PPTX in einen Temp‑Ordner
• Komprimiert JPG/JPEG, PNG, WebP mit CaesiumCLT (-q 90, -O bigger)
• Ersetzt Bilder nur, wenn die komprimierte Datei kleiner ist
• Schreibt ein CSV‑Log (.log neben der Output‑PPTX)
• Baut eine neue PPTX und zeigt eine Summary (Name, Größe vorher/nachher, Ersparnis %, Zeit)
• Räumt alle temporären Dateien auf (keine Caesium‑Tempfiles in der finalen PPTX)

Hinweise

• GIF wird übersprungen (keine Rekodierung).
• -t steuert die Parallelität (Python‑Threads); intern wird caesiumclt --threads 1 gesetzt, sobald -t > 1, um Oversubscription zu vermeiden.

Manuelle Nutzung des .py (falls Python vorhanden)

python pptx_image_compress.py -i "C:\Pfad\input.pptx" -t 8

Quellen & Tools

• CaesiumCLT – Projekt/Downloads: https://github.com/Lymphatus/caesium-clt
• Windows Embeddable Python Package – Doku/Downloads: https://docs.python.org/3/using/windows.html