beffroi-tools

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

Current version Test status Line coverage

Portable releases · Quick start · Documentation · Full 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

Full manual · Visual walkthrough · Guide · Report formats

Rundown Converter icon

Rundown Converter

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

Desktop app · CLI

Full manual · Guide · Sample findings

Canvas Pilot icon

Canvas Pilot

Arrange screen layers, exchange geometry, and review transfers to Midra and Aquilon devices.

Desktop app · separate repository

Full manual · 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

Full manual · 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

Full manual · 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

Full manual · Setup and development

PDF Presenter icon

PDF Presenter

Standalone multiscreen PDF presenter project, inspired by Pympress and PowerPoint workflows.

Repository foundation · separate repository · access required

PDF rendering and desktop presentation are planned. Implementation plan · Development and CI

## 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 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.
Canvas Pilot now has its own [repository](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot). Build and run it there. ## Canvas Pilot templates [**Download all templates as ZIP**](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/raw/branch/main/docs/templates/canvas-pilot/canvas-pilot-all-templates.zip) · [Browse individual starter files →](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/branch/main/docs/templates/canvas-pilot/README.md) Matching Full HD and UHD 4K layouts are available in SVG, draw.io, geometry JSON, CSV, DXF/DWG, HTML, PPTX, Figma FIG, FigCraft and Illustrator AI. The catalog contains every base file, import guidance and format dependencies. **Prefer SVG for Illustrator exchange.** AI is an optional compatibility target and requires a separately installed **VectorCraft CLI** for import and export. [AI requirements and setup](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/branch/main/docs/canvas-pilot/guide/files.md#illustrator-ai-optional-converter-required). ## 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/idle-org/canvas-pilot/src/branch/main/docs/interfaces/canvas-pilot.md) · [Device checks](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/branch/main/docs/canvas-pilot/device-check.md) · [Plan](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/branch/main/docs/canvas-pilot/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) |