Video Editing

Edit videos using natural language instructions. Supports trimming, jump cuts (silence removal), captions with multiple styles, text overlays, and speed changes — all powered by ffmpeg and Whisper.

Usage

Give a video file path and describe what you want done:

Edit my video at ~/video.mp4 — remove silence, add Hormozi-style captions, and speed it up 1.25x

Trim ~/interview.mp4 from 00:02:00 to 00:15:00 and add standard captions

Add a "Subscribe!" text overlay at the 1 minute mark in ~/video.mp4

Capabilities

Trimming

Cut video to specific start/end timestamps or duration.

scripts/trim.sh video.mp4 --start 00:01:30 --end 00:05:00

Jump Cuts (Silence Removal)

Auto-detect and remove silent/dead-air sections. Configurable threshold, minimum silence duration, and padding.

scripts/jumpcut.sh video.mp4 --threshold -30 --duration 0.5 --padding 0.1

Captions

Transcribe audio with Whisper, then burn subtitles into video. Three caption styles:

Style	Description
hormozi	Bold, centered, large — Alex Hormozi word-by-word impact style
standard	Traditional bottom subtitles with semi-transparent background
minimal	Small lower-third captions, clean and unobtrusive

scripts/transcribe.sh video.mp4 --model base --language en
scripts/caption.sh video.mp4 video.srt --style hormozi

Text Overlays

Add text at specific positions and timestamps. Supports 7 positions: center, top, bottom, top-left, top-right, bottom-left, bottom-right.

scripts/overlay-text.sh video.mp4 --text "Subscribe!" --start 00:01:00 --end 00:01:05 --position bottom-right

Speed Changes

Adjust playback speed (audio pitch-corrected via atempo).

# Via edit.sh orchestrator
scripts/edit.sh video.mp4 --speed 1.5

Full Pipeline (Orchestrator)

Chain multiple operations in a single command:

scripts/edit.sh video.mp4 \
  --trim-start 00:00:10 --trim-end 00:10:00 \
  --jumpcut \
  --caption --caption-style hormozi \
  --speed 1.25 \
  --overlay-text "Like & Subscribe" --overlay-start 00:01:00 \
  --output final.mp4

Pipeline order: trim → jump cut → speed → caption → overlay

Requirements

• ffmpeg — video processing (must be installed)
• whisper — audio transcription for captions (openai-whisper CLI)

Scripts Reference

Script	Purpose
scripts/edit.sh	Main orchestrator — chains all operations
scripts/transcribe.sh	Whisper transcription → SRT file
scripts/caption.sh	Burn SRT captions into video with style
scripts/trim.sh	Trim by timestamps
scripts/jumpcut.sh	Auto-remove silence via silencedetect
scripts/overlay-text.sh	Add positioned text overlays

Agent Instructions

When the user asks to edit a video:

1. Parse the request — identify which operations are needed (trim, jumpcut, caption, overlay, speed)
2. Use edit.sh for multi-operation edits — it chains operations in the correct order
3. Use individual scripts for single operations — faster, simpler output
4. For captions: if the user has an existing SRT, use --caption-srt; otherwise transcription runs automatically
5. Default caption style: use "standard" unless the user specifies a style
6. Default whisper model: use "base" for speed; suggest "medium" or "large" for accuracy on long/noisy videos
7. Output: always tell the user the output file path and duration