|
Gitea/pptx-reporter/pipeline/head This commit looks good
Details
|
||
|---|---|---|
| .cargo | ||
| crates/pptx-reporter | ||
| docs | ||
| scripts | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Cross.toml | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| coverage.toml | ||
| rust-release.toml | ||
README.md
PPTX Reporter
PPTX Reporter is a desktop application that turns the videos in a PowerPoint presentation—or a folder of ordinary video files—into a clear timing report. It can also extract embedded videos and prepare a rundown for Ontime.
You do not need PowerPoint, Python, or Typst. The desktop app guides you from the source files to finished reports.
Download the desktop app
PPTX Reporter v0.7.0 release notes and all downloads →
| Your computer | Portable desktop package |
|---|---|
| Windows 64-bit | Download ZIP |
| Linux 64-bit | Download TGZ |
| Apple Silicon Mac | Download ZIP |
| Intel Mac | Download ZIP |
Extract the complete archive before opening the application. The portable package includes the GUI, FFprobe, fonts, licenses, and a command-line version for optional automation.
On Windows, launch pptx-reporter-gui.exe. On Linux or macOS, launch
pptx-reporter-gui from the extracted folder. The Mac downloads are unsigned;
see the Mac launch instructions if
Gatekeeper blocks the application.
Create a report in the GUI
- Drop one or more
.pptxfiles, a video folder, or a folder containing presentations into the window. - Choose what to create and where to save it.
- Select the report formats you need.
- Click Generate reports.
The original presentation and videos are preserved.
Choose your output
The Create menu controls whether PPTX Reporter extracts embedded videos, creates reports, or does both.
| Choice | Use it when you want to… |
|---|---|
| Reports only | Read timings without keeping another copy of the videos |
| Extract + reports | Save the embedded videos and create timing reports |
| Extract only | Save embedded videos without producing reports |
The common report formats appear directly on the Setup screen:
- PDF creates an easy-to-share report.
- Markdown creates an editable text report.
- Ontime creates
timings.ontime.json, ready to import as a rundown. - More formats… offers a web page, compact PDF, JSON, plain text, Typst, and useful presets.
By default, output goes beside the first input. Use Change… to put it somewhere else.
Open the finished reports
When processing finishes, the Results tab lists every generated file. Use Open to view a report or Open output folder to see everything together. Expand Activity & diagnostics if the app reports a warning.
For a presentation named Showcase.pptx, the default output is:
Showcase_videos/
├── reports/ PDF, web, text, JSON and Ontime reports
└── videos/ extracted media, when requested
Reports follow slide order and account for PowerPoint start and end trims. Looping videos and unsupported timings remain visible, but they are excluded from finite playback totals and Ontime cues. Extracted media is not trimmed or otherwise changed.
Import a rundown into Ontime
Generate the Ontime format, then import
reports/timings.ontime.json through Editor → Project → Manage projects
in Ontime 4. Use this file instead of timings.json, which contains the
general report data.
See report formats and timing for skipped events and show start times.
If something does not work
- The Generate button is disabled: select an input and at least one report format, or choose Extract only.
- FFprobe cannot be found: keep the bundled executable beside the app, or choose it under Settings → FFprobe → Locate….
- A warning or failure appears: expand Activity & diagnostics to see the affected file and processing step.
- A report does not open: use Open output folder and open it with an installed PDF reader or browser. Ontime JSON must be imported into Ontime.
The illustrated user guide covers batches, progress, cancellation, existing files, and every report preset.
Optional command line use
The GUI is the main way to use PPTX Reporter. The portable package also contains
pptx-reporter.exe for scripts and repeatable batch jobs. Source builds can run
the same commands with cargo run --locked --bin pptx-reporter --:
# Reports for one presentation
pptx-reporter presentation.pptx --report all
# An Ontime rundown from a folder of videos
pptx-reporter ./show --timings-only --report ontime
# Extract embedded videos without reports
pptx-reporter presentation.pptx --extract-only
For batch behavior and exact playback semantics, see the complete reference.
Documentation and development
PPTX Reporter is open-source software under the MIT License. Its development includes LLM-generated or LLM-assisted work with human review, and it is used in professional settings. Report problems through GitHub Issues.



