beffroi-tools/docs/pptx-videos.md

64 lines
2.9 KiB
Markdown

# PPTX video reports
Extract videos and create Markdown and Ontime timing reports:
```sh
python3 tools/pptx_videos.py presentation.pptx
```
Generate one or more report formats without keeping newly extracted videos:
```sh
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
```sh
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](https://docs.getontime.no/quick-tips/import-export/).
- 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.