beffroi-tools/README.md

12 KiB

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. 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. Keep the bundled FFprobe beside the app.

Drop a presentation or video folder into the reporter, choose report formats, and generate. The illustrated guide walks through each step; a Windows quick start is also available.

Run from source — Rust apps and Python exporter

Run these commands from the repository root:

# 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 for prerequisites and checks.

Canvas Pilot now has its own repository. Build and run it there.

Canvas Pilot templates

Download all templates as ZIP · Browse individual starter files →

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.

Explore further

Resource Links
Updates Per-tool changelogs
Build and contribute Development · CI and coverage · Cross builds and releases
Desktop integration App icons and launchers
Midra internals Project format · Device checks · Plan
What's next Ideas · Program task list