pptd_utils

Offline PPTD toolkit — full-spec .pptd → .pptx converter + slide image export (collage / single slide). Pure Python, no browser required.

Built against the PPTD v2 spec (skills/cowork-ppt/reference/pptd.md, relative to the repo root).

Install / dependencies

pip install python-pptx Pillow PyYAML

Optional (graceful fallback if missing):

Slide images additionally need LibreOffice (soffice on PATH).

CLI

Install from PyPI:

python -m pip install pptd-utils

Commands write beside the input path. all is the default; selections accept comma-separated 1-based slide numbers.

pptd check deck.pptd
pptd pptx deck.pptd
pptd png deck.pptd                 # all slides -> deck-png/
pptd png 1,2,3 deck.pptd           # selected slides -> deck-png/
pptd png collage deck.pptd         # contact sheet -> deck-collage.png
pptd pdf deck.pptd                 # all slides -> deck.pdf
pptd pdf 1,2,3 deck.pptd            # selected slides -> deck.pdf

PNG and PDF export require LibreOffice (soffice on PATH).

Python API

from pptd_utils import convert, build, verify
from pptd_utils import slides_image

convert("deck.pptd", "out.pptx")          # build + verify + print summary
build("deck.pptd", "out.pptx")            # -> (n_slides, n_fonts)
verify("deck.pptd", "out.pptx")           # structural self-check (asserts)

slides_image.render_collage("deck.pptd", "collage.png",
                            tile_w=480, gap=20, bg="#1F2430")
slides_image.render_slide("deck.pptd", 3, "slide3.png")
slides_image.render_slide_images("deck.pptd", "outdir/",
                                 slides=[1, 3, 5])   # -> [(n, Path), ...]

Supported features (PPTD v2)

How it works

• pptx generation: python-pptx + hand-built DrawingML for fills/effects/ordering; charts created via real chart parts (editable in PowerPoint) then plot XML rewritten; unsupported chart types rasterized at 2× and placed as pictures.
• images: each slide isolated into a one-slide pptx, rendered by LibreOffice headless, composed by Pillow. (ponytail: one soffice run per slide — switch to single PDF + PyMuPDF for large decks.)

Test

python3 tests/run.py   # converts full-spec fixture + minimal + ml-smp, asserts structure

Fixture tests/fixtures/full/ exercises every feature area — use it as a syntax reference for your own decks.

Notes

• Downloads (FA fonts, URL images/fonts) cache under ~/.cache/pptd_utils/.
• Defaults follow the spec: MiSans font family, 18pt body, black text.