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 的工具 |
|---|---|
| 影片 | 壓縮影片、壓縮到指定大小、轉換影片、修剪影片、調整影片大小、裁切影片、旋轉與翻轉影片、更改速度、影片靜音、取代音訊、影片加浮水印、社群影片預設、合併影片、影片轉 GIF、擷取畫格、循環、倒轉與 Boomerang |
| 音訊 | 擷取音訊、轉換音訊、清理音訊、修剪音訊、鈴聲製作、合併與平衡音訊 |
| 影像 | GIF 轉 MP4 |
| 下載 | 下載影片（也需要 yt-dlp） |
只有某個選項會用到 FFmpeg 的工具
- 螢幕錄製：儲存為 GIF 時會使用 FFmpeg。沒有 FFmpeg 時錄影也絕不會遺失，而是會儲存為 MP4，並附上提示「已儲存為 MP4 — GIF 需要 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 在其他位置，例如放在個人專屬檔案夾中的靜態建置版本，請在「設定」›「輔助程式」的 自訂 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 工具和 Ghostscript
「設定」›「輔助程式」還列出了少數工具所依賴的另外三個開放原始碼程式。它們的安裝方式相同，可從工具的橫幅或 使用 Homebrew 安裝 安裝：
| 輔助程式 | 使用它的工具 | 原因 |
|---|---|---|
| yt-dlp | 下載影片 | 從你貼上的連結取得影片。 |
| WebP 工具 | 轉換成 WebP | macOS 可以讀取 WebP，但無法寫入。 |
| Ghostscript | PDF 轉 PDF/A | 寫入封存用的 PDF/A 檔案。 |
更新 FFmpeg
OneMacTools 不會自行更新 FFmpeg；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 中尋找，再加上你的自訂路徑。如果你的 FFmpeg 在其他位置，請在「設定」›「輔助程式」中輸入完整路徑，然後按 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 保持更新。
