FFmpeg 完全指南：安装、概念与常用命令

# macOS
brew install ffmpeg

# Debian / Ubuntu
sudo apt update && sudo apt install -y ffmpeg

# Windows
winget install --id Gyan.FFmpeg -e

# Linux 免 root 静态构建（下载即用，不依赖系统库）
wget https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz
tar xf ffmpeg-release-amd64-static.tar.xz && sudo cp ffmpeg-*-static/ffmpeg /usr/local/bin/

ffmpeg -version                 # 版本 + 编译选项（--enable-xxx 决定你能用什么）
ffmpeg -encoders                # 本机可用的编码器
ffmpeg -decoders                # 本机可用的解码器
ffmpeg -formats                 # 支持的容器/协议
ffmpeg -hwaccels                # 可用的解码硬件加速
ffmpeg -filters                 # 可用的滤镜
ffmpeg -h encoder=libx264       # 某个编码器的全部参数

ffmpeg [全局选项] [输入选项] -i 输入 [输出选项] 输出

-y            # 存在就覆盖（脚本里必加，否则会卡住等你输入）
-n            # 存在就退出，不覆盖
-hide_banner  # 不打印编译信息，日志更干净
-loglevel error|warning|info|verbose|debug
-stats        # 显示进度（默认开）；-nostats 关掉
-nostdin      # 循环里必加：防止 ffmpeg 吃掉脚本的标准输入
-benchmark    # 跑完打印耗时，用来对比预设

# 第 1 路视频 + 第 2 路音频（下标从 0 开始，所以是 0:a:1）
ffmpeg -y -i in.mkv -map 0:v:0 -map 0:a:1 -c copy out.mp4

# 全部流，但排除字幕
ffmpeg -y -i in.mkv -map 0 -map -0:s -c copy out.mp4

# 全部流；没有字幕也不报错（问号 = 可选）
ffmpeg -y -i in.mkv -map 0:v -map 0:a -map 0:s? -c copy out.mkv

# 人读
ffprobe -hide_banner in.mp4

# 机器读（脚本里用）
ffprobe -v error -show_format -show_streams -of json in.mp4

# 只要某几项
ffprobe -v error -select_streams v:0 \
  -show_entries stream=codec_name,width,height,r_frame_rate,pix_fmt \
  -of default=noprint_wrappers=1 in.mp4

# 只要时长（秒）
ffprobe -v error -show_entries format=duration -of csv=p=0 in.mp4

ffplay in.mp4                          # 直接播
ffplay -ss 00:01:20 in.mp4             # 从 1 分 20 秒开始
ffplay -vf "crop=640:360:0:0" in.mp4   # 边播边看滤镜效果
ffplay -nodisp -autoexit music.mp3     # 不看画面，播完自动退出
ffplay -f lavfi "testsrc=size=640x360:rate=30"   # 生成测试画面

ffmpeg -y -i in.mkv -c copy -movflags +faststart out.mp4

ffmpeg -y -i in.mp4 -vn -c:a copy out.m4a      # 抽音轨，不重编码
ffmpeg -y -i in.mp4 -vn -c:a libmp3lame -q:a 2 out.mp3
ffmpeg -y -i in.mp4 -an -c:v copy out_video.mp4  # 去掉声音
ffmpeg -y -i in.mkv -c:s srt out.srt              # 导出文本字幕

# ① 通用：画质优先（H.264 默认 CRF 23，18 接近视觉无损，28 明显更小）
ffmpeg -y -i in.mp4 -c:v libx264 -crf 23 -preset medium -pix_fmt yuv420p \
  -c:a aac -b:a 160k -movflags +faststart out.mp4

# ② 限制峰值码率：CRF 定常态，maxrate/bufsize 按住尖峰
ffmpeg -y -i in.mp4 -c:v libx264 -preset slow -crf 22 -maxrate 4M -bufsize 8M \
  -c:a aac -b:a 160k out.mp4

# ③ 必须压到固定平均码率：两遍编码（第一遍只分析）
ffmpeg -y -i in.mp4 -c:v libx264 -b:v 2M -pass 1 -an -f null /dev/null
ffmpeg -y -i in.mp4 -c:v libx264 -b:v 2M -pass 2 -c:a aac -b:a 160k out.mp4

ffmpeg -y -ss 00:01:00 -to 00:01:30 -i in.mp4 -c copy out.mp4

ffmpeg -y -i in.mp4 -ss 00:01:00 -to 00:01:30 \
  -c:v libx264 -crf 20 -c:a aac -b:a 160k out.mp4

# list.txt 内容（路径相对于运行命令的当前目录）:
# file 'part1.mp4'
# file 'part2.mp4'
ffmpeg -y -f concat -safe 0 -i list.txt -c copy out.mp4

ffmpeg -y -i a.mp4 -i b.mp4 -filter_complex \
  "[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]" \
  -map "[v]" -map "[a]" -c:v libx264 -crf 23 -c:a aac out.mp4

# 第 5 秒截一张（q:v 越小越清晰，2~5 够用）
ffmpeg -y -ss 00:00:05 -i in.mp4 -frames:v 1 -q:v 2 thumb.jpg

# 每 10 秒一张
ffmpeg -y -i in.mp4 -vf fps=1/10 thumb_%03d.jpg

# 每个场景变化截一张（thumbnail 滤镜）
ffmpeg -y -i in.mp4 -vf "thumbnail=300" -frames:v 1 cover.jpg

