beffroi-tools/README.md

1.9 KiB

beffroi-tools

current version test status line coverage

Local document and media tools: a Rust PPTX video reporter with a drag-and-drop app, and Python tools for prototyping and document exports.

Quick start

On Windows, extract the portable ZIP and open pptx-reporter-gui.exe. Drop PPTX files or a video folder into the window, select report formats, and generate. Keep the bundled ffprobe.exe beside the app.

On macOS 13+, extract the portable ZIP for Apple Silicon (aarch64) or Intel (x86_64) and run ./pptx-reporter-gui. FFprobe is included; keep it beside the app. See macOS release details.

To run from source:

cargo run --locked --bin pptx-reporter-gui
cargo run --locked --bin pptx-reporter -- presentation.pptx --report all
cargo run --locked --bin pptx-reporter -- ./show --timings-only --report ontime
python3 tools/exporter.py presentation.pptx --output pdf,images

The reporter needs FFprobe (included in portable bundles); PDF generation is built in. The exporter needs DeckCraft for PPTX or PdfCraft for PDF input. Run source commands from the repository root; CLI tools support --help.

Visual guide

Follow the illustrated user guide →

Screenshots walk you through choosing a presentation, selecting formats, opening reports, and reading video timings.

More documentation