beffroi-tools

Local tools for presentations, show timing, screen layouts and media workflows.

Current version Test status Line coverage

Portable releases · Quick start · Documentation · Manuals · What's new · Development

## Choose your tool
PPTX Reporter icon

PPTX Reporter

Inspect presentation videos, read playback timings, and export reports or Ontime rundowns.

Desktop app · CLI

Visual walkthrough · Guide · Report formats

Rundown Converter icon

Rundown Converter

Turn spreadsheet rundowns into Ontime schedules, with timing checks before export.

Desktop app · CLI

Guide · Sample findings

Midra Layout icon

Midra Layout

Arrange screen layers, exchange geometry, and review transfers to an Eikos 4K device.

Desktop app

Guide · Templates · Geometry formats

ASCII Names icon

ASCII Names

Clean up filenames to ASCII with paced renames, collision protection, and unchanged file contents.

Desktop app · CLI

Guide

Document Exporter icon

Document Exporter

Export PPTX to PDF or slide images, render PDF pages, and compress PDFs to a target size.

Python CLI

Guide and dependencies

MPC-HC Companion icon

MPC-HC Companion

Control Media Player Classic Home Cinema from Companion with playback actions and player feedback.

Companion 5.1 module

Setup and development

## Quick start **Start with a portable app:** see [release bundles and platform instructions](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md). For PPTX Reporter, extract the ZIP and open `pptx-reporter-gui.exe` on Windows or run `./pptx-reporter-gui` on macOS 13+. Choose the macOS archive for [Apple Silicon or Intel](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md#macos). Keep the bundled FFprobe beside the app. Drop a presentation or video folder into the reporter, choose report formats, and generate. The [illustrated guide](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/pptx-reporter/visual-guide.md) walks through each step; a [Windows quick start](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/pptx-reporter/windows-quickstart.txt) is also available.
Run from source — Rust apps and Python exporter Run these commands from the repository root: ```sh # PPTX Reporter: desktop, full report, or Ontime timings 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 # Other desktop apps cargo run --locked -p rundown-converter --bin rundown-converter-gui cargo run --locked -p midra-layout cargo run --locked -p ascii-names # Document exports python3 tools/exporter.py presentation.pptx --output pdf,images ``` The reporter needs FFprobe; PDF generation is built in. The exporter needs DeckCraft for PPTX or PdfCraft for PDF input. CLI tools support `--help`. See [development setup](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/README.md) for prerequisites and checks.
## Midra Layout templates [Browse all starter files →](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/README.md) Matching Full HD and UHD 4K layouts are available in SVG, draw.io, geometry JSON, CSV, DXF, HTML, PPTX, Figma FIG and Illustrator AI. The catalog contains every base file, import guidance and format dependencies. ## Explore further | Resource | Links | | --- | --- | | Updates | [Per-tool changelogs](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/changelogs.md) | | Build and contribute | [Development](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/README.md) · [CI and coverage](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/ci.md) · [Cross builds and releases](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md) | | Desktop integration | [App icons and launchers](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md#application-artwork) | | Midra internals | [Project format](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/interfaces/midra-layout.md) · [Device checks](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/midra-layout/device-check.md) · [Plan](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/midra-layout/plan.md) | | What's next | [Ideas](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/Ideas.md) · [Program task list](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/planning/program-task-list.md) |