Edit Cut Video with FFmpeg

Overview

Automated pipeline for cutting highlights from live streams and fixing common playback issues (frame freezes, black screens, AV desync). Re-encode specific segments using FFmpeg's filter_complex at the raw frame level to ensure perfect synchronization.

When to Use

• You need to cut highlight clips from a long-form video or stream.
• You encounter black screens or frame freezes at the beginning of cut clips.
• Audio and video become desynchronized after cutting or concatenating clips.
• You need to ensure the final output is compatible with macOS (QuickTime).

Core Pattern

Instead of simple stream copying (-c copy), which causes keyframe and sync issues, use raw frame-level processing with -filter_complex and force re-encoding to standard formats.

# Fix desync and frame freeze by re-encoding at frame level
ffmpeg -i input1.mp4 -i input2.mp4 -filter_complex \
  "[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[outv][outa]" \
  -map "[outv]" -map "[outa]" \
  -c:v libx264 -pix_fmt yuv420p -c:a aac \
  output.mp4

Quick Reference

Implementation

1. Download specific sections

Use yt-dlp to download only the necessary sections. Note: This requires FFmpeg.

yt-dlp --download-sections "*00:01:00-00:01:40" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" "URL" -o "segment.mp4"

2. Concatenate and fix sync issues

To avoid black screens (due to missing initial keyframes) and AV desync (due to container-level packet alignment), you must re-encode and use filter_complex.

ffmpeg \
  -i segment1.mp4 \
  -i segment2.mp4 \
  -filter_complex "[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[outv][outa]" \
  -map "[outv]" -map "[outa]" \
  -c:v libx264 -pix_fmt yuv420p \
  -c:a aac \
  -movflags +faststart \
  final_highlight.mp4

Red Flags - STOP and Start Over

• Trying to use -c copy to save time when cutting streams.
• Recommending concat demuxer (text file) for stream clips.
• "I'll just download the whole video and use a GUI."
• Omitting -pix_fmt yuv420p for macOS outputs.

Rationalization Table

Common Mistakes