cgallic/video-review-os

Video Review OS is a local video clipping pipeline for creators and small teams who want full control over every step before anything gets published. You drop raw video files into a folder and the tool handles the rest: it transcribes the footage, finds candidate clip ranges, scores each clip's quality from an audience perspective, proposes ways to combine and repair clips into finished assemblies, renders MP4 drafts, writes caption files, pulls frame stills, generates thumbnail SVGs, and builds a static review dashboard. Nothing publishes automatically. Every output waits for a human to approve it first. The quality gate step is more than a keep-or-reject filter. When a clip has problems (weak ending, awkward pause, filler opening), the tool emits concrete repair instructions describing exactly what to trim or drop, then applies those repairs automatically when assembling the final edit. The assembly layer can combine multiple clip ranges into a single video, reordering them and inserting title or bridge cards as needed, based on a storyboard proposal that can come from a simple deterministic algorithm or from your own language model endpoint. All outputs are plain files: JSON sidecars, SRT and VTT caption files, JPEG frames, SVG drafts, rendered MP4 files, and static HTML. There is no hidden database. Source videos are never deleted. The tool runs entirely on your own machine using ffmpeg for video processing and Whisper (or faster-whisper) for transcription. The tool compares itself to services like Opus Clip and Descript, noting that those are better for polished hosted workflows with social publishing. Video Review OS is for teams that want to inspect every artifact before anything leaves the machine and are comfortable running a Python pipeline locally. Setup requires Python 3.11 or higher, ffmpeg, and optionally a local Whisper installation. The README is very detailed, covering the full pipeline, all output files, and configuration options. The license is not mentioned.