77 lines
3.4 KiB
Markdown
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.
|