diff --git a/README.md b/README.md index d2a82c1..81644c5 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,10 @@ ![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) -Turn the videos in a PowerPoint presentation—or a folder of ordinary video -files—into a clear timing report. PPTX Reporter can also extract embedded -videos and prepare a rundown for [Ontime](https://www.getontime.no/). +**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. @@ -15,16 +16,33 @@ the source files to finished reports. PPTX Reporter icon

-## Get started +## Download the desktop app -1. Download the package for your computer from - [GitHub Releases](https://github.com/idle-org/pptx-reporter/releases). -2. Extract the complete archive. On Windows, open - `pptx-reporter-gui.exe` and keep the bundled `ffprobe.exe` beside it. -3. Drop one or more `.pptx` files, a video folder, or a folder containing +[**PPTX Reporter v0.7.0 release notes and all downloads →**](https://github.com/idle-org/pptx-reporter/releases/tag/v0.7.0) + +| 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. -4. Choose what to create, check the destination, and select **Generate - reports**. +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. @@ -75,6 +93,8 @@ 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 @@ -99,9 +119,10 @@ events and show start times. The [illustrated user guide](docs/pptx-reporter/visual-guide.md) covers batches, progress, cancellation, existing files, and every report preset. -## Command line use +## Optional command line use -The portable package also contains `pptx-reporter.exe`. Source builds can run +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 --`: ```sh diff --git a/docs/pptx-reporter/changelog.md b/docs/pptx-reporter/changelog.md index 1868ec5..2d300da 100644 --- a/docs/pptx-reporter/changelog.md +++ b/docs/pptx-reporter/changelog.md @@ -2,8 +2,12 @@ [Documentation index](../README.md) -## Unreleased +## v0.7.0 — 2026-11-21 +- 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. - 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 @@ -14,8 +18,6 @@ - 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). - Add direct links to the published mdBook manual from the project README, tool guide and documentation indexes. diff --git a/docs/releases/v0.7.0.md b/docs/releases/v0.7.0.md index bb249d5..4676c12 100644 --- a/docs/releases/v0.7.0.md +++ b/docs/releases/v0.7.0.md @@ -1,62 +1,57 @@ -# Beffroi tools 0.7.0 +# PPTX Reporter 0.7.0 -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. +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. -## Canvas Pilot highlights +## Desktop workflow -- 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. +- 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. -## Full manuals +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. -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. +## Downloads -## Compatibility and limitations +Choose the **portable** archive for a complete desktop package: -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. +- Windows x86-64 ZIP +- Linux x86-64 TGZ +- Apple Silicon macOS ZIP +- Intel macOS ZIP -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. +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. -## Validation and distribution +The smaller archives and bare executables are intended for command-line users +and package installers. They do not include the complete portable runtime. -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. +## Platform notes -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 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. -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). +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. diff --git a/rust-release.toml b/rust-release.toml index 3b58aa0..90006c0 100644 --- a/rust-release.toml +++ b/rust-release.toml @@ -37,7 +37,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 = "all" +cargo-binaries = ["pptx-reporter-gui", "pptx-reporter"] 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" },