Repository navigation
v0.25.0 — the whole film
clip.mp4
proofcut, the local-first AI video editor. It is an MCP server over
ffmpeg, whisper and OpenTimelineIO. An agent, the proofcut command line, or
the browser window takes your recordings and returns a finished, mastered
film: cut by transcript, with b-roll hung off the words, a score under the
voice, cards, captions, and a master at a loudness target. It renders on your
own machine, then transcribes the render and checks that it says what the
edit says. Source-available under PolyForm Shield 1.0.0: any use except
building a product that competes with it.
This release finishes the film. Until now proofcut cut well and stopped
at the render.
- Score it. A music bed takes placed passages, a rotation and crossfades,
and it ducks under the voice — gated on the timeline's own audio rather
than on transcript words, which was measured the better of the two (3.39 dB
against the audio gate's 2.72; no duck at all was 3.62). - Master it.
export --loudnesshits a loudness target with one gain and
a true-peak limiter. It deliberately does not useloudnorm's second pass,
which rode the mix and put 5 dB of the duck back at exit 0. - Hold the film's own audio under the narration, or in a gap, addressed by
a phrase rather than by word indices. - An agent does all of it unattended. Handed a goal and no steps, it cut
the demo, laid the music under the voice, ended on a card, mastered to
−16 LUFS and checked its own work: 12 of 12 checks, 192 seconds, $2.27.
The score, the level and the end card were each measured in the delivered
file, not taken from the project.
Where it runs. Linux is where it was built and measured; from a bare
Ubuntu 24.04 and a bare Fedora 44, following nothing but the docs and
proofcut doctor, the demo reached a verified render. Windows: its author
has now run the whole-film demo end to end on a real Windows 11 laptop — all
seven checks, master −16.0 LUFS, frames delta 0 — so a run by anyone else
is the missing report. macOS: the suite and the demo kit are green on
GitHub's macOS runner, but no person has run it on a Mac yet. If you have
one, the Mac test
is one script and a report, and it removes what it installs.
Start with docs/DEMO.md
— two minutes, on media the repo generates itself, so there is nothing to
download and no licence question. proofcut doctor lists what your machine is
missing and prints the fix under each one. If it says ✗, that output is the
single most useful thing you can send.