video-cut

Simple CLI video editor for quick cuts, speed changes, and silence removal. Built for use with Claude Code and AI-assisted workflows.

Install

# Dependencies
brew install ffmpeg
pip3 install auto-editor  # optional, for auto-silence removal

# Install video-cut
curl -o ~/bin/video-cut https://raw.githubusercontent.com/sunyuding/video-cut/main/video-cut
chmod +x ~/bin/video-cut

Make sure ~/bin is in your PATH:

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc

Usage

# Show video info
video-cut info input.mp4

# Remove a segment (auto-versions: input_v1.mp4, input_v2.mp4, ...)
video-cut remove input.mp4 5:30 6:10

# Keep only a segment
video-cut keep input.mp4 2:00 15:00

# Speed up a segment (2x)
video-cut speed input.mp4 8:00 15:00 2

# Concatenate files
video-cut concat output.mp4 part1.mp4 part2.mp4

# Auto-remove silence (requires auto-editor)
video-cut auto-silence input.mp4 --margin 0.3

# Show version history
video-cut history input.mp4

Features

• Auto-versioning: Every edit creates a new versioned file (_v1, _v2, ...), never overwrites
• Smart keyframe detection: Automatically uses re-encoding only when needed for precise cuts
• Time formats: Supports MM:SS and HH:MM:SS
• Silence removal: Integrates with auto-editor for automatic silence detection

Use with Claude Code

Just tell Claude what you want:

> 5:30-6:10 remove
> 8:00-15:00 speed up x2
> auto remove silence
> show version history

Claude will use video-cut to execute the edits.

Requirements

• Python 3.7+
• ffmpeg / ffprobe
• auto-editor (optional)

License

MIT