Mac 版 FFmpeg：一键为 OneMacTools 安装
FFmpeg 是 OneMacTools 视频和音频工具背后的免费开源引擎。它没有随 App 一起提供，因此当你第一次打开需要它的工具时，OneMacTools 会提议通过 Homebrew 一键安装。你也可以使用已有的副本。图像、PDF、文件和设备端 AI 工具从不需要 FFmpeg。
本页内容
FFmpeg 是什么，OneMacTools 为什么要用它？
FFmpeg 是一款广泛使用的开源程序，用于读取、转换和编辑音频与视频。它能理解的格式和编解码器远多于 macOS 本身：WebM 和 MKV 容器、VP9 和 Opus 编解码器、MP3 编码、精确控制文件大小的两遍编码、降噪滤镜等等。大多数视频 App 和网站都在幕后依赖它。
OneMacTools 在你的 Mac 上运行 FFmpeg，只处理你的文件。不会上传任何内容：FFmpeg 读取原件，将结果写入临时文件夹，再由 OneMacTools 将完成的文件移到你的输出文件夹中。FFmpeg 还附带 ffprobe，当 macOS 无法读取时（例如 MKV 或 WebM 文件），OneMacTools 会用它读取文件的时长、大小和编解码器。
FFmpeg 是一个独立项目，采用其自己的许可证，因此 OneMacTools 不包含它。只有在你要求时才会从 Homebrew 安装，详见我们的第三方软件条款和隐私政策。
哪些 OneMacTools 工具需要 FFmpeg？
这些工具会在检查器中显示 由 FFmpeg 驱动 一行，没有 FFmpeg 就无法运行：
| 类别 | 需要 FFmpeg 的工具 |
|---|---|
| 视频 | 压缩视频、压缩到指定大小、转换视频、剪辑视频、调整视频大小、裁剪视频、旋转和翻转视频、更改速度、视频静音、替换音频、视频加水印、社交视频预设、合并视频、视频转 GIF、提取帧、循环、倒放与回旋播放 |
| 音频 | 提取音频、转换音频、清理音频、剪辑音频、铃声制作、合并音频并统一音量 |
| 图像 | GIF 转 MP4 |
| 下载 | 下载视频（还需要 yt-dlp） |
仅在某个选项中使用 FFmpeg 的工具
- 屏幕录制：存储为 GIF 时使用 FFmpeg。没有 FFmpeg 时录制内容也绝不会丢失，而是存储为 MP4，并附注“已存储为 MP4 — GIF 需要 FFmpeg，你可以在‘设置’中安装”。
- 自动字幕：字幕轨道（可关闭） 需要 FFmpeg。烧录到画面中 无需 FFmpeg 也能使用。
其他所有工具，包括全部图像、PDF、文件、实用工具和设备端 AI 工具、录音、修复 HDR 视频颜色以及“你的 Mac”各界面，都使用 macOS 自己的框架，从不需要 FFmpeg。
如何从 OneMacTools 在 Mac 上安装 FFmpeg
OneMacTools 使用 Mac 的标准软件包管理器 Homebrew 安装 FFmpeg。如果你的 Mac 上已有 Homebrew，只需点按一下：
- 打开任意需要 FFmpeg 的工具，例如“转换视频”。顶部会出现一条橙色横幅，显示此工具需要 FFmpeg以及“OneMacTools 可以使用 Homebrew 为你安装。”
- 点按安装。Homebrew 下载并安装 FFmpeg 期间，横幅会显示正在安装…。在此期间你可以继续使用其他工具。
- 完成后，横幅会消失，工具即可使用。上表中的所有工具现在都可以使用 FFmpeg 了。
你也可以在 设置 › 辅助程序 中完成同样的操作：点按 FFmpeg 旁边的 使用 Homebrew 安装。安装完成后，该行会显示绿色对勾和 FFmpeg 的位置，例如 /opt/homebrew/bin/ffmpeg。
FFmpeg 的存储位置及其大小
Homebrew 会把 FFmpeg 放在它自己的文件夹中：Apple 芯片的 Mac 上为 /opt/homebrew，Intel 芯片的 Mac 上为 /usr/local。OneMacTools 不会把它拷贝到 App 或你的资源库中。Homebrew 还会安装 FFmpeg 所依赖的库，因此下载大小取决于你已经安装了什么；在网速较慢时，首次安装可能需要几分钟。
使用你已有的 FFmpeg（Homebrew、MacPorts 或自行编译的版本）
OneMacTools 会按顺序在以下文件夹中查找 ffmpeg 程序，并使用找到的第一个：
/opt/homebrew/bin（Apple 芯片上的 Homebrew）/usr/local/bin（Intel 芯片上的 Homebrew，以及许多手动安装）/opt/local/bin（MacPorts）
因此，如果你已经用 brew install ffmpeg 或 MacPorts 自行安装了 FFmpeg，就无需任何操作：“设置 › 辅助程序”中已经会显示绿色对勾。
自定 FFmpeg 路径
如果你的副本在其他位置，例如个人文件夹中的静态构建版本，请在“设置 › 辅助程序”的自定 FFmpeg 路径中输入其完整路径并按 Return 键。该路径必须指向 ffmpeg 程序本身（而不是其所在文件夹），且该文件必须可执行。自定路径优先于上述文件夹。为了读取文件详细信息，OneMacTools 会在其所用 FFmpeg 的同一文件夹中查找 ffprobe，因此请将二者放在一起。
FFmpeg 支持的格式与编解码器
安装 FFmpeg 后，OneMacTools 的转换工具可以输出以下格式：
| 输出 | 视频编解码器 | 音频编解码器 |
|---|---|---|
| MP4 和 MOV | H.264（yuv420p，随处可播放），针对流媒体优化 | AAC 160 kbps |
| MKV | H.264 | AAC 160 kbps |
| WebM | VP9 | Opus 128 kbps |
| MP3 | MP3（LAME，高质量 VBR） | |
| M4A | AAC 192 kbps | |
| WAV / AIFF | 16 位 PCM | |
| FLAC | FLAC（无损） |
“转换视频”可读取 MP4、MOV、WebM、MKV 和 M4V 文件，并输出为 MP4、MOV、WebM 或 MKV。“转换音频”可输出 MP3、M4A、WAV 或 FLAC。“压缩到指定大小”使用两遍编码，让结果小于你选择的大小。如需分步说明，请参阅在 Mac 上将 MOV 转为 MP4和压缩视频以便通过邮件发送。
其他辅助程序：yt-dlp、WebP tools 和 Ghostscript
“设置 › 辅助程序”列出了另外三个开源程序，少数工具依赖它们。它们的安装方式相同，可从工具的横幅安装，或使用使用 Homebrew 安装：
| 辅助程序 | 需要的功能 | 原因 |
|---|---|---|
| yt-dlp | 下载视频 | 从你粘贴的链接获取视频。 |
| WebP 工具 | 转换为 WebP | macOS 可以读取 WebP，但无法写入。 |
| Ghostscript | PDF 转 PDF/A | 输出归档用的 PDF/A 文件。 |
更新 FFmpeg
OneMacTools 不会自行更新 FFmpeg；它由 Homebrew 管理。要更新，请打开“终端”并运行 brew upgrade ffmpeg。OneMacTools 会在下次运行工具时使用新版本，无需重新启动。yt-dlp 也是如此：如果“下载视频”提示某个网站拒绝了下载，或下载的文件没有画面，其信息会建议你运行 brew upgrade yt-dlp。
更新 OneMacTools 本身（OneMacTools › 检查更新…）绝不会移除或替换 FFmpeg。
FFmpeg 无法使用？常见问题的解决方法
| 你会看到什么 | 怎么办 |
|---|---|
| “FFmpeg 未安装。请从上方的横幅或在‘设置’中安装。” | 点按横幅上的“安装”，或前往“设置 › 辅助工具 › 用 Homebrew 安装”。 |
| “未安装 Homebrew……” | 从 brew.sh 安装 Homebrew，或输入自定 FFmpeg 路径。 |
| “无法安装 FFmpeg：……” | Homebrew 报告了错误。请在“终端”中运行 brew doctor，修复它列出的问题后重试；或者自己运行 brew install ffmpeg 查看完整输出。 |
| 已输入自定路径，但没有绿色勾号 | 检查路径是否以 ffmpeg 结尾、该文件是否存在且可执行。在栏中按 Return 键可重新检查。 |
| “可切换的字幕轨道需要 FFmpeg……” | 安装 FFmpeg，或在“自动字幕”中选择“烧录到画面中”。 |
| 存储为 MP4 而非 GIF 的屏幕录制 | 找不到 FFmpeg，或制作 GIF 失败。请安装 FFmpeg，然后用“视频转 GIF”转换 MP4。 |
如果任务因其他原因失败，相关信息会显示在工具和“历史记录”中。疑难解答指南按症状涵盖了所有其他错误。
本页提到的工具
问题
FFmpeg 免费吗？在 Mac 上安装安全吗？
是的。FFmpeg 是被无数 App 使用的免费开源软件。OneMacTools 从 Homebrew 官方源安装标准的 Homebrew 软件包，而且 FFmpeg 只会在你的 Mac 上处理你自己的文件。
没有 FFmpeg，OneMacTools 能用吗？
可以。图像、PDF、文件、实用工具和设备端 AI 类工具都不需要它，“你的 Mac”中的各个界面也不需要。只有本页列出的视频和音频工具、“GIF 转 MP4”和“下载视频”需要 FFmpeg。
不用 Homebrew 能使用 FFmpeg 吗？
可以。用任意方式下载或编译 FFmpeg，然后在“设置 › 辅助程序 › 自定 FFmpeg 路径”中输入 ffmpeg 程序的完整路径。OneMacTools 也会自动找到 /opt/local/bin 中的 MacPorts 版本。
如何卸载 FFmpeg？
在“终端”中运行 brew uninstall ffmpeg。下次你打开需要它的工具时，OneMacTools 会再次显示安装横幅。卸载不会影响你已经生成的结果。
为什么我已经安装了 FFmpeg，OneMacTools 仍提示缺少它？
它只会在 /opt/homebrew/bin、/usr/local/bin 和 /opt/local/bin 以及你的自定路径中查找。如果你的副本在其他位置，请在“设置 › 辅助程序”中输入其完整路径并按 Return 键。
OneMacTools 能把 MKV 或 WebM 转换为 MP4 吗？
可以，只要安装了 FFmpeg。将 MKV 或 WebM 文件拖到“转换视频”上并选择 MP4；结果使用 H.264 视频和 AAC 音频，因此可以在 QuickTime、照片、iPhone 以及几乎所有 App 和网站中播放。一批文件会依次转换，存入同一个带日期的文件夹。
除了 FFmpeg，还需要 ffprobe 吗？
Homebrew 会随 FFmpeg 自动安装 ffprobe。OneMacTools 用它读取 macOS 自身无法打开的文件（例如 MKV）的时长、大小和编解码器，让进度和剩余时间更准确。如果使用自定路径，请把 ffprobe 放在同一个文件夹中。
OneMacTools 自带 FFmpeg 吗？
不是。FFmpeg 是一个独立的开源项目，有自己的许可证，因此只有在你要求时才会通过 Homebrew 安装，并由 Homebrew 而非本 App 负责更新。
