pyffmpegcore

PyFFmpegCore provides an operational layer between user intent and FFmpeg execution. It focuses on repeatability and safety by implementing a workflow of preflight checks, deterministic planning, execution, and the generation of privacy-redacted receipts. Key capabilities include: - **Preflight & Planning**: Diagnoses system capabilities and previews the exact FFmpeg argument vectors before mutation occurs. - **Task-Based Workflows**: Includes built-in recipes for common tasks such as web-compatible MP4 conversion, target-size compression, audio normalization (loudnorm), and stream preservation during remuxing. - **Pipeline Management**: Supports composing typed workflows using JSON or TOML, with features for validation, DAG visualization (via Mermaid), and state-based resumption. - **Multi-Interface Access**: Available as a CLI tool and a Python API (via WorkflowEngine) for integration into larger applications. - **CI/CD Integration**: Provides a digest-pinned GitHub Action and container images (linux/amd64 and linux/arm64) with SBOM and provenance. System dependencies include `ffmpeg` and `ffprobe`. It supports Python 3.10–3.14 across Linux, macOS, and Windows.