Skip to content

Video Conform

Video video-conform Source

Install: /plugin install video-studio@claude-code-skills

Portability: one stdlib script driving ffmpeg. Without --run it only prints the plan and command.

Conform is where a good cut gets rejected: wrong loudness, music drowning the voice, no captions, a file that will not play on a phone. The script makes one ffmpeg pass and then checks the result instead of trusting it.

Workflow

C=${CLAUDE_PLUGIN_ROOT}/skills/video-conform/scripts/conform.py
python3 $C --render film/frames/render.json --scene film/scene.json --vo film/vo.wav --music film/bed.mp3 --out film/final.mp4      # plan
python3 $C --render film/frames/render.json --scene film/scene.json --vo film/vo.wav --music film/bed.mp3 --out film/final.mp4 --run
python3 $C --video film/cut.mp4 --scene film/scene.json --loudness music --burn-captions --out film/final.mp4 --run
Target (--loudness) Integrated True peak Source
speech (default) -18 LUFS -1 dBTP AES TD1008, speech and mixed content
music -16 LUFS -1 dBTP AES TD1008, music
broadcast -23 LUFS -1 dBTP EBU R 128

Music is mixed about 12 dB under the voice. captions.srt is always written when a scene is given (two lines of up to 42 characters per cue; a long voice-over line is split into several cues across its shot, never cut); --burn-captions also draws them in, which most social feeds need because they autoplay muted.

QC after encode: duration within one frame of the scene and loudness within 1 LU of the target. Loudness is single-pass loudnorm, which lands within 1 LU on clips of about 5 s and longer; on very short stings measure and re-run rather than widening the gate. A voice-over longer than the picture is warned about, and a render with missing frames is refused. A miss is exit 4; fix the input (a clipped VO, a silent track) rather than re-running until it passes.

Delivery checklist

  • conform.py PASS on the final file
  • Captions present (sidecar or burned)
  • Generated footage labelled as AI-generated where published
  • One file per aspect: re-render the scene with --aspect, then conform each

See delivery_specs.md for sources.