video-factory-plugin

Video Factory

Plugin marketplaces

This plugin belongs to AIGC content creation.

Category · Marketplace · Purpose Full-stack development · Full Stack Plugins · Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations AIGC content creation · Full AIGC Plugins · Image, video, audio, music, 3D, and multimodal content creation

Analyze shots, plan an edit, approve it by hash, render locally with FFmpeg, and hand back a receipt for every output file — no cloud service and no API key.

English | 简体中文 · Install · Quick start · Skills · Troubleshooting

Positioning

video-factory turns existing footage into an approved, verifiable edit. The host agent analyzes shots, proposes a closed EditDecision, quotes the stage, waits for your approval, renders through local FFmpeg, and records media receipts for every output.

The repository keeps the canonical video spelling across repository, plugin, package, CLI, and skill identifiers. There is no cloud service, no API key, and no vendor upload.

Property · Value Plugin ID · video-factory Version · 0.5.1+codex.20261018 Maturity · Local composition is stable; the recorded runtime acceptance covers the 0.1.0 line Runtime · Node.js 18+, FFmpeg and ffprobe on PATH MCP server · None; the plugin exposes a skill-driven CLI instead

The 0.5.0 line has no fresh runtime acceptance record in this repository. Treat recorded media evidence as line-specific and re-verify before claiming a release.

Installation

Prerequisites

• Node.js 18 or newer on PATH.
• FFmpeg and ffprobe on PATH; required for every probe and render.
• Chrome or Chromium only for the enhanced synchronized review video.
• Your footage as local regular files beneath --input-root; the plugin never fetches a URL.

From the plugin marketplace

codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add video-factory@full-aigc-plugins

From the repository-local marketplace

codex plugin marketplace add full-aigc-plugins/video-factory-plugin --ref v0.5.1
codex plugin add video-factory@partme-ai-video-factory

Restart Codex or the ChatGPT desktop app and open a new task so the skills load. There is no build step and no npm install: the CLI has zero runtime dependencies.

For development, clone the repository and run bin/video-factory probe; it reports Node, FFmpeg, and ffprobe availability plus whether the enhanced review path is usable. codex plugin list should show video-factory@partme-ai-video-factory installed, enabled.

Quick start

1. Probe the footage, then let the host annotate the shot analysis. Finalize it with the measured track and keyframes:

bin/video-factory analyze source.mp4 --out reelbench-analysis
bin/video-factory analyze-finalize reelbench-analysis/shots.json \
  --track reelbench-analysis/track.json --frames reelbench-analysis/frames

1. Validate the edit decision, quote the rough cut, and approve that exact revision:

bin/video-factory validate-plan video-plan.json
bin/video-factory quote video-plan.json --stage rough
bin/video-factory run video-plan.json --stage rough --approval rough-approval.json

1. Build the synchronized review, quote and approve the final cut, then record your acceptance:

bin/video-factory review-sync output/rough.mp4 reelbench-analysis/shots.json
bin/video-factory quote video-plan.json --stage final
bin/video-factory run video-plan.json --stage final --approval final-approval.json
bin/video-factory accept final-job.json --decision approved --note "played and accepted"

An approval binds the stage, plan hash, edit hash, round, and quote revision. Any change to an asset, an edit, or an output specification invalidates the old approval. The rough cut and the final cut are approved separately, and a rejected stage returns to planning.

What you can build

Workflow · Built-in path · Verifiable output Break footage into shots · analyze, analyze-finalize, video-shots · shots.json, track, keyframes, and a shot report Assemble a rough cut · validate-plan → quote → run · Resumable H.264/AAC MP4 with per-segment receipts Review picture against shot data · review-sync · Internal review MP4 with synchronized shot data Finish with audio, subtitles, and titles · final stage run · Multi-track final MP4 plus embedded subtitle track Judge and accept · evaluate, accept · Three-state media gates and a recorded human decision Resume an interrupted render · recover · Pending segments resumed without re-rendering completed ones Slice a talking-head recording · episode-slice, episode-roughcut · Rough-cut MP4, aligned SRT, and cutlist.json

Skills

