94 lines
5.2 KiB
Markdown
94 lines
5.2 KiB
Markdown
# PPTX reporter
|
||
|
||
Create video timing reports from a PowerPoint presentation using the desktop
|
||
app or CLI. Python and PowerPoint are not required for the Rust application.
|
||
For a walkthrough with screenshots, see the [user guide](user-guide.md).
|
||
|
||
```sh
|
||
cargo run --locked --bin pptx-reporter-gui
|
||
cargo run --locked --bin pptx-reporter -- presentation.pptx --timings-only --report all
|
||
cargo run --locked --bin pptx-reporter -- presentation.pptx --extract-only
|
||
```
|
||
|
||
Drop PPTX files or a folder into the window, choose multiple presentations, or
|
||
use **Choose folder…**. Check the save location, choose
|
||
extraction/report mode, select formats, then use the purple action button.
|
||
The **Setup** tab contains inputs, output location, mode, and common formats.
|
||
**More formats…** offers every format and presets: Reading & printing selects
|
||
HTML, PDF and compact PDF; Defaults selects Markdown and Ontime. **Settings**
|
||
contains video replacement and FFprobe location controls. The action/progress
|
||
bar stays visible at the bottom. Successful runs open **Results**, with file
|
||
actions and collapsible diagnostics. The default window is 760 × 560; long
|
||
input/result lists scroll within their panes.
|
||
The app remembers options and the last eight presentations. Completed files
|
||
can be opened directly or their paths copied.
|
||
|
||
Progress estimates apply to the current counted phase. Cancel interrupts
|
||
FFprobe and stops between steps; an active PDF compilation finishes first.
|
||
Activity & diagnostics retains warnings and details.
|
||
|
||
## Files and dependencies
|
||
|
||
Output defaults to `<presentation>_videos/`, with `videos/` and `reports/`
|
||
subfolders. Reports are regenerated; extracted videos are reused unless
|
||
`--overwrite` is selected. Empty presentations create no output.
|
||
|
||
HTML, Markdown, plain text, JSON, Typst, PDF, compact PDF and Ontime are supported.
|
||
Durations account for per-shape trims. Loops and unsupported timing stay visible
|
||
in reports but are omitted from Ontime and playback totals. Extracted media
|
||
remains unchanged. See [report options and semantics](pptx-videos.md).
|
||
|
||
PDF compilation and fonts are embedded; no Typst installation or package
|
||
downloads are needed. FFprobe is discovered beside the app, in its `bin/`
|
||
subfolder, or on PATH. Override with `--ffprobe PATH` or Settings in the GUI.
|
||
|
||
On Windows, extract the whole portable ZIP and launch `pptx-reporter-gui.exe`.
|
||
`pptx-reporter.exe` provides the CLI and opens the GUI when given no arguments.
|
||
Linux desktop builds need windowing/OpenGL libraries at runtime.
|
||
|
||
See [development](development.md) for source checks and [releases](releases.md)
|
||
for Cross builds, packaging and dependency provenance.
|
||
|
||
## Batches and video folders
|
||
|
||
```sh
|
||
# Multiple presentations: sorted by filename regardless of argument order
|
||
pptx-reporter B.pptx A.pptx --timings-only --report ontime,json -o show-timings
|
||
# All PPTX files and video subfolders directly inside a folder
|
||
pptx-reporter ./show --timings-only --report ontime,json
|
||
# A single folder of videos, treated as one presentation
|
||
pptx-reporter ./clips --timings-only --report all
|
||
```
|
||
|
||
Each run creates one combined set of reports. In Ontime, batches have one named
|
||
group per presentation or video folder in a continuous rundown. Import
|
||
`reports/timings.ontime.json` once, then set the first cue's start time. Groups
|
||
with no eligible cues are omitted. The export follows Ontime’s
|
||
[group import structure](https://github.com/cpvalente/ontime/blob/master/apps/server/src/api-data/rundown/rundown.parser.ts). Original local slide numbers are retained;
|
||
source names prefix video names in combined reports. JSON includes `groups`
|
||
with zero-based `start` (inclusive) and `end` (exclusive) playback indices.
|
||
|
||
A video folder uses each supported video's full duration as one slide, in
|
||
natural filename order: `media2` precedes `media10`, and `media 2` precedes
|
||
`media 10`. This default also applies to presentations and subfolders in a batch,
|
||
and media names within the same PowerPoint slide. PowerPoint slide order is
|
||
preserved. Text remains case-sensitive; equal numeric values use the original
|
||
filename as a deterministic tie-breaker (for example, `media02` before `media2`). Non-video files are ignored. Supported extensions:
|
||
MP4, M4V, MOV, AVI, WMV, WebM, MPG, MPEG, MKV, ASF, 3GP and TS.
|
||
PowerPoint trims still apply to PPTX inputs; plain video files have no PowerPoint
|
||
trim or looping metadata. These are video timings, not slide-transition timings.
|
||
|
||
A parent folder includes its immediate PPTX files and immediate subfolders that
|
||
contain videos. Deeper folders are not traversed. A folder mixing loose videos
|
||
with presentations is rejected: select the inputs separately to make the order
|
||
explicit. Duplicate input paths are processed once. Legacy `.ppt` files are not
|
||
supported; save them as `.pptx` first.
|
||
|
||
The default output remains `<first-input>_videos/` (use `-o` to choose a batch
|
||
location). Copied/extracted batch media lives in numbered `001/videos/`,
|
||
`002/videos/`, … directories to avoid filename collisions. `--timings-only`
|
||
reads source videos directly and extracts PPTX media only temporarily.
|
||
`--extract-only` copies/extracts media without reports. Existing media is reused
|
||
unless `--overwrite` is set; keep input selection/order stable when reusing a
|
||
batch output folder, or choose a fresh output folder. Source files are preserved.
|