2.9 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 html,typst,pdf,md,txt,json,ontime
--report accepts comma-separated formats and can be repeated. Markdown and
Ontime are included by default; an explicit --report replaces this selection.
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.
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.