Beffroi tools, for everyday usage
Go to file
Dandaedre c9880a5aeb
Beffroi/beffroi-tools/pipeline/head This commit looks good Details
Simplify layer import review and destination scopes
2026-11-14 21:35:43 +01:00
.cargo Unify layer exchange and add optional ArtCraft native formats 2026-11-14 15:29:29 +01:00
companion-modules/media-player-classic Add generated app icons and cross-platform desktop launchers 2026-11-14 14:14:59 +01:00
crates Simplify layer import review and destination scopes 2026-11-14 21:35:43 +01:00
docs Simplify layer import review and destination scopes 2026-11-14 21:35:43 +01:00
rundowns Track normalized rundown fixtures with corpus regression tests 2026-11-09 09:06:26 +01:00
scripts Build and publish project mdBook manuals through Jenkins 2026-11-14 20:44:11 +01:00
tests Build and publish project mdBook manuals through Jenkins 2026-11-14 20:44:11 +01:00
tools Add generated app icons and cross-platform desktop launchers 2026-11-14 14:14:59 +01:00
.gitignore Track normalized rundown fixtures with corpus regression tests 2026-11-09 09:06:26 +01:00
AGENTS.md Add concise per-tool changelogs and documentation index 2026-11-14 11:32:03 +01:00
Cargo.lock Release v0.6.0 Midra Layout milestone 2026-11-14 18:08:22 +01:00
Cargo.toml Release v0.6.0 Midra Layout milestone 2026-11-14 18:08:22 +01:00
Cross.toml Add Rust reporter desktop trial and coverage CI 2026-10-20 13:11:39 +02:00
Ideas.md Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00
Jenkinsfile Build and publish project mdBook manuals through Jenkins 2026-11-14 20:44:11 +01:00
LICENSE Initial commit 2026-10-20 09:17:31 +02:00
README.md Build and publish project mdBook manuals through Jenkins 2026-11-14 20:44:11 +01:00
coverage.toml Organize Rust workspace and finalize CI and documentation 2026-10-20 14:33:56 +02:00
rust-release-rundown.toml Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00
rust-release.toml Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00

README.md

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

Midra Layout templates

Browse all starter files →

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
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