FFmpeg CLI Reference

Contents

• Dependencies
• Glossary of flags and filters
• Converting formats
• Resizing and padding
• Trim by time
• Verification and inspection
• Reference files

Dependencies

Verify ffmpeg is installed:

ffmpeg -version

Install if missing:

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows (scoop)
scoop install ffmpeg

Glossary of flags and filters

Filtering reference

Expression evaluations: if, lte, gte and more.

Converting formats

Remux MP4 to MKV (no re-encoding):

ffmpeg -i input.mp4 -c copy output.mkv

MKV and MP4 are both containers for H264/H265 video and AAC/MP3 audio. Video quality is determined by the codec, not the container. MKV supports multiple video streams; MP4 has wider device support.

Remux MP4 to MOV:

ffmpeg -i input.mp4 -c copy output.mov

Encode MP4 to AVI (re-encodes):

ffmpeg -i input.mp4 output.avi

Resizing and padding

Upscale to 1080x1920, preserve aspect ratio, black padding:

ffmpeg -i input.mp4 -vf "scale=w=1080:h=1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:color=black,setsar=1:1" output.mp4

scale options:

• force_original_aspect_ratio=decrease - auto-decrease output dimensions to fit aspect ratio
• force_original_aspect_ratio=increase - auto-increase dimensions
• scale=w=1080:h=-1 - let ffmpeg pick correct height for aspect ratio
• scale=w=1080:h=-2 - force dimensions divisible by 2

scale reference

pad options:

• pad=width:height:x:y:color - x:y is top-left corner position
• (ow-iw)/2:(oh-ih)/2 centres the video; negative values also centre
• pad reference

setsar=1:1 ensures 1:1 pixel aspect ratio. Prevents ffmpeg from compensating for ratio changes. setsar reference

Two scaled outputs from one input (horizontal + vertical with logo overlay):

ffmpeg -i input.mp4 -i logo.png \
  -filter_complex "[0:v]split=2[s0][s1]; \
    [s0]scale=w=1920:h=1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:color=black,setsar=1:1[out1]; \
    [s1]scale=w=720:h=1280:force_original_aspect_ratio=decrease,pad=720:1280:(ow-iw)/2:(oh-ih)/2:color=black,setsar=1:1[s2]; \
    [s2][1]overlay=(main_w-overlay_w)/2:(main_w-overlay_w)/5[out2]" \
  -map [out1] -map 0:a output_youtube.mp4 \
  -map [out2] -map 0:a output_shorts.mp4

Trim by time

ffmpeg -i input.mp4 -ss 00:00:10 -to 00:00:25 output.mp4

For faster but less accurate trimming, see the Input/output seeking section in references/encoding-and-settings.md. For the -c copy trade-offs when trimming, see references/core-concepts.md.

Verification and inspection

List supported formats:

ffmpeg -formats

List supported codecs:

ffmpeg -codecs

ffprobe

ffprobe provides structured metadata about media files.

Show detailed stream information:

ffprobe -show_streams -i input.mp4

Verify moov atom position (faststart):

ffprobe -v trace -i input.mp4

Look for type:'moov' near the beginning of output to confirm faststart is applied.

Reference files

Load these on demand with the Read tool when the task requires deeper coverage.