Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

All manuals

PPTX reporter

Read the full manual →

Documentation · Changelog · Visual walkthrough · Report formats

Application icon

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.

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.

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 for source checks and releases for Cross builds, packaging and dependency provenance.

Batches and video folders

# 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. 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.