beffroi-tools/README.md

2.6 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, a spreadsheet rundown converter for Ontime, an ASCII filename cleaner, and Python 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
cargo run --locked -p rundown-converter --bin rundown-converter-gui
cargo run --locked -p ascii-names
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.

PPTX reporter visual guide

Follow the illustrated PPTX reporter guide →

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

More documentation