Compare commits

..

No commits in common. "main" and "v0.2.0" have entirely different histories.
main ... v0.2.0

10 changed files with 97 additions and 237 deletions

155
README.md
View File

@ -4,149 +4,50 @@
![test status](https://assets.dandaedre.com/coverage/idle-org/pptx-reporter/main/test.svg)
![line coverage](https://assets.dandaedre.com/coverage/idle-org/pptx-reporter/main/coverage.svg)
**PPTX Reporter is a desktop application** that turns the videos in a
PowerPoint presentation—or a folder of ordinary video files—into a clear timing
report. It can also extract embedded videos and prepare a rundown for
[Ontime](https://www.getontime.no/).
You do not need PowerPoint, Python, or Typst. The desktop app guides you from
the source files to finished reports.
PPTX Reporter creates video timing reports from PowerPoint presentations and
media folders. It provides a desktop interface and CLI, exports readable HTML,
PDF and JSON reports, and can build grouped Ontime rundowns.
<p align="center">
<img src="crates/pptx-reporter/assets/app-icon.png" width="128" alt="PPTX Reporter icon">
</p>
## Download the desktop app
## Install
[**PPTX Reporter v0.7.0 release notes and all downloads →**](https://github.com/idle-org/pptx-reporter/releases/tag/v0.7.0)
Download a portable package from [Gitea Releases](https://proxy.dandaedre.com/gitea/idle-org/pptx-reporter/releases).
The portable packages include FFprobe and the required notices. On Windows,
extract the complete archive and launch `pptx-reporter-gui.exe`.
| Your computer | Portable desktop package |
| --- | --- |
| Windows 64-bit | [Download ZIP](https://github.com/idle-org/pptx-reporter/releases/download/v0.7.0/pptx-reporter-portable-x86_64-pc-windows-gnu-v0.7.0.zip) |
| Linux 64-bit | [Download TGZ](https://github.com/idle-org/pptx-reporter/releases/download/v0.7.0/pptx-reporter-portable-x86_64-unknown-linux-gnu-v0.7.0.tgz) |
| Apple Silicon Mac | [Download ZIP](https://github.com/idle-org/pptx-reporter/releases/download/v0.7.0/pptx-reporter-portable-aarch64-apple-darwin-v0.7.0.zip) |
| Intel Mac | [Download ZIP](https://github.com/idle-org/pptx-reporter/releases/download/v0.7.0/pptx-reporter-portable-x86_64-apple-darwin-v0.7.0.zip) |
Extract the **complete archive** before opening the application. The portable
package includes the GUI, FFprobe, fonts, licenses, and a command-line version
for optional automation.
On Windows, launch `pptx-reporter-gui.exe`. On Linux or macOS, launch
`pptx-reporter-gui` from the extracted folder. The Mac downloads are unsigned;
see the [Mac launch instructions](docs/development/releases.md#macos) if
Gatekeeper blocks the application.
## Create a report in the GUI
1. Drop one or more `.pptx` files, a video folder, or a folder containing
presentations into the window.
2. Choose what to create and where to save it.
3. Select the report formats you need.
4. Click **Generate reports**.
The original presentation and videos are preserved.
![PPTX Reporter start screen with the presentation picker and drop area](docs/pptx-reporter/images/01-start.png)
## Choose your output
The **Create** menu controls whether PPTX Reporter extracts embedded videos,
creates reports, or does both.
| Choice | Use it when you want to… |
| --- | --- |
| **Reports only** | Read timings without keeping another copy of the videos |
| **Extract + reports** | Save the embedded videos and create timing reports |
| **Extract only** | Save embedded videos without producing reports |
The common report formats appear directly on the Setup screen:
- **PDF** creates an easy-to-share report.
- **Markdown** creates an editable text report.
- **Ontime** creates `timings.ontime.json`, ready to import as a rundown.
- **More formats…** offers a web page, compact PDF, JSON, plain text, Typst,
and useful presets.
By default, output goes beside the first input. Use **Change…** to put it
somewhere else.
![A selected input with report formats and destination ready to run](docs/pptx-reporter/images/02-options.png)
## Open the finished reports
When processing finishes, the **Results** tab lists every generated file. Use
**Open** to view a report or **Open output folder** to see everything together.
Expand **Activity & diagnostics** if the app reports a warning.
![Completed run with report files and Open actions](docs/pptx-reporter/images/03-results.png)
For a presentation named `Showcase.pptx`, the default output is:
```text
Showcase_videos/
├── reports/ PDF, web, text, JSON and Ontime reports
└── videos/ extracted media, when requested
```
Reports follow slide order and account for PowerPoint start and end trims.
Looping videos and unsupported timings remain visible, but they are excluded
from finite playback totals and Ontime cues. Extracted media is not trimmed or
otherwise changed.
![Compact PDF report with slide, media and duration columns](docs/pptx-reporter/images/04-compact-report.png)
## Import a rundown into Ontime
Generate the **Ontime** format, then import
`reports/timings.ontime.json` through **Editor → Project → Manage projects**
in Ontime 4. Use this file instead of `timings.json`, which contains the
general report data.
See [report formats and timing](docs/pptx-reporter/report-formats.md) for skipped
events and show start times.
## If something does not work
- **The Generate button is disabled:** select an input and at least one report
format, or choose **Extract only**.
- **FFprobe cannot be found:** keep the bundled executable beside the app, or
choose it under **Settings → FFprobe → Locate…**.
- **A warning or failure appears:** expand **Activity & diagnostics** to see
the affected file and processing step.
- **A report does not open:** use **Open output folder** and open it with an
installed PDF reader or browser. Ontime JSON must be imported into Ontime.
The [illustrated user guide](docs/pptx-reporter/visual-guide.md) covers batches,
progress, cancellation, existing files, and every report preset.
## Optional command line use
The GUI is the main way to use PPTX Reporter. The portable package also contains
`pptx-reporter.exe` for scripts and repeatable batch jobs. Source builds can run
the same commands with `cargo run --locked --bin pptx-reporter --`:
## Run from source
```sh
# Reports for one presentation
pptx-reporter presentation.pptx --report all
# An Ontime rundown from a folder of videos
pptx-reporter ./show --timings-only --report ontime
# Extract embedded videos without reports
pptx-reporter presentation.pptx --extract-only
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
```
For batch behavior and exact playback semantics, see the
[complete reference](docs/pptx-reporter/README.md).
The source build discovers FFprobe beside the application, under `bin/`, or on
`PATH`. PDF generation and its fonts are embedded.
## Documentation and development
## Documentation
- [Illustrated user guide](docs/pptx-reporter/visual-guide.md)
- [User guide](docs/pptx-reporter/README.md)
- [Visual walkthrough](docs/pptx-reporter/visual-guide.md)
- [Report formats and timing](docs/pptx-reporter/report-formats.md)
- [Development guide](docs/development/README.md)
- [Portable release process](docs/development/releases.md)
- [Changelog](docs/pptx-reporter/changelog.md)
## Development
```sh
cargo fmt --all --check
cargo clippy --locked --workspace --all-targets --all-features -- -D warnings
cargo test --locked --workspace --all-features
RUSTDOCFLAGS="-D warnings" cargo doc --locked --workspace --all-features --no-deps
python3 -m unittest discover -s tests -v
```
PPTX Reporter is open-source software under the [MIT License](LICENSE). Its
development includes LLM-generated or LLM-assisted work with human review, and
it is used in professional settings. Report problems through
[GitHub Issues](https://github.com/idle-org/pptx-reporter/issues).
[Gitea Issues](https://proxy.dandaedre.com/gitea/idle-org/pptx-reporter/issues).

View File

@ -1,13 +1,13 @@
{
"x86_64-pc-windows-gnu": {
"release": "autobuild-2026-11-21-12-37",
"asset": "ffmpeg-n9.0.2-61-gd59078794d-win64-lgpl-9.0.zip",
"sha256": "3508eac94b9cfd5ffe34e88cef4fd5ba15b4ccdd6b4083488e070c702342a26a"
"release": "autobuild-2026-10-20-13-08",
"asset": "ffmpeg-n9.0.2-29-g6dfaba896f-win64-lgpl-9.0.zip",
"sha256": "e7bca5e004c2d13bcb374c3a4bd30c4588b08607a4b1a01369341a4f9678dff3"
},
"x86_64-unknown-linux-gnu": {
"release": "autobuild-2026-11-21-12-37",
"asset": "ffmpeg-n9.0.2-61-gd59078794d-linux64-lgpl-9.0.tar.xz",
"sha256": "7426ff6a8195b6e406f40d7155174e51ce6ef16a7d5e1f7d839c389cbc33817f"
"release": "autobuild-2026-10-20-13-08",
"asset": "ffmpeg-n9.0.2-29-g6dfaba896f-linux64-lgpl-9.0.tar.xz",
"sha256": "5ae5939260c72671383f0a0d8785695bfe06c94c27d4daac2e63eb8576417927"
},
"aarch64-apple-darwin": {
"release": "9.0.2",

View File

@ -7,5 +7,4 @@
- [Development](development/README.md)
- [CI and coverage](development/ci.md)
- [Cross builds and releases](development/releases.md)
- [Application icon provenance](development/icon-generation.md)
- [Persistent interfaces](interfaces/README.md)

View File

@ -1,18 +0,0 @@
# Application icon provenance
The application icon was generated with the built-in image generation tool.
Committed PNG, ICO and ICNS derivatives are used directly by builds; no image
generation service is required to compile or package the application.
Original prompt:
> Use case: logo-brand. Asset type: professional desktop application icon for
> pptx-reporter in a coordinated suite of document and audiovisual tools.
> Subject: a presentation slide with a play triangle and a small clock,
> representing video timing reports. A single centered icon, square 1024x1024
> canvas, rounded-square deep graphite tile with restrained luminous teal and
> cool silver pictogram. Premium contemporary desktop software visual identity,
> simple bold geometry, subtle depth and soft bevel, crisp silhouette legible at
> 32 pixels, front-facing orthographic view, balanced margins. Transparent
> background outside the tile, tile occupies 88% of canvas. No words, no labels,
> no watermark, no extra decorative objects.

View File

@ -20,7 +20,7 @@ are protected; use `--output DIR` for a new test build.
## FFprobe
`scripts/fetch_ffprobe.py` downloads FFmpeg-Builds 9.0 release-branch, non-shared
`scripts/fetch_ffprobe.py` downloads BtbN FFmpeg 9.0 release-branch, non-shared
LGPL builds. It verifies GitHub's archive SHA-256, executable format and x86-64
architecture, then tests `ffprobe -version` on a matching host. Foreign binaries
are inspected without execution. Verified binaries/notices are cached in
@ -69,7 +69,7 @@ never guesses Cargo output paths or creates archives. The publisher handles
archive validation, checksums and upload. See the upstream
[named-bundle contract](https://proxy.dandaedre.com/gitea/idle-org/rust_realease/raw/branch/main/docs/portable-bundles.md).
`crates/pptx-reporter/ffprobe-pins.json` pins a dated FFmpeg-Builds release, exact non-shared
`crates/pptx-reporter/ffprobe-pins.json` pins a dated BtbN release, exact non-shared
LGPL 9.0 asset name and published SHA-256 digest per Windows/Linux target. Dated assets have
versioned names, unlike the downloader's default `latest` assets. To update,
review the provider release and its notices, then update all three fields together.
@ -171,10 +171,6 @@ them; macOS runtime validation is explicitly skipped on Linux.
Publish the complete configured matrix together so its checksum manifest covers
all platforms.
The release configuration uploads that matrix to both Gitea and GitHub. Provide
`GITEA_TOKEN` and `GITHUB_TOKEN`, or use `--token-file` with an untracked JSON
object whose `gitea` and `github` keys contain the corresponding tokens.
## Application artwork
PPTX Reporter embeds its PNG window icon and Windows ICO resource, including

View File

@ -2,23 +2,14 @@
[Documentation index](../README.md)
## v0.7.0 — 2026-11-21
## Unreleased
- Publish the first standalone Idle release with portable desktop packages for
Windows, Linux, Apple Silicon macOS and Intel macOS.
- Make the GUI the primary download and README workflow while retaining the CLI
inside each portable package for optional automation.
- Refresh the pinned Windows and Linux FFprobe archives and accept the provider's
current GitHub organisation URL after its repository move.
- Publish future release assets to both Gitea and GitHub from one build, with
separate named credentials for each service.
- Move PPTX Reporter from the Beffroi tools workspace into its own Idle-owned
repository with standalone build, packaging, documentation and CI support.
- Store new desktop preferences under the Idle application namespace while
reading the former Beffroi settings location as a compatibility fallback.
- Preserve the application icon generation prompt with the standalone project.
- Rewrite the project README as an illustrated, task-oriented quick start for
desktop users, with installation, output selection, results and troubleshooting.
## v0.7.0 — 2026-11-14
- Update the shared Rust application version to 0.7.0; see the [release notes](../releases/v0.7.0.md).

View File

@ -1,57 +1,62 @@
# PPTX Reporter 0.7.0
# Beffroi tools 0.7.0
PPTX Reporter 0.7.0 is the first standalone Idle release of the desktop
application. Drop in PowerPoint files or video folders, choose the reports you
need, and open the results from the application when processing finishes.
Released 2026-11-14. This minor release improves Canvas Pilot's device mapping,
input previews, geometry exchange and documentation. All four Rust applications
now report the shared 0.7.0 version.
## Desktop workflow
## Canvas Pilot highlights
- Add one or more PowerPoint presentations, video folders, or a parent folder
containing a show.
- Create reports, extract embedded videos, or do both.
- Export readable PDF, compact PDF, web, Markdown, plain-text and JSON reports.
- Create a grouped Ontime 4 rundown from the same inputs.
- Review finished files in the Results tab and open a report or its folder
directly.
- Cancel long work and expand Activity & diagnostics when an input needs
attention.
- Map only the layers actually allocated on each Midra screen, independently of
physical input count. Existing layers remain available without an assigned input.
Keep editor input identity in Advanced Source, separate from device layer links.
- Share destinations between alternative layouts, with warnings naming other linked
layers. Block sends with overlapping destinations in the chosen scope; send a
conflict-free selection or folder instead.
- Use a dedicated Preview tab and Import input snapshot window to capture stills
into layers or fixed references. Hide no-signal inputs by default, capture on
input selection, and pool requests for layers sharing an input. Refresh remains
throttled and serialized; fixed references never auto-refresh.
- Snap to a configurable overlay grid, visible above reference images, with
independent visibility and snapping controls. Keep screen labels visible with
references and double-click again to exit visual crop editing.
- Drop supported geometry files into the same mapping review used by clipboard
and file imports. Choose All, Selected or Folder destinations, exclude individual
items, and review mappings without repeated import controls. Destination shortages
appear beside the scope selector.
- Use the official Craft codecs for complete DXF documents and optional native DWG
exchange. Include updated Full HD and UHD CAD templates and a ZIP of the AI
templates to avoid browser PDF previews. PPTX, draw.io and SVG acceptance is
confirmed by the user.
The original presentations and source videos are never modified. Timings follow
slide order and account for PowerPoint start and end trims. Looping or
unsupported playback remains visible in reports and is excluded from finite
totals and Ontime cues.
## Full manuals
## Downloads
All six tools now have [published mdBook manuals](https://books.dandaedre.com/manuals/)
with search, chapter navigation, local assets and downloadable templates. README
links lead directly to the books. Midra separates a first-layout quick start from advanced workflow and contract
chapters. Jenkins builds and checks the books before publishing main builds.
Choose the **portable** archive for a complete desktop package:
## Compatibility and limitations
- Windows x86-64 ZIP
- Linux x86-64 TGZ
- Apple Silicon macOS ZIP
- Intel macOS ZIP
Project JSON stays at version 10. Application settings are now version 7 for the
configurable grid, with migration from versions 1–6. Preview assignments and
refresh controls remain session-only. Geometry exchange preserves layout geometry;
use project JSON to retain the complete editable source/crop representation.
Extract the entire archive before launching `pptx-reporter-gui` (or
`pptx-reporter-gui.exe` on Windows). Portable packages include FFprobe, fonts,
licenses, provenance, desktop artwork, and the optional `pptx-reporter`
command-line application. No separate PowerPoint, Python, Typst, or FFmpeg
installation is required.
DWG requires the optional vendor-format build; the documented `no_proprietary`
build excludes it. Illustrator conversion still requires VectorCraft. AI downloads
are PDF-compatible Illustrator files; the template ZIP preserves their original
bytes and filenames. CAD exchange handles supported rectangular layout geometry,
not arbitrary CAD drawings.
The smaller archives and bare executables are intended for command-line users
and package installers. They do not include the complete portable runtime.
## Validation and distribution
## Platform notes
The CAD changes were checked in QCAD 3.28.2, including DXF/DWG rendering and
re-save/import round trips. Release checks passed workspace tests, Clippy, rustdoc, formatting and all 62
Python tests. Rust line coverage is 90.32%. No new hardware
or Windows/macOS acceptance is claimed.
The macOS applications require macOS 13 or newer. They are unsigned and
unnotarized; follow the repository's
[Mac launch instructions](../development/releases.md#macos) if Gatekeeper
quarantines the extracted files.
This release records source and a local version tag. Cross-platform binary builds
and remote publication remain separate steps; no new release archives are included.
The release is cross-built on Linux. Automated format, architecture, archive,
checksum and report-generation validation does not replace native acceptance on
every Windows and macOS configuration.
## Open source and development
PPTX Reporter is MIT-licensed open-source software. Its development includes
LLM-generated or LLM-assisted work with human review, and it is used in
professional settings.
See the [tool changelogs](../changelogs.md), [remaining Midra work](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/branch/main/docs/canvas-pilot/plan.md),
[format contracts](../interfaces/README.md) and [release build instructions](../development/releases.md).

View File

@ -1,18 +1,6 @@
[release]
tag-prefix = "v"
[[release.endpoints]]
name = "gitea"
provider = "gitea"
repository = "https://proxy.dandaedre.com/gitea/idle-org/pptx-reporter"
token-env = "GITEA_TOKEN"
[[release.endpoints]]
name = "github"
provider = "github"
repository = "https://github.com/idle-org/pptx-reporter"
token-env = "GITHUB_TOKEN"
[build]
targets = [
"x86_64-unknown-linux-gnu",
@ -37,7 +25,7 @@ targets = ["x86_64-pc-windows-gnu", "x86_64-unknown-linux-gnu", "aarch64-apple-d
formats = { x86_64-pc-windows-gnu = "zip", x86_64-unknown-linux-gnu = "tgz", aarch64-apple-darwin = "zip", x86_64-apple-darwin = "zip" }
archive-name = "{name}-{bundle}-{target}-v{version}"
root = "{name}-{bundle}-{target}-v{version}"
cargo-binaries = ["pptx-reporter-gui", "pptx-reporter"]
cargo-binaries = "all"
files = [
{ source = "assets/app-icon.png", destination = "icons/pptx-reporter/app-icon.png" },
{ source = "assets/app-icon.ico", destination = "icons/pptx-reporter/app-icon.ico" },
@ -58,3 +46,6 @@ required-destinations = ["ffprobe{binary-ext}", "LICENSES/ffmpeg/LICENSE.txt", "
[[repository.fallbacks]]
origin = "https://git.dandaedre.com/idle-org/pptx-reporter"
fallback-url = "https://proxy.dandaedre.com/gitea/idle-org/pptx-reporter"
[gitea]
token-env = "GITEA_TOKEN"

View File

@ -166,11 +166,7 @@ def fetch(target, cache=None, release="latest", expected_sha256=None, *, asset_n
if expected_sha256 is not None and digest != expected_sha256.lower():
raise ValueError("Upstream SHA-256 differs from the requested pin")
url = asset["browser_download_url"]
providers = (
"https://github.com/BtbN/FFmpeg-Builds/releases/download/",
"https://github.com/FFmpeg-Builds/FFmpeg-Builds/releases/download/",
)
if not url.startswith(providers):
if not url.startswith("https://github.com/BtbN/FFmpeg-Builds/releases/download/"):
raise ValueError("Unexpected upstream download URL")
folder = cache / target / digest
binary = folder / ("ffprobe.exe" if "windows" in target else "ffprobe")
@ -197,7 +193,7 @@ def fetch(target, cache=None, release="latest", expected_sha256=None, *, asset_n
raise ValueError("Downloaded executable did not identify itself as FFprobe")
version = lines[0]
receipt = {
"provider": url.split("/releases/download/", 1)[0],
"provider": "https://github.com/BtbN/FFmpeg-Builds",
"release": release, "release_id": release_data["id"], "asset_id": asset["id"],
"url": url, "archive_sha256": digest, "target": target,
"native_version_check": version,
@ -215,8 +211,7 @@ def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--target", required=True, choices=ASSETS)
parser.add_argument("--cache", type=Path, default=ROOT / "downloads/ffprobe")
parser.add_argument("--release", default="latest",
help="FFmpeg-Builds release tag; default latest")
parser.add_argument("--release", default="latest", help="BtbN release tag; default latest")
parser.add_argument("--sha256", help="Optional expected archive digest for reproducibility")
args = parser.parse_args()
try:

View File

@ -43,7 +43,7 @@ class FetchTests(unittest.TestCase):
name = fetcher.ASSETS[WINDOWS]
release = {"id": 1, "assets": [{"id": 2, "name": name, "digest": "sha256:" + digest,
"size": len(content),
"browser_download_url": "https://github.com/FFmpeg-Builds/FFmpeg-Builds/releases/download/latest/" + name}]}
"browser_download_url": "https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/" + name}]}
def download(url, destination, limit=None):
destination.write_bytes(json.dumps(release).encode() if url.startswith(fetcher.API) else content)
with tempfile.TemporaryDirectory() as temp, patch.object(fetcher, "download", side_effect=download) as get, \