beffroi-tools

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

Current version Test status Line coverage

Portable releases · Quick start · Documentation · 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 Ready-made canvases with two named 16:9 layers. Choose a size, then a format.
Browse Full HD and UHD 4K templates — SVG, draw.io, PPTX, FIG, AI, JSON, CSV, DXF and HTML These starter files contain two named 16:9 layers on an exact pixel canvas. - **Full HD — 1920 × 1080:** [SVG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.html) · [PPTX](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.pptx) · [Figma FIG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.fig) · [Illustrator AI](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.ai) - **UHD 4K — 3840 × 2160:** [SVG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.html) · [PPTX](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.pptx) · [Figma FIG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.fig) · [Illustrator AI](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.ai) PPTX and FIG samples contain an editable slide/frame; AI samples were generated with VectorCraft 0.24.1. Midra imports/exports Illustrator AI using an optional local VectorCraft CLI. See [formats, dependencies and licensing builds](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
## 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) |