Skill · Purpose video-factory-use · Routes an editing request to the correct workflow video-factory-plan · Converts local assets and shot evidence into a validated EditDecision video-factory-run · Renders an approved stage and records receipts without automatic retry video-factory-judge · Runs media gates, advisory semantic review, and human acceptance or rework labels video-factory-recover · Reads the durable ledger and determines the only legal next action video-factory-harness · Calling spec for the CLI surface and the rough → review → final approval gate video-episode-slicing · Word-level ASR timeline → cut points → rough cut, SRT, and cutlist video-shots · Vendored ReelBench shot breakdown with deterministic evidence video-sync · Vendored annotated review video that pairs picture with shot data

The video-factory-use/plan/run/judge/recover skills are vendored from video-factory-skills v1.0.2 through skills.lock.json. video-shots and video-sync are ReelBench snapshots pinned by Git blob and SHA-256 in upstream/reelbench.lock.json; video-episode-slicing and video-factory-harness are plugin-local. Edit none of these copies in place.

Slash commands

Command · What it does /video-factory · Total entry point; routes by capability /video-factory-plan · Builds the timeline and edit decision /video-factory-run · Renders the approved edit and collects receipts /video-factory-judge · Reviews finished media and records the verdict /video-factory-recover · Resumes an interrupted composition job /video-episode · Slices and rough-cuts a talking-head recording

Configuration

Setting · Where it lives · Notes Job ledger · .job.json, or the --ledger path · Plain JSON with atomic per-segment updates Input root · --input-root · Only regular files beneath it are accepted Render outputs · The output directory you choose · Never overwritten silently Review assets · The analysis directory · Keyframes and contact sheets stay local Credentials · None · The runtime never reads an API key or token

Architecture and security

flowchart LR
    A[Footage] --> B[analyze / probe]
    B --> C[EditDecision]
    C --> D{quote + approval}
    D -->|approved| E[FFmpeg segments]
    D -->|rejected| C
    E --> F[Assemble audio + subtitles]
    F --> G[Media gates]
    E -->|interrupted| H[(Job ledger)]
    H --> E

Component · Owns · Does not own src/cli.mjs · Command dispatch, exit codes, argument validation · Media processing src/orchestrator.mjs · Run, approve, and recover sequencing · FFmpeg argv construction src/ffmpeg-compiler.mjs · Deterministic argv and content-addressed segment keys · Approval decisions src/job-ledger.mjs, src/approval.mjs · Durable state, resume points, hash-bound approvals · Cost estimation skills/ (9) · Routing, planning, review, and recovery instructions · Runtime behaviour

The plugin makes no network call for generation; local FFmpeg is the only execution engine. Approvals are single-use and bound to content hashes, so they cannot be replayed against different content. Input containment rejects paths outside --input-root, path traversal, symlink escapes, special files, arbitrary FFmpeg filter graphs, and credential fields. All child processes run with shell: false.

Troubleshooting

Symptom · Check first · Resolution probe reports a missing tool · FFmpeg and ffprobe on PATH · Install FFmpeg and re-run probe Plan validation fails · EditDecision schema · Fix the named field; unknown fields are rejected Run refuses to start · The approval file · Re-quote the stage and approve the new revision Render stops mid-way · Ledger state · Run recover; completed segments are never re-rendered Review video is unavailable · Chrome presence · Install Chrome, or skip the enhanced review Subtitle burn-in is missing · The local FFmpeg build · The verified FFmpeg 9.0.1 lacks libass; the step is recorded as SKIPPED Semantic consistency is unproven · Gate status · It stays NOT_RUN; Codex or a human reviews it Verification is missing for your platform · Recorded evidence · Media acceptance was recorded on macOS; re-verify on your platform A remote generation path was expected · Plugin scope · Native video generation is blocked by design

Upgrade

codex plugin marketplace upgrade partme-ai-video-factory
codex plugin add video-factory@partme-ai-video-factory

Contributing and support

Open functional issues at . Before proposing a change, state the target Node version and whether it alters the approval binding or the ledger format, and include the affected tests.

License

Apache-2.0 — see LICENSE and THIRD_PARTY_NOTICES.md. Vendored ReelBench skills keep their upstream terms.