ffmpeg -y -ss 1 -t 3 -i in.mp4 \
  -vf "fps=12,scale=480:-2:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
  out.gif

# 序列合成视频（文件名 frame_0001.png ...）
ffmpeg -y -framerate 30 -i frame_%04d.png -c:v libx264 -pix_fmt yuv420p -movflags +faststart out.mp4

# 视频拆成序列
ffmpeg -y -i in.mp4 -q:v 2 frame_%04d.png

# 一张图 + 一条音轨做成视频（封面音频那种）
ffmpeg -y -loop 1 -i cover.jpg -i audio.mp3 \
  -c:v libx264 -tune stillimage -pix_fmt yuv420p -c:a aac -b:a 192k -shortest out.mp4

ffmpeg -f avfoundation -list_devices true -i ""     # 先列出设备编号
ffmpeg -y -f avfoundation -i "1:0" \
  -c:v libx264 -preset ultrafast -crf 20 -pix_fmt yuv420p -c:a aac -b:a 128k out.mp4

ffmpeg -y -f x11grab -video_size 1920x1080 -framerate 30 -i :0.0 \
  -f pulse -i default \
  -c:v libx264 -preset ultrafast -crf 20 -pix_fmt yuv420p -c:a aac out.mkv

# Wayland / PipeWire 桌面
ffmpeg -y -f pipewire -i 0 -c:v libx264 -preset ultrafast out.mkv

ffmpeg -f list_devices true -i dummy        # 列出 DirectShow 设备
ffmpeg -y -f gdigrab -framerate 30 -i desktop -c:v libx264 -preset ultrafast out.mp4
ffmpeg -y -f dshow -i audio="麦克风阵列" -c:a aac voice.m4a

ffmpeg -re -i in.mp4 \
  -c:v libx264 -preset veryfast -b:v 3000k -maxrate 3000k -bufsize 6000k -g 60 \
  -c:a aac -b:a 128k -ar 44100 -f flv rtmp://host/live/streamkey

# 循环推一个文件（做测试流很好用）
ffmpeg -re -stream_loop -1 -i in.mp4 -c:v libx264 -preset veryfast -b:v 2500k \
  -c:a aac -b:a 128k -f flv rtmp://host/live/key

# 把直播存下来
ffmpeg -y -i rtmp://host/live/key -c copy -f mp4 out.mp4

# RTSP 摄像头（tcp 更稳）
ffmpeg -y -rtsp_transport tcp -i rtsp://user:pass@192.168.1.64/stream -c copy out.mp4

# 点播切片
ffmpeg -y -i in.mp4 -c:v libx264 -crf 23 -c:a aac \
  -f hls -hls_time 6 -hls_playlist_type vod -hls_segment_filename "seg_%03d.ts" out.m3u8

# 直播切片（滚动窗口）
ffmpeg -y -i rtmp://host/live/key -c:v libx264 -preset veryfast -c:a aac \
  -f hls -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+append_list live.m3u8

# 缩放 + 加亮 + 去噪
ffmpeg -y -i in.mp4 -vf "scale=1280:-2,eq=brightness=0.03,hqdn3d" \
  -c:v libx264 -crf 23 -c:a copy out.mp4

# 右下角水印 + 音频响度归一
ffmpeg -y -i in.mp4 -i logo.png -filter_complex "overlay=W-w-24:H-h-24" \
  -af loudnorm=I=-16:TP=-1.5 -c:v libx264 -crf 23 -c:a aac -b:a 160k out.mp4

# 2 倍速（画面和声音一起改）
ffmpeg -y -i in.mp4 -filter:v "setpts=0.5*PTS" -filter:a "atempo=2.0" \
  -c:v libx264 -crf 23 -c:a aac -b:a 160k out.mp4

# MKV 支持几乎所有字幕格式
ffmpeg -y -i in.mp4 -i sub.srt -c copy -c:s srt out.mkv

# MP4 里用 mov_text；ASS 特效会丢
ffmpeg -y -i in.mp4 -i sub.srt -c copy -c:s mov_text out.mp4

ffmpeg -y -i in.mp4 \
  -vf "subtitles=sub.srt:force_style='FontName=PingFang SC,FontSize=22'" \
  -c:v libx264 -crf 23 -c:a copy out.mp4

# 用显卡解码，CPU 侧滤镜，再硬件编码（滤镜时必须把数据搬回内存）
ffmpeg -y -hwaccel cuda -i in.mp4 -vf "scale=1280:-2" \
  -c:v h264_nvenc -preset p5 -rc vbr -cq 25 -c:a copy out.mp4

# 纯转封装式加速：只换编码，不动画面
ffmpeg -y -i in.mp4 -c:v h264_videotoolbox -b:v 6M -c:a aac -b:a 160k -movflags +faststart out.mp4

for f in *.mov; do
  ffmpeg -nostdin -y -loglevel error -i "$f" \
    -c:v libx264 -crf 22 -preset medium -pix_fmt yuv420p \
    -c:a aac -b:a 160k -movflags +faststart \
    "${f%.mov}.mp4"
done

find . -maxdepth 2 -name '*.mkv' -print0 \
  | xargs -0 -n 1 -P 4 -I{} sh -c 'ffmpeg -nostdin -y -loglevel error -i "{}" -c copy "${0%.mkv}.mp4"' {}

Get-ChildItem *.mov | ForEach-Object {
  ffmpeg -nostdin -y -i "$($_.Name)" -c:v libx264 -crf 22 -c:a aac -b:a 160k `
    "$($_.BaseName).mp4"
}