# PPTX reporter
[Read the full manual →](https://books.dandaedre.com/manuals/pptx-reporter/)
[Documentation](../README.md) · [Changelog](changelog.md) · [Visual walkthrough](visual-guide.md) · [Report formats](report-formats.md)
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](visual-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 `_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](report-formats.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/README.md) for source checks and [releases](../development/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 `_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.