136 lines
8.2 KiB
Markdown
136 lines
8.2 KiB
Markdown
<h1 align="center">beffroi-tools</h1>
|
||
|
||
<p align="center">Local tools for presentations, show timing, screen layouts and media workflows.</p>
|
||
|
||
<p align="center">
|
||
<img src="https://assets.dandaedre.com/coverage/Beffroi/beffroi-tools/main/version.svg" alt="Current version">
|
||
<img src="https://assets.dandaedre.com/coverage/Beffroi/beffroi-tools/main/test.svg" alt="Test status">
|
||
<img src="https://assets.dandaedre.com/coverage/Beffroi/beffroi-tools/main/coverage.svg" alt="Line coverage">
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="docs/development/releases.md">Portable releases</a> ·
|
||
<a href="#quick-start">Quick start</a> ·
|
||
<a href="docs/README.md">Documentation</a> ·
|
||
<a href="docs/changelogs.md">What's new</a> ·
|
||
<a href="docs/development/README.md">Development</a>
|
||
</p>
|
||
|
||
## Choose your tool
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<a href="docs/pptx-reporter/README.md"><img src="crates/pptx-reporter/assets/app-icon.png" width="72" height="72" alt="PPTX Reporter icon"></a>
|
||
<h3><a href="docs/pptx-reporter/README.md">PPTX Reporter</a></h3>
|
||
<p>Inspect presentation videos, read playback timings, and export reports or Ontime rundowns.</p>
|
||
<p><strong>Desktop app · CLI</strong></p>
|
||
<p><a href="docs/pptx-reporter/visual-guide.md">Visual walkthrough</a> · <a href="docs/pptx-reporter/README.md">Guide</a> · <a href="docs/pptx-reporter/report-formats.md">Report formats</a></p>
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<a href="docs/rundown-converter/README.md"><img src="crates/rundown-converter/assets/app-icon.png" width="72" height="72" alt="Rundown Converter icon"></a>
|
||
<h3><a href="docs/rundown-converter/README.md">Rundown Converter</a></h3>
|
||
<p>Turn spreadsheet rundowns into Ontime schedules, with timing checks before export.</p>
|
||
<p><strong>Desktop app · CLI</strong></p>
|
||
<p><a href="docs/rundown-converter/README.md">Guide</a> · <a href="docs/rundown-converter/corpus.md">Sample findings</a></p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<a href="docs/midra-layout/README.md"><img src="crates/midra-layout/assets/app-icon.png" width="72" height="72" alt="Midra Layout icon"></a>
|
||
<h3><a href="docs/midra-layout/README.md">Midra Layout</a></h3>
|
||
<p>Arrange screen layers, exchange geometry, and review transfers to an Eikos 4K device.</p>
|
||
<p><strong>Desktop app</strong></p>
|
||
<p><a href="docs/midra-layout/README.md">Guide</a> · <a href="#midra-layout-templates">Templates</a> · <a href="docs/interfaces/midra-layout-exchange.md">Geometry formats</a></p>
|
||
</td>
|
||
<td valign="top">
|
||
<a href="docs/ascii-names/README.md"><img src="crates/ascii-names/assets/app-icon.png" width="72" height="72" alt="ASCII Names icon"></a>
|
||
<h3><a href="docs/ascii-names/README.md">ASCII Names</a></h3>
|
||
<p>Clean up filenames to ASCII with paced renames, collision protection, and unchanged file contents.</p>
|
||
<p><strong>Desktop app · CLI</strong></p>
|
||
<p><a href="docs/ascii-names/README.md">Guide</a></p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<a href="docs/exporter/README.md"><img src="tools/assets/exporter/app-icon.png" width="72" height="72" alt="Document Exporter icon"></a>
|
||
<h3><a href="docs/exporter/README.md">Document Exporter</a></h3>
|
||
<p>Export PPTX to PDF or slide images, render PDF pages, and compress PDFs to a target size.</p>
|
||
<p><strong>Python CLI</strong></p>
|
||
<p><a href="docs/exporter/README.md">Guide and dependencies</a></p>
|
||
</td>
|
||
<td valign="top">
|
||
<a href="companion-modules/media-player-classic/README.md"><img src="companion-modules/media-player-classic/companion/assets/app-icon.png" width="72" height="72" alt="MPC-HC Companion icon"></a>
|
||
<h3><a href="companion-modules/media-player-classic/README.md">MPC-HC Companion</a></h3>
|
||
<p>Control Media Player Classic Home Cinema from Companion with playback actions and player feedback.</p>
|
||
<p><strong>Companion 5.1 module</strong></p>
|
||
<p><a href="companion-modules/media-player-classic/README.md">Setup and development</a></p>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
## Quick start
|
||
|
||
**Start with a portable app:** see [release bundles and platform instructions](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](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](docs/pptx-reporter/visual-guide.md) walks through each step;
|
||
a [Windows quick start](docs/pptx-reporter/windows-quickstart.txt) is also available.
|
||
|
||
<details>
|
||
<summary><strong>Run from source</strong> — Rust apps and Python exporter</summary>
|
||
|
||
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](docs/development/README.md) for prerequisites and checks.
|
||
|
||
</details>
|
||
|
||
## Midra Layout templates
|
||
|
||
Ready-made canvases with two named 16:9 layers. Choose a size, then a format.
|
||
|
||
<details>
|
||
<summary><strong>Browse Full HD and UHD 4K templates</strong> — SVG, draw.io, PPTX, FIG, AI, JSON, CSV, DXF and HTML</summary>
|
||
|
||
These starter files contain two named 16:9 layers on an exact pixel canvas.
|
||
|
||
- **Full HD — 1920 × 1080:** [SVG](docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-1080p-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-1080p-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-1080p-2-layers.fig) · [Illustrator AI](docs/templates/midra-layout/midra-layout-1080p-2-layers.ai)
|
||
- **UHD 4K — 3840 × 2160:** [SVG](docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-4k-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-4k-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-4k-2-layers.fig) · [Illustrator AI](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](docs/interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
|
||
|
||
</details>
|
||
|
||
## Explore further
|
||
|
||
| Resource | Links |
|
||
| --- | --- |
|
||
| Updates | [Per-tool changelogs](docs/changelogs.md) |
|
||
| Build and contribute | [Development](docs/development/README.md) · [CI and coverage](docs/development/ci.md) · [Cross builds and releases](docs/development/releases.md) |
|
||
| Desktop integration | [App icons and launchers](docs/development/releases.md#application-artwork) |
|
||
| Midra internals | [Project format](docs/interfaces/midra-layout.md) · [Device checks](docs/midra-layout/device-check.md) · [Plan](docs/midra-layout/plan.md) |
|
||
| What's next | [Ideas](Ideas.md) · [Program task list](docs/planning/program-task-list.md) |
|