让界面反过来教你命令行:从操作结果反推 FFmpeg 参数
让界面反过来教你命令行:从操作结果反推 FFmpeg 参数
大多数 FFmpeg 图形界面都在做同一件事:把你点的每一个按钮翻译成一条命令,然后背着你执行。用户得到成品,却依然不会写命令——下次换台机器、换个批处理场景,又回到搜索引擎里翻参数。
FFmpeg-GUI-Editor-Windows 这类工具的价值不止于“图形化”。它把中间那层翻译过程暴露了出来:右键保存按钮,你能看到即将执行的完整参数;执行中的 stderr 实时滚动在一个叫 "FFMPEG Data" 的窗口里;失败弹窗会连 Arguments、Stdout、Stderr 一起打印;甚至能把这次操作固化成 .bat,让你拖一批文件进去跑。换句话说,它是一座可反向通行的桥:先用界面把事做对,再从界面里把命令抄出来。
这篇文章不谈“GUI 比 CLI 好用”这种场面话,而是直接进入源码,看它的参数是怎么拼接的、哪些地方会和你的直觉不一样、以及抄出来的命令要怎样校验才敢放进生产脚本。
一、命令到底在哪里露出来
源码里有四个明确的信息出口,按“从即时到可复用”排序:
1. 保存前拦截:Inject Custom Arguments
btnSave 挂了一个右键菜单 cmsSaveOptions,里面是 Inject Custom Arguments 与 Generate Batch Script(见 MainForm.Designer.vb)。点击前者会把 mblnUserInjection 置真,然后正常走一次“另存为”:
Private Sub InjectCustomArgumentsToolStripMenuItem_Click(sender As Object, e As EventArgs) _
Handles InjectCustomArgumentsToolStripMenuItem.Click
mblnUserInjection = True
mblnBatchOutput = False
SaveAs()
End Sub
参数拼装完成后,在 MainForm.vb 的 GetFfmpegProcessInfo 末尾:
If mblnUserInjection Then
Dim manualEntryForm As New ManualEntryForm(processInfo.Arguments)
Select Case manualEntryForm.ShowDialog()
Case DialogResult.Cancel
mproFfmpegProcess = Nothing
Return Nothing
End Select
processInfo.Arguments = manualEntryForm.ModifiedText
End If
注意最后一行:你在弹窗里改的内容会被直接写回 Arguments。它不是只读预览,而是一个可编辑的命令行入口。ManualEntryForm 也能被 Ctrl+A 全选复制(ManualEntryForm.vb 里手动实现了 SelectAll,因为多行 TextBox 默认禁用了这个快捷键)。
2. 执行中:实时 stderr 窗口
AddRunHandlers 会在每次运行前弹出 runTextbox(标题 "FFMPEG Data",持久化窗口),并把 ErrorDataReceived 的每一行追加进 mobjErrorLog 后刷新过去:
Private Sub NewErrorData(sender As Object, e As System.Data.DataReceivedEventArgs)
If e.Data IsNot Nothing AndAlso Not String.IsNullOrEmpty(e.Data) Then
mobjErrorLog.AppendLine(e.Data)
runTextbox.SetText(mobjErrorLog.ToString)
End If
End Sub
FFmpeg 的进度、码率、frame 计数、以及“速度 1.02x”这类信息全在 stderr 上,所以这个窗口其实就是原生命令行的输出。真正决定成败的报错也在里面。
3. 失败后:完整证据快照
输出文件不存在时,CheckOutput 会弹出一个包含 Arguments、Stdout、Stderr 的对话框。这是最省事的一次性取证:出错的那条命令被原样保留,连同当时的上下文。
4. 复制后:批处理脚本
Generate Batch Script 走同一条拼装路径,但把输入/输出替换成占位符后写进 .bat。这条路径后面单独讲。
另外还有零散的小出口:状态栏右键的 ToolStripCropArg 是一个 width:height:x:y 的文本框(提示文字就是 "Crop arguments to be used (width:height:x:y)"),配合 CopyToolStripMenuItem 可以直接把 crop=1280:720:320:0 复制到剪贴板,用于跨项目复用裁切框。
二、一条命令的拼装顺序
GetFfmpegProcessInfo 是整个项目的“编译器”。理解它的拼接顺序,才能读懂复制出来的字符串。
processInfo.FileName = Application.StartupPath & "\ffmpeg.exe"
processInfo.Arguments += " -hide_banner"
...
processInfo.Arguments += startDurationArgs ' -ss
processInfo.Arguments += inputArgs ' -c:v libvpx-vp9(仅 webm) + -i "path"
processInfo.Arguments += outputDurationArgs ' -t
processInfo.Arguments += complexFilterString ' -filter_complex "[0:v] ... [outN]"
processInfo.Arguments += " -an" 或 -filter:a ...
processInfo.Arguments += " -q:v N"
processInfo.Arguments += " -r FPS"
processInfo.Arguments += " 输出路径"
几个值得记住的设计细节:
- 所有子进程都用
Application.StartupPath & "\ffmpeg.exe"。源码里 8 处ProcessStartInfo全是这个写法(Globals.vb、VideoData.vb、HolePuncherForm.vb)。所以它不是去PATH找 ffmpeg,而是认死程序目录——抄命令时如果本机 ffmpeg 在别处,路径要自己改。 - webm 输入被强制指定解码器:
InputArgs里写死了-c:v libvpx-vp9。这就是为什么同一个文件用 GUI 处理正常、你自己手写命令却报解码错误。 - 滤镜链一律用
-filter_complex,而不是简单的-vf。因为要支持“裁切→缩放→旋转→去重→抠像→变速→调色板”这类多级串联,它构造了一个[0:v] ... [out0]; [out0] ... [out1]的链式图,最后一个标签不写右值,交给 ffmpeg 自动映射为输出流。
Dim lastOutput As String = "[0:v]"
For paramIndex As Integer = 0 To videoFilterParams.Count - 1
If paramIndex = 0 Then complexFilterString += $" -filter_complex """
complexFilterString += $"{lastOutput} " & videoFilterParams(paramIndex) & $" [out{paramIndex}]; "
lastOutput = $"[out{paramIndex}]"
...
Next
三、三类操作的参数组合
1)时间轴剪切:-ss 与 select 的两套实现
这是一个很容易被忽略、但直接影响结果的分支。看 MainForm.vb 第 630 行附近:
If specProperties?.PlaybackVolume <> 0 Then
If specProperties.Trim IsNot Nothing Then
Dim duration As String = (specProperties.Trim.EndPTS) - (specProperties.Trim.StartPTS)
If duration > 0 Then
startDurationArgs = " -ss " & FormatHHMMSSm(specProperties.Trim.StartPTS)
outputDurationArgs = " -t " & (duration / specProperties.PlaybackSpeed).ToString
End If
End If
Else
If specProperties.Trim IsNot Nothing Then
videoFilterParams.Add($"select=between(n\,{specProperties.Trim.StartFrame}\,{specProperties.Trim.EndFrame}),setpts=PTS-STARTPTS")
End If
End If
也就是说:
- 有声轨道:走
-ss <起点> -i 输入 -t <时长>,-ss在-i之前,属于输入侧快速定位,靠时间戳对齐,速度快但依赖关键帧跳转后的精确定位(现代 ffmpeg 会解码到精确位置再丢弃,通常够用)。 - 静音(音量设为 0):改成
select=between(n,起始帧,结束帧),setpts=PTS-STARTPTS的滤镜,按帧号挑选,精度是“帧级”的,但要完整解码。
所以你会遇到这种反直觉现象:同一次剪切,勾选静音后生成命令的形态完全变了。这也是为什么从界面抄命令时,一定要看清自己当时有没有静音。
一条真实形态的剪切 + 裁切 + 缩放命令大致是:
ffmpeg.exe -hide_banner -ss 00:00:12.480 -i "D:\clips\raw.mp4" -t 8.32 ^
-filter_complex "[0:v] crop=1280:720:320:0 [out0]; [out0] scale=1280:720 [out1]" ^
-q:v 2 "D:\clips\out.mp4"
缩放的数值不是随手写的:scale = VerticalResolution / cropHeight,然后 ForceEven 强制偶数(Extensions.vb 里 ForceEven 对奇数减一)。因为 H.264/VP9 的 yuv420p 要求宽高是偶数,这一步是在替 ffmpeg 擦屁股。旋转 90/270 时宽高会交换位置,所以代码里那个 If 分支是必要的,不是笔误。
另外要留一个心眼:180° 旋转那一支多包了一层引号。
Dim rotateString As String = If(specProperties.Rotation = RotateFlipType.Rotate90FlipNone, "transpose=1",
If(specProperties.Rotation = RotateFlipType.Rotate180FlipNone, """transpose=2,transpose=2""", ...))
它最终会落进 -filter_complex "..." 内部,形成嵌套双引号。复制出来手动执行时,把内层引号删掉写成 [0:v] transpose=2,transpose=2 [out0] 即可。这属于“抄命令要读得懂”的典型场景。
2)只裁不缩:一个 filter 与零个 filter 的差别
没有缩放、没有旋转、没有滤镜,只有裁切时,-filter_complex 里就只剩一条 crop=。而如果什么都没改,代码有一个短路分支:
Dim sameExtension As Boolean = IO.Path.GetExtension(inputFile.FullPath).Equals(IO.Path.GetExtension(outPutFile))
If audioFilterParams.Count = 0 AndAlso videoFilterParams.Count = 0 AndAlso sameExtension _
AndAlso specProperties.Trim Is Nothing AndAlso Not softSubs AndAlso Not inputFile.InputMash Then
processInfo.Arguments += $" -c copy"
End If
四个条件全满足才会加 -c copy。这意味着:只要你裁了一刀、剪了一段、调了音量,就一定会重编码。想真正做流拷贝式的“无损剪切”,需要自己把命令改成:
ffmpeg.exe -hide_banner -ss 00:00:12.480 -i "input.mp4" -t 8.32 -c copy -avoid_negative_ts make_zero "out.mp4"
代价是切点会被吸附到最近的关键帧,除非源本身关键帧密集(可配合 -force_key_frames 预处理)。这是“界面反推命令”最有价值的地方:它给了你一个正确的起点,剩下的专业取舍由你决定。
顺带一个同类坑:HolePuncher(去重复片段工具)把长视频切成若干段时,用的是 -ss ... -i ... -t ... -q:v 0,没有 -c copy(HolePuncherForm.vb),也就是切片阶段就在重编码;切完再用 concat demuxer 以 -c copy 合并(Globals.vb)。照着这段逻辑手写脚本时,别以为它是全程无损。
3)音频、GIF 与透明通道:那些“看起来多余”的参数
提取音频只有两行判断:
If IO.Path.GetExtension(targetFilePath).Equals(detectedStreamExtension) Then
processInfo.Arguments += " -vn -acodec copy"
Else
processInfo.Arguments += " -vn"
End If
目标扩展名和源音频编码一致才 copy,否则老老实实转码。抄的时候记得 -vn 不能少,否则 ffmpeg 会抱怨容器不支持视频流。
音量与变速是一对联动参数。音量走 -filter:a volume=2,静音走 -an;变速则是视频 setpts=1/speed*PTS,音频 atempo=speed。当速度低于 0.5x 时,atempo 会拆成多级串联:
While currentTempo < 0.5
atempoStack.Add(0.5)
currentTempo = currentTempo / 0.5
End While
这就是为什么 0.25 倍速的命令里会出现 atempo=0.5,atempo=0.5——atempo 单级的合法区间是 0.5~100,超出必须级联。手写时忘了这一点的结果通常是直接报参数越界。
GIF 的帧率会被“整数化”。代码遍历 100 / 1..10,取与目标帧率最接近的一档:
For index As Integer = 1 To 10
Dim testRate As Double = 100 / index
If Math.Abs(currentRate - optimalRate) > Math.Abs(currentRate - testRate) Then
optimalRate = testRate
End If
Next
sProperties.FPS = optimalRate
因为 GIF 的帧延时以 1/100 秒为单位,只能表达 100、50、33.3、25、20、16.6… 所以你设 30fps 导出时看到 -r 25 不要以为是 bug,那是格式本身的约束。同一套逻辑也是确定性的——同样的输入设置必然得到同样的 -r。
透明通道是另一组“必须手写才知道”的参数。检测到源带 alpha 且输出为 .mkv/.mov/.avi 时补 -c:v ffv1 -pix_fmt yuva420p;.webm 用 -c:v vp9 -crf 0 -pix_fmt yuva420p;.png 走 -f apng -plays 0;.webp 走 -vcodec libwebp_anim -lossless 1 -loop 0。不带 alpha 的 GIF 则用标准两步调色板:
split [a][b];[a] palettegen [p];[b]fifo[c];[c][p] paletteuse=dither=none
带 alpha 的版本更复杂,还额外拼了 geq 去修正 8bit alpha 转 1bit 时的饱和度衰减。这类滤镜链基本不可能靠记忆写对,能直接复制是刚需。
四、把一次操作固化成脚本
Generate Batch Script 走的是同一条 GetFfmpegProcessInfo,只是把两个路径换成了占位符:
directoryScript = directoryScript.Replace("<?<SVEInputPath>?>", "%~1\%%~F")
directoryScript = directoryScript.Replace("<?<SVEOutputPath>?>", $"%~1\%outDirectoryName%\{outPrefix}%%~nF{outSuffix}{ext}")
fileScript = fileScript.Replace("<?<SVEInputPath>?>", "%%~F")
fileScript = fileScript.Replace("<?<SVEOutputPath>?>", $"%%~dpF\%outDirectoryName%\{outPrefix}%%~nF{outSuffix}{ext}")
模板文件是 Resources/BatchTemplate.bat,本身写得相当克制,值得单独读一遍:
set outDirectoryName=SHINY,所有产物统一落到源文件旁的SHINY子目录,不覆盖原件;- ffmpeg 路径有三级回退:脚本上级目录 →
C:\Program Files\Simple Video Editor\ffmpeg.exe→ 当前工作目录,最后才用写入时的绝对路径; - 用
%~a1的第一个字符判断拖进来的是文件还是目录,目录走for /f "delims=" %%F in ('dir /b /a-d ...'),文件走for %%F in (%*); - 真正执行的那行是
call %ffmpegPath% -v error -stats <你的参数>。注意它把日志级别改成了-v error -stats,比 GUI 里的-hide_banner更安静——这是给批处理场景做的适配,你在自己脚本里也可以照抄。
文件名前缀/后缀的处理也有小心思:保存对话框里预填 optionalPrefix(原名)optionalSuffix,生成脚本时用 Regex.Split 把原名两侧切开,如果用户没改就还原成空串。这样“批量加前缀”这件事就变成了一个可视化填空。
一个实际可用的产出大概长这样(节选):
set ffmpegPath="D:\Tools\FFmpeg-GUI-Editor\ffmpeg.exe"
...
for %%F in (%*) do (
ECHO %%~F
call %ffmpegPath% -v error -stats -hide_banner -i "%%~F" ^
-filter_complex "[0:v] scale=1280:720 [out0]" -q:v 2 ^
"%%~dpF\%outDirectoryName%\%%~nF.mp4"
)
把这段拖到几十个文件上,等于把界面上那一次点击变成了流水线。
五、校验:同一条命令跑两次,结果一样吗
把命令抄进脚本前,最好先回答这个问题。答案是:分情况,而且差异来源很具体。
确定性较好的部分:
- 所有滤镜参数都是常量或由确定性计算得出(
ForceEven、GIF 帧率量化、atempo级联); -c copy的纯封装路径,码流本身未变,理论上可逐包对齐;- 静音剪切用的
select=between(n,...)是帧号选择,与时间戳抖动无关。
确定会变的部分:
- 容器元数据。重封装会写入新的
creation_time、encoder标签,甚至handler_name。要可比,必须加-map_metadata -1,必要时再补-fflags +bitexact -flags +bitexact。 - 编码器本身。libx264/libvpx 在多线程下的码率控制与帧决策可能受线程数影响,跨机器、跨 CPU 核心数对比会得到不同的字节流。要追求可复现,就在命令里显式固定
-threads 1、-crf、-preset、-g,别依赖默认值。 - 时间基与
-ss的定位。输入侧-ss的落点依赖容器索引与关键帧分布,不同 ffmpeg 版本行为可能微调。
校验的最小闭环,建议直接对着码流而不是整文件做哈希:
rem 逐包校验(封装差异会被排除,只看压缩数据)
ffmpeg -v error -i out.mp4 -map 0:v -c copy -f streamhash -hash sha256 -
rem 逐帧校验(解码后像素级对比,跨封装也能比)
ffmpeg -v error -i out.mp4 -map 0:v -f framemd5 -
两次执行后用 fc /b 或直接比对两个哈希清单:streamhash 一致说明压缩数据没变(通常是 -c copy 路径),framemd5 一致说明解码结果一致(说明即使重编码,参数也稳定)。如果两者都一致但文件大小不同,那基本只剩元数据在作怪,加 -map_metadata -1 再测一次即可定位。
还有一个容易踩的本地化问题:-t 的取值是 (duration / PlaybackSpeed).ToString,走的是当前区域设置。在德语、法语等使用逗号作小数点的系统上,可能生成 -t 8,32 这样的参数。抄命令时若看到逗号,改成点号再执行,或者干脆用 -to 加完整 HH:MM:SS.mmm 时间戳——本项目里 FormatHHMMSSm 就是按固定宽度拼接的,不含区域差异,可以直接复用它的输出格式。
六、把这套方法用成习惯
回到最初的问题:界面该不该替代命令行?这个项目的回答是“不该,但可以教会你”。它把 -hide_banner、-ss/-t、-filter_complex 链、-q:v、-r、-c copy 短路、透明格式补丁这一整套翻译逻辑摊在源码里,也摊在你的右键菜单里。
可操作的路径只有三步:
- 用界面把效果调到满意,右键 Save → Inject Custom Arguments,把命令复制出来;
- 对照本文第二、三节,确认每个参数是“效果需要”还是“实现妥协”(比如 180° 旋转的多余引号、静音导致的
select分支); - 需要批量就改用 Generate Batch Script 拿模板,需要无损就把滤镜摘掉换成
-c copy,最后用streamhash/framemd5跑两遍做一致性验证。
命令行的学习曲线之所以陡,是因为它要求你先知道参数存在,才可能去查它。而这个 GUI 的价值,恰恰是先给你一条能跑通的命令,再倒过来告诉你:参数在这儿。
