beffroi-tools/docs/pptx-videos.md

77 lines
3.4 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 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 only slide numbers and duration pills:
```sh
python3 tools/pptx_videos.py presentation.pptx --timings-only --report pdf-dense
```
This creates `timings-dense.pdf` and its editable `timings-dense.typ` source.
There are no summary cards or video metadata columns. Slide numbers 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
```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.