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

Flag/Filter Purpose

-vf (also -filter:v ) Video filter

-af (also -filter:a ) Audio filter

-filter_complex

Complex filter graph for multi-stream filtering

[0]

All streams from first input (0-based)

[0:v]

Video stream from first input

[1:a]

Audio stream from second input

0:v:0

First input, first video stream

0:a:1

First input, second audio stream

[name]

Named stream, used with -filter_complex

-map [name]

Select stream for output

-y

Auto-overwrite output files without confirmation

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.

File Topics

references/core-concepts.md

-c copy (remux vs transcode), input/output seeking, encoding quick ref (H264/H265/VP9 CRF ranges), GPU acceleration overview, format=yuv420p , -movflags +faststart

references/audio-processing.md

Replace audio, extract audio, mix audio, combine MP3 tracks, crossfade, change audio format, merge and normalise

references/advanced-editing.md

Playback speed, FPS change, jump cuts, video cropping for social, drawtext overlay, subtitles (burn/embed/extract), combine media (overlay, logo, background, concat intro/main/outro, vstack)

references/asset-generation.md

Image to video, slideshow with fade, Ken Burns (zoompan), GIFs, video compilation with fades, thumbnails (single/multiple/scene), image thumbnails, storyboards (scene tile/keyframe/Nth frame)

references/encoding-and-settings.md

Optimised daily command, H264 (libx264) deep-dive, H265 (libx265) Apple compat, VP9 (libvpx-vp9) constant quality, 1-pass vs 2-pass, -c copy detailed, seeking detailed, GPU detailed (Nvidia/Intel/AMD)