Beffroi tools, for everyday usage
Go to file
Dandaedre 06ee4e8cf8 Keep unassigned Midra layers available for geometry transfers 2026-11-14 18:13:02 +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 Keep unassigned Midra layers available for geometry transfers 2026-11-14 18:13:02 +01:00
docs Keep unassigned Midra layers available for geometry transfers 2026-11-14 18:13:02 +01:00
rundowns Track normalized rundown fixtures with corpus regression tests 2026-11-09 09:06:26 +01:00
scripts Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00
tests Organize documentation by tool and update references 2026-11-14 17:57:06 +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 Unify layer exchange and add optional ArtCraft native formats 2026-11-14 15:29:29 +01:00
LICENSE Initial commit 2026-10-20 09:17:31 +02:00
README.md Use absolute Gitea file links in README 2026-11-14 18:08:56 +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 · 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

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.

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.

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