beffroi-tools/docs/pptx-videos.md

3.5 KiB

PPTX video reports

Extract videos and create Markdown and Ontime timing reports:

python3 tools/pptx_videos.py presentation.pptx

Generate one or more report formats without keeping newly extracted videos:

python3 tools/pptx_videos.py presentation.pptx --timings-only --report html,pdf
python3 tools/pptx_videos.py presentation.pptx --report all

--report accepts comma-separated formats and can be repeated. Markdown and Ontime are included by default; an explicit --report replaces this selection. Use --report all for every format, including both PDF layouts (requires Typst) and Ontime. Reports are saved as timings.* in <presentation-stem>_videos, or the directory supplied with -o. PDF uses the Typst CLI and retains timings.typ for editing. HTML and Typst/PDF include colored summary cards and pills; Markdown and TXT use aligned tables. JSON includes numeric durations in seconds, sizes in bytes, and slide references.

For a compact portrait PDF with slide numbers, media names, and duration pills:

python3 tools/pptx_videos.py presentation.pptx --timings-only --report pdf-dense

This creates timings-dense.pdf and its editable timings-dense.typ source. It has a discreet title containing the presentation name and no summary cards. Slide numbers and media names are plain text; only durations use pills. The duration caveat stays in a small footnote. Use --report pdf,pdf-dense to produce both layouts.

Timings require ffprobe (from FFmpeg); PDF additionally requires typst on PATH. Use --extract-only to extract without a report. Presentations with no embedded videos produce no output.

Ontime import

python3 tools/pptx_videos.py presentation.pptx --timings-only --report ontime

This writes timings.ontime.json, a native Ontime 4 project. It is separate from timings.json, which remains the general metadata report. Import it through Editor → Project → Manage projects. To bring the rundown into an existing project, import the file and use Partial Load. See Ontime's import instructions.

  • Each video/slide reference becomes an event, sorted by slide. A video reused on several slides gets an event for each slide; other timing reports still count each media file once.
  • Event cues contain the slide number, titles contain filenames, and notes identify the presentation and archive media path.
  • Durations retain milliseconds. Starts are linked, beginning at midnight; change the first playable event's start to your show time after import.
  • Unknown/invalid durations use zero and are marked skipped with a review note. Unreferenced videos appear last and are also skipped. Durations exceeding Ontime's 23:59:59 limit require manual review.
  • No automatic playback or external-media downloads are configured. Slides without embedded videos are not included. Add speaking time and apply any PowerPoint trims or loops in Ontime.

The export was checked against Ontime 4's native project-section parsers; Ontime 3 is not supported by this export schema.

Progress output

Interactive terminals show a single animated progress line with completed video count, elapsed time, and the current extraction/probing/report step. It clears when finished, leaving report paths, the final summary, and warnings/errors. Long operations keep animating. Redirecting either output stream uses ordinary line logs instead. NO_COLOR disables colors; TERM=dumb also disables animation.