ffmpeg 文件檔案

目錄

1 概要

ffmpeg [global_options] {[input_file_options] -i input_url} ... {[output_file_options] output_url} ...

2 描述

ffmpeg 是一個通用的媒體轉換器。它可以讀取各種輸入 - 包括即時擷取/錄製裝置 - 濾波，並將它們轉碼成大量的輸出格式。

ffmpeg 從任意數量的輸入（可以是常規檔案、管道、網路串流、擷取裝置等）讀取，這些輸入由 -i 選項指定，並寫入任意數量的輸出，這些輸出由純輸出 URL 指定。在命令列上找到的任何無法解釋為選項的內容都被視為輸出 URL。

原則上，每個輸入或輸出都可以包含任意數量的不同類型（視訊/音訊/字幕/附件/資料）的基本串流，儘管允許的串流計數和/或類型可能受到容器格式的限制。從哪些輸入中選擇哪些串流進入哪個輸出，可以自動完成，也可以使用 -map 選項（請參閱 串流選擇 章節）。

若要在選項中引用輸入/輸出，您必須使用它們的索引（從 0 開始）。例如，第一個輸入是 0，第二個是 1，依此類推。同樣地，輸入/輸出中的串流也由它們的索引引用。例如，2:3 指的是第三個輸入或輸出中的第四個串流。另請參閱 串流指定器 章節。

作為一般規則，選項會應用於下一個指定的檔案。因此，順序很重要，而且您可以在命令列上多次使用相同的選項。每次出現都會應用於下一個輸入或輸出檔案。此規則的例外是全域選項（例如，詳細程度），應首先指定。

不要混合輸入和輸出檔案 – 先指定所有輸入檔案，然後再指定所有輸出檔案。也不要混合屬於不同檔案的選項。所有選項僅適用於下一個輸入或輸出檔案，並且在檔案之間重設。

以下是一些簡單的範例。

• 透過重新編碼媒體串流，將輸入媒體檔案轉換為不同的格式

  ffmpeg -i input.avi output.mp4
  

• 將輸出檔案的視訊位元率設定為 64 kbit/s

  ffmpeg -i input.avi -b:v 64k -bufsize 64k output.mp4
  

• 強制輸出檔案的影格速率為 24 fps

  ffmpeg -i input.avi -r 24 output.mp4
  

• 強制輸入檔案（僅對原始格式有效）的影格速率為 1 fps，輸出檔案的影格速率為 24 fps

  ffmpeg -r 1 -i input.m2v -r 24 output.mp4
  

原始輸入檔案可能需要格式選項。

3 詳細描述

ffmpeg 從下面列出的組件建立轉碼管線。然後，程式的運作包括輸入資料區塊從來源向下流到接收器，同時被它們沿途遇到的組件轉換。

以下是可用的組件種類

• 解多工器（"demultiplexers" 的縮寫）讀取輸入來源以提取
  • 全域屬性，例如中繼資料或章節；
  • 輸入基本串流及其屬性列表

  為每個 -i 選項建立一個解多工器實例，並將編碼的封包傳送到解碼器或多工器。

  在其他文獻中，解多工器有時稱為分離器，因為它們的主要功能是將檔案分成基本串流（儘管有些檔案僅包含一個基本串流）。

  解多工器的示意圖如下所示

  ┌──────────┬───────────────────────┐
  │ demuxer  │                       │ packets for stream 0
  ╞══════════╡ elementary stream 0   ├──────────────────────►
  │          │                       │
  │  global  ├───────────────────────┤
  │properties│                       │ packets for stream 1
  │   and    │ elementary stream 1   ├──────────────────────►
  │ metadata │                       │
  │          ├───────────────────────┤
  │          │                       │
  │          │     ...........       │
  │          │                       │
  │          ├───────────────────────┤
  │          │                       │ packets for stream N
  │          │ elementary stream N   ├──────────────────────►
  │          │                       │
  └──────────┴───────────────────────┘
       ▲
       │
       │ read from file, network stream,
       │     grabbing device, etc.
       │
  

• 解碼器 接收音訊、視訊或字幕基本串流的編碼（壓縮）封包，並將它們解碼成原始幀（視訊為像素陣列，音訊為 PCM）。解碼器通常與解多工器中的基本串流關聯（並從中接收輸入），但有時也可能獨立存在（請參閱迴路解碼器）。

  解碼器的示意圖如下所示

            ┌─────────┐
   packets  │         │ raw frames
  ─────────►│ decoder ├────────────►
            │         │
            └─────────┘
  

• 濾鏡圖 處理和轉換原始音訊或視訊幀。濾鏡圖由一個或多個連結成圖的個別濾鏡組成。濾鏡圖有兩種形式 - 簡單和複雜，分別使用 -filter 和 -filter_complex 選項進行配置。

  簡單濾鏡圖與輸出基本串流關聯；它從解碼器接收要過濾的輸入，並將過濾後的輸出發送到該輸出串流的編碼器。

  執行去交錯（使用 yadif 去交錯器）然後調整大小（使用 scale 濾鏡）的簡單視訊濾鏡圖可能如下所示

               ┌────────────────────────┐
               │  simple filtergraph    │
   frames from ╞════════════════════════╡ frames for
   a decoder   │  ┌───────┐  ┌───────┐  │ an encoder
  ────────────►├─►│ yadif ├─►│ scale ├─►│────────────►
               │  └───────┘  └───────┘  │
               └────────────────────────┘
  

  複雜濾鏡圖是獨立的，不與任何特定串流關聯。它可能有多個（或零個）輸入，可能具有不同類型（音訊或視訊），每個輸入都從解碼器或另一個複雜濾鏡圖的輸出接收資料。它還有一個或多個輸出，這些輸出饋送到編碼器或另一個複雜濾鏡圖的輸入。

  以下範例圖表示具有 3 個輸入和 2 個輸出（全部為視訊）的複雜濾鏡圖

            ┌─────────────────────────────────────────────────┐
            │               complex filtergraph               │
            ╞═════════════════════════════════════════════════╡
   frames   ├───────┐  ┌─────────┐      ┌─────────┐  ┌────────┤ frames
  ─────────►│input 0├─►│ overlay ├─────►│ overlay ├─►│output 0├────────►
            ├───────┘  │         │      │         │  └────────┤
   frames   ├───────┐╭►│         │    ╭►│         │           │
  ─────────►│input 1├╯ └─────────┘    │ └─────────┘           │
            ├───────┘                 │                       │
   frames   ├───────┐ ┌─────┐ ┌─────┬─╯              ┌────────┤ frames
  ─────────►│input 2├►│scale├►│split├───────────────►│output 1├────────►
            ├───────┘ └─────┘ └─────┘                └────────┤
            └─────────────────────────────────────────────────┘
  

  來自第二個輸入的幀疊加在來自第一個輸入的幀之上。來自第三個輸入的幀被重新縮放，然後複製成兩個相同的串流。其中一個疊加在組合的前兩個輸入之上，結果作為濾鏡圖的第一個輸出公開。另一個副本最終成為濾鏡圖的第二個輸出。

• 編碼器 接收原始音訊、視訊或字幕幀，並將它們編碼成編碼封包。編碼（壓縮）過程通常是有損的 - 它會降低串流品質以使輸出更小；某些編碼器是無損的，但代價是輸出大小大得多。視訊或音訊編碼器從某些濾鏡圖的輸出接收其輸入，字幕編碼器從解碼器接收輸入（因為尚不支援字幕過濾）。每個編碼器都與某些多工器的輸出基本串流關聯，並將其輸出發送到該多工器。

  編碼器的示意圖如下所示

               ┌─────────┐
   raw frames  │         │ packets
  ────────────►│ encoder ├─────────►
               │         │
               └─────────┘
  

• 多工器（"multiplexers" 的縮寫）從編碼器（轉碼路徑）或直接從解多工器（串流複製路徑）接收其基本串流的編碼封包，對它們進行交錯處理（當有多個基本串流時），並將產生的位元組寫入輸出檔案（或管道、網路串流等）。

  多工器的示意圖如下所示

                         ┌──────────────────────┬───────────┐
   packets for stream 0  │                      │   muxer   │
  ──────────────────────►│  elementary stream 0 ╞═══════════╡
                         │                      │           │
                         ├──────────────────────┤  global   │
   packets for stream 1  │                      │properties │
  ──────────────────────►│  elementary stream 1 │   and     │
                         │                      │ metadata  │
                         ├──────────────────────┤           │
                         │                      │           │
                         │     ...........      │           │
                         │                      │           │
                         ├──────────────────────┤           │
   packets for stream N  │                      │           │
  ──────────────────────►│  elementary stream N │           │
                         │                      │           │
                         └──────────────────────┴─────┬─────┘
                                                      │
                       write to file, network stream, │
                           grabbing device, etc.      │
                                                      │
                                                      ▼
  

3.1 串流複製

ffmpeg 中最簡單的管道是單串流串流複製，即複製一個輸入基本串流的封包，而無需解碼、過濾或編碼它們。例如，考慮一個名為 INPUT.mkv 的輸入檔案，其中包含 3 個基本串流，我們從中取出第二個串流並將其寫入檔案 OUTPUT.mp4。這種管道的示意圖如下所示

┌──────────┬─────────────────────┐
│ demuxer  │                     │ unused
╞══════════╡ elementary stream 0 ├────────╳
│          │                     │
│INPUT.mkv ├─────────────────────┤          ┌──────────────────────┬───────────┐
│          │                     │ packets  │                      │   muxer   │
│          │ elementary stream 1 ├─────────►│  elementary stream 0 ╞═══════════╡
│          │                     │          │                      │OUTPUT.mp4 │
│          ├─────────────────────┤          └──────────────────────┴───────────┘
│          │                     │ unused
│          │ elementary stream 2 ├────────╳
│          │                     │
└──────────┴─────────────────────┘

可以使用以下命令列建構上述管道

ffmpeg -i INPUT.mkv -map 0:1 -c copy OUTPUT.mp4

在此命令列中

• 有一個單一輸入 INPUT.mkv；
• 此輸入沒有輸入選項；
• 有一個單一輸出 OUTPUT.mp4；
• 此輸出有兩個輸出選項
  • -map 0:1 選擇要使用的輸入串流 - 從索引為 0（即第一個）的輸入中選擇索引為 1（即第二個）的串流；
  • -c copy 選擇 copy 編碼器，即不進行解碼或編碼的串流複製。

串流複製適用於更改基本串流計數、容器格式或修改容器級中繼資料。由於沒有解碼或編碼，因此速度非常快，並且沒有品質損失。但是，由於各種因素（例如，目標容器所需的某些資訊在來源中不可用），它可能在某些情況下無法運作。顯然，應用濾鏡也是不可能的，因為濾鏡作用於解碼後的幀。

可以建構更複雜的串流複製場景 - 例如，將來自兩個輸入檔案的串流組合到單個輸出中

┌──────────┬────────────────────┐         ┌────────────────────┬───────────┐
│ demuxer 0│                    │ packets │                    │   muxer   │
╞══════════╡elementary stream 0 ├────────►│elementary stream 0 ╞═══════════╡
│INPUT0.mkv│                    │         │                    │OUTPUT.mp4 │
└──────────┴────────────────────┘         ├────────────────────┤           │
┌──────────┬────────────────────┐         │                    │           │
│ demuxer 1│                    │ packets │elementary stream 1 │           │
╞══════════╡elementary stream 0 ├────────►│                    │           │
│INPUT1.aac│                    │         └────────────────────┴───────────┘
└──────────┴────────────────────┘

可以使用命令列建構該場景

ffmpeg -i INPUT0.mkv -i INPUT1.aac -map 0:0 -map 1:0 -c copy OUTPUT.mp4

輸出 -map 選項在此處使用了兩次，在輸出檔案中建立兩個串流 - 一個由第一個輸入饋送，另一個由第二個輸入饋送。單個 -c 選項實例為這兩個串流選擇串流複製。您也可以將此選項的多個實例與 串流指定器 一起使用，以將不同的值應用於每個串流，這將在後續章節中示範。

相反的場景是將來自單個輸入的多個串流拆分為多個輸出

┌──────────┬─────────────────────┐          ┌───────────────────┬───────────┐
│ demuxer  │                     │ packets  │                   │ muxer 0   │
╞══════════╡ elementary stream 0 ├─────────►│elementary stream 0╞═══════════╡
│          │                     │          │                   │OUTPUT0.mp4│
│INPUT.mkv ├─────────────────────┤          └───────────────────┴───────────┘
│          │                     │ packets  ┌───────────────────┬───────────┐
│          │ elementary stream 1 ├─────────►│                   │ muxer 1   │
│          │                     │          │elementary stream 0╞═══════════╡
└──────────┴─────────────────────┘          │                   │OUTPUT1.mp4│
                                            └───────────────────┴───────────┘

使用以下命令建構

ffmpeg -i INPUT.mkv -map 0:0 -c copy OUTPUT0.mp4 -map 0:1 -c copy OUTPUT1.mp4

請注意，即使 -c 選項的值相同，每個輸出檔案也需要一個單獨的實例。這是因為非全域選項（即大多數選項）僅在它們之前檔案的上下文中應用。

這些範例當然可以進一步推廣到任意數量的輸入到任意數量的輸出的重新對應。

3.2 轉碼

轉碼 是解碼串流然後再次編碼它的過程。由於編碼往往在計算上很昂貴，並且在大多數情況下會降低串流品質（即它是有損的），因此您應該僅在需要時進行轉碼，否則執行串流複製。轉碼的典型原因包括

• 應用濾鏡 - 例如，調整大小、去交錯或疊加視訊；重新取樣或混合音訊；
• 您想要將串流饋送到無法解碼原始編解碼器的裝置。

請注意，除非您為音訊、視訊和字幕串流指定 -c copy，否則 ffmpeg 將會轉碼所有這些串流。

考慮一個範例管道，該管道讀取具有一個音訊串流和一個視訊串流的輸入檔案，轉碼視訊並將音訊複製到單個輸出檔案中。這可以示意性地表示如下

┌──────────┬─────────────────────┐
│ demuxer  │                     │       audio packets
╞══════════╡ stream 0 (audio)    ├─────────────────────────────────────╮
│          │                     │                                     │
│INPUT.mkv ├─────────────────────┤ video    ┌─────────┐     raw        │
│          │                     │ packets  │  video  │ video frames   │
│          │ stream 1 (video)    ├─────────►│ decoder ├──────────────╮ │
│          │                     │          │         │              │ │
└──────────┴─────────────────────┘          └─────────┘              │ │
                                                                     ▼ ▼
                                                                     │ │
┌──────────┬─────────────────────┐ video    ┌─────────┐              │ │
│ muxer    │                     │ packets  │  video  │              │ │
╞══════════╡ stream 0 (video)    │◄─────────┤ encoder ├──────────────╯ │
│          │                     │          │(libx264)│                │
│OUTPUT.mp4├─────────────────────┤          └─────────┘                │
│          │                     │                                     │
│          │ stream 1 (audio)    │◄────────────────────────────────────╯
│          │                     │
└──────────┴─────────────────────┘

並使用以下命令列實作

ffmpeg -i INPUT.mkv -map 0:v -map 0:a -c:v libx264 -c:a copy OUTPUT.mp4

請注意它是如何使用串流指定器 :v 和 :a 來選擇輸入串流並將 -c 選項的不同值應用於它們的；有關更多詳細資訊，請參閱 串流指定器 章節。

3.3 濾鏡處理

轉碼時，可以在編碼之前使用簡單或複雜濾鏡圖來過濾音訊和視訊串流。

3.3.1 簡單濾鏡圖

簡單濾鏡圖是指恰好有一個輸入和一個輸出，並且兩者類型相同（音訊或視訊）的濾鏡圖。它們使用每個串流的 -filter 選項（使用 -vf 和 -af 別名分別表示 -filter:v (視訊) 和 -filter:a (音訊)）進行配置。請注意，簡單濾鏡圖與其輸出串流綁定，因此，例如，如果您有多個音訊串流，-af 將為每個串流建立一個單獨的濾鏡圖。

以上述轉碼範例為例，新增過濾（並省略音訊以求清晰）使其看起來像這樣

┌──────────┬───────────────┐
│ demuxer  │               │          ┌─────────┐
╞══════════╡ video stream  │ packets  │  video  │ frames
│INPUT.mkv │               ├─────────►│ decoder ├─────►───╮
│          │               │          └─────────┘         │
└──────────┴───────────────┘                              │
                                  ╭───────────◄───────────╯
                                  │   ┌────────────────────────┐
                                  │   │  simple filtergraph    │
                                  │   ╞════════════════════════╡
                                  │   │  ┌───────┐  ┌───────┐  │
                                  ╰──►├─►│ yadif ├─►│ scale ├─►├╮
                                      │  └───────┘  └───────┘  ││
                                      └────────────────────────┘│
                                                                │
                                                                │
┌──────────┬───────────────┐ video    ┌─────────┐               │
│ muxer    │               │ packets  │  video  │               │
╞══════════╡ video stream  │◄─────────┤ encoder ├───────◄───────╯
│OUTPUT.mp4│               │          │         │
│          │               │          └─────────┘
└──────────┴───────────────┘

3.3.2 複雜濾鏡圖

複雜濾鏡圖是那些無法簡單地描述為應用於一個串流的線性處理鏈的濾鏡圖。例如，當圖具有多個輸入和/或輸出，或者當輸出串流類型與輸入不同時，就會發生這種情況。複雜濾鏡圖使用 -filter_complex 選項進行配置。請注意，此選項是全域的，因為複雜濾鏡圖本質上無法與單個串流或檔案明確關聯。每個 -filter_complex 實例都會建立一個新的複雜濾鏡圖，並且可以有任意數量的濾鏡圖。

複雜濾鏡圖的一個簡單範例是 overlay 濾鏡，它有兩個視訊輸入和一個視訊輸出，其中一個視訊疊加在另一個視訊之上。它的音訊對應物是 amix 濾鏡。

3.4 Loopback 解碼器

雖然解碼器通常與解多工器串流關聯，但也可以建立「迴路」解碼器，這些解碼器解碼來自某些編碼器的輸出，並允許將其回饋到複雜濾鏡圖。這是透過 -dec 指令完成的，該指令將應解碼的輸出串流的索引作為參數。每個此類指令都會建立一個新的迴路解碼器，索引從零開始的連續整數。然後應使用這些索引在複雜濾鏡圖連結標籤中引用迴路解碼器，如 -filter_complex 的文件中所述。

可以透過將解碼 AVOptions 放置在 -dec 之前，以類似於輸入/輸出選項的方式傳遞到迴路解碼器。

例如，以下範例

ffmpeg -i INPUT                                        \
  -map 0:v:0 -c:v libx264 -crf 45 -f null -            \
  -threads 3 -dec 0:0                                  \
  -filter_complex '[0:v][dec:0]hstack[stack]'          \
  -map '[stack]' -c:v ffv1 OUTPUT

讀取輸入視訊並

• （第 2 行）使用低品質的 libx264 對其進行編碼；
• （第 3 行）使用 3 個執行緒解碼此編碼串流；
• （第 4 行）將解碼後的視訊與原始輸入視訊並排放置；
• （第 5 行）組合後的視訊然後進行無損編碼並寫入 OUTPUT。

這樣的轉碼管道可以用以下圖表表示

┌──────────┬───────────────┐
│ demuxer  │               │   ┌─────────┐            ┌─────────┐    ┌────────────────────┐
╞══════════╡ video stream  │   │  video  │            │  video  │    │ null muxer         │
│   INPUT  │               ├──►│ decoder ├──┬────────►│ encoder ├─┬─►│(discards its input)│
│          │               │   └─────────┘  │         │(libx264)│ │  └────────────────────┘
└──────────┴───────────────┘                │         └─────────┘ │
                                 ╭───────◄──╯   ┌─────────┐       │
                                 │              │loopback │       │
                                 │ ╭─────◄──────┤ decoder ├────◄──╯
                                 │ │            └─────────┘
                                 │ │
                                 │ │
                                 │ │  ┌───────────────────┐
                                 │ │  │complex filtergraph│
                                 │ │  ╞═══════════════════╡
                                 │ │  │  ┌─────────────┐  │
                                 ╰─╫─►├─►│   hstack    ├─►├╮
                                   ╰─►├─►│             │  ││
                                      │  └─────────────┘  ││
                                      └───────────────────┘│
                                                           │
┌──────────┬───────────────┐  ┌─────────┐                  │
│ muxer    │               │  │  video  │                  │
╞══════════╡ video stream  │◄─┤ encoder ├───────◄──────────╯
│  OUTPUT  │               │  │ (ffv1)  │
│          │               │  └─────────┘
└──────────┴───────────────┘

4 串流選擇

ffmpeg 提供 -map 選項，用於手動控制每個輸出檔案中的串流選擇。使用者可以跳過 -map，讓 ffmpeg 執行如下所述的自動串流選擇。 -vn / -an / -sn / -dn 選項可用於分別跳過包含視訊、音訊、字幕和資料串流，無論是手動對應還是自動選擇，但複雜濾鏡圖的輸出串流除外。

4.1 描述

以下小節描述了串流選擇中涉及的各種規則。接下來的範例展示了如何在實務中應用這些規則。

儘管已盡一切努力準確反映程式的行為，但 FFmpeg 仍在持續開發中，並且程式碼可能自撰寫本文時起已變更。

4.1.1 自動串流選擇

在特定輸出檔案沒有任何對應選項的情況下，ffmpeg 會檢查輸出格式，以檢查可以包含在其中的串流類型，即視訊、音訊和/或字幕。對於每種可接受的串流類型，ffmpeg 將從所有輸入中選擇一個串流（如果可用）。

它將根據以下條件選擇該串流

• 對於視訊，它是解析度最高的串流，
• 對於音訊，它是通道數最多的串流，
• 對於字幕，它是找到的第一個字幕串流，但有一個注意事項。輸出格式的預設字幕編碼器可以是基於文字的或基於圖像的，並且只會選擇相同類型的字幕串流。

如果多個相同類型的串流速率相同，則選擇索引最低的串流。

資料或附件串流不會自動選擇，只能使用 -map 包含。

4.1.2 手動串流選擇

當使用 -map 時，只有使用者對應的串流才會包含在該輸出檔案中，複雜濾鏡圖輸出的一個可能例外情況除外，如下所述。

4.1.3 複雜濾鏡圖

如果存在任何具有未標記襯墊的複雜濾鏡圖輸出串流，它們將被新增到第一個輸出檔案。如果輸出格式不支援串流類型，則會導致嚴重錯誤。在沒有對應選項的情況下，包含這些串流會導致跳過其類型的自動串流選擇。如果存在對應選項，則除了對應的串流之外，還會包含這些濾鏡圖串流。

具有標記襯墊的複雜濾鏡圖輸出串流必須對應一次且僅對應一次。

4.1.4 串流處理

串流處理獨立於串流選擇，但字幕除外，如下所述。串流處理是透過針對特定輸出檔案中串流的 -codec 選項設定的。特別是，編解碼器選項在串流選擇過程之後由 ffmpeg 應用，因此不影響後者。如果沒有為串流類型指定 -codec 選項，ffmpeg 將選擇輸出檔案多工器註冊的預設編碼器。

字幕存在例外情況。如果為輸出檔案指定了字幕編碼器，則將包含找到的任何類型（文字或圖像）的第一個字幕串流。 ffmpeg 不會驗證指定的編碼器是否可以轉換選定的串流，或者轉換後的串流是否在輸出格式中可接受。這也普遍適用：當使用者手動設定編碼器時，串流選擇過程無法檢查編碼後的串流是否可以多工處理到輸出檔案中。如果不能，ffmpeg 將中止，並且所有輸出檔案都將處理失敗。

4.2 範例

以下範例說明了 ffmpeg 串流選擇方法的行為、怪癖和限制。

它們假設以下三個輸入檔案。

input file 'A.avi'
      stream 0: video 640x360
      stream 1: audio 2 channels

input file 'B.mp4'
      stream 0: video 1920x1080
      stream 1: audio 2 channels
      stream 2: subtitles (text)
      stream 3: audio 5.1 channels
      stream 4: subtitles (text)

input file 'C.mkv'
      stream 0: video 1280x720
      stream 1: audio 2 channels
      stream 2: subtitles (image)

範例：自動串流選擇

ffmpeg -i A.avi -i B.mp4 out1.mkv out2.wav -map 1:a -c:a copy out3.mov

指定了三個輸出檔案，並且對於前兩個檔案，未設定 -map 選項，因此 ffmpeg 將自動為這兩個檔案選擇串流。

out1.mkv 是一個 Matroska 容器檔案，接受視訊、音訊和字幕串流，因此 ffmpeg 將嘗試選擇每種類型中的一種。
對於視訊，它將從 B.mp4 中選擇 stream 0，該串流在所有輸入視訊串流中具有最高的解析度。
對於音訊，它將從 B.mp4 中選擇 stream 3，因為它具有最多的通道數。
對於字幕，它將從 B.mp4 中選擇 stream 2，它是 A.avi 和 B.mp4 中第一個字幕串流。

out2.wav 僅接受音訊串流，因此僅選擇來自 B.mp4 的 stream 3。

對於 out3.mov，由於設定了 -map 選項，因此不會發生自動串流選擇。 -map 1:a 選項將從第二個輸入 B.mp4 中選擇所有音訊串流。此輸出檔案中將不包含其他串流。

對於前兩個輸出，所有包含的串流都將被轉碼。選擇的編碼器將是每個輸出格式註冊的預設編碼器，這可能與選定輸入串流的編解碼器不符。

對於第三個輸出，音訊串流的編解碼器選項已設定為 copy，因此不會發生或可能發生解碼-過濾-編碼操作。選定串流的封包應從輸入檔案傳輸並多工處理到輸出檔案中。

範例：自動字幕選擇

ffmpeg -i C.mkv out1.mkv -c:s dvdsub -an out2.mkv

儘管 out1.mkv 是一個接受字幕串流的 Matroska 容器檔案，但只會選擇視訊和音訊串流。 C.mkv 的字幕串流是基於圖像的，而 Matroska 多工器的預設字幕編碼器是基於文字的，因此預計字幕的轉碼操作會失敗，因此不會選擇該串流。但是，在 out2.mkv 中，命令中指定了字幕編碼器，因此除了視訊串流外，還選擇了字幕串流。 -an 的存在停用了 out2.mkv 的音訊串流選擇。

範例：未標記的濾鏡圖輸出

ffmpeg -i A.avi -i C.mkv -i B.mp4 -filter_complex "overlay" out1.mp4 out2.srt

此處使用 -filter_complex 選項設定濾鏡圖，並且由單個視訊濾鏡組成。 overlay 濾鏡正好需要兩個視訊輸入，但未指定任何輸入，因此使用前兩個可用的視訊串流，即 A.avi 和 C.mkv 的視訊串流。濾鏡的輸出襯墊沒有標籤，因此會發送到第一個輸出檔案 out1.mp4。因此，跳過了視訊串流的自動選擇，否則會選擇 B.mp4 中的串流。具有最多通道數的音訊串流，即 B.mp4 中的 stream 3，會自動選擇。但是，由於 MP4 格式沒有註冊預設字幕編碼器，並且使用者未指定字幕編碼器，因此不會選擇字幕串流。

第二個輸出檔案 out2.srt 僅接受基於文字的字幕串流。因此，即使第一個可用的字幕串流屬於 C.mkv，但它是基於圖像的，因此被跳過。選定的串流，B.mp4 中的 stream 2，是第一個基於文字的字幕串流。

範例：標記的濾鏡圖輸出

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -map '[outv]' -an        out1.mp4 \
                                out2.mkv \
       -map '[outv]' -map 1:a:0 out3.mkv

上述命令將會失敗，因為標記為 [outv] 的輸出襯墊已被對應兩次。不會處理任何輸出檔案。

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -an        out1.mp4 \
                  out2.mkv \
       -map 1:a:0 out3.mkv

上面的這個命令也會失敗，因為色調濾鏡輸出有一個標籤 [outv]，但未對應到任何地方。

應該將命令修改如下，

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0,split=2[outv1][outv2];overlay;aresample" \
        -map '[outv1]' -an        out1.mp4 \
                                  out2.mkv \
        -map '[outv2]' -map 1:a:0 out3.mkv

來自 B.mp4 的視訊串流被傳送到色相濾鏡，其輸出使用 split 濾鏡複製一次，並且兩個輸出都被標記。然後每個副本都被映射到第一個和第三個輸出檔案。

overlay 濾鏡需要兩個視訊輸入，它使用前兩個未使用的視訊串流。這些串流來自 A.avi 和 C.mkv。overlay 的輸出未被標記，因此它被傳送到第一個輸出檔案 out1.mp4，無論 -map 選項是否存在。

aresample 濾鏡被傳送第一個未使用的音訊串流，即來自 A.avi 的串流。由於此濾鏡輸出也未被標記，因此它也被映射到第一個輸出檔案。-an 的存在僅抑制音訊串流的自動或手動選擇，而不是從濾鏡圖發送的輸出。這兩個映射的串流應在 out1.mp4 中映射的串流之前排序。

映射到 out2.mkv 的視訊、音訊和字幕串流完全由自動串流選擇決定。

out3.mkv 由來自色相濾鏡的複製視訊輸出和來自 B.mp4 的第一個音訊串流組成。

5 選項

所有數值選項，如果沒有另行指定，都接受表示數字的字串作為輸入，其後可以跟隨 SI 單位字首之一，例如：'K'、'M' 或 'G'。

如果將 'i' 附加到 SI 單位字首，則完整的字首將被解釋為二進制倍數的單位字首，二進制倍數基於 1024 的冪而不是 1000 的冪。將 'B' 附加到 SI 單位字首會將該值乘以 8。這允許使用，例如：'KB'、'MiB'、'G' 和 'B' 作為數字後綴。

不帶參數的選項是布林選項，並將對應的值設定為 true。它們可以通過在選項名稱前加上 "no" 來設定為 false。例如，使用 "-nofoo" 將把名為 "foo" 的布林選項設定為 false。

帶參數的選項支援一種特殊的語法，其中在命令列上給出的參數被解釋為從中載入實際參數值之檔案的路徑。要使用此功能，請在選項名稱前緊鄰添加一個正斜線 '/'（在開頭的破折號之後）。例如：

ffmpeg -i INPUT -/filter:v filter.script OUTPUT

將從名為 filter.script 的檔案載入濾鏡圖描述。

5.1 串流指定器

某些選項是逐串流應用的，例如位元速率或編解碼器。串流指定器用於精確指定給定選項屬於哪個或哪些串流。

串流指定器是一個字串，通常附加到選項名稱並用冒號與之分隔。例如，-codec:a:1 ac3 包含 a:1 串流指定器，它匹配第二個音訊串流。因此，它將為第二個音訊串流選擇 ac3 編解碼器。

一個串流指定器可以匹配多個串流，以便將該選項應用於所有這些串流。例如，-b:a 128k 中的串流指定器匹配所有音訊串流。

空的串流指定器匹配所有串流。例如，-codec copy 或 -codec: copy 將複製所有串流而不重新編碼。

串流指定器的可能形式為

stream_index

匹配具有此索引的串流。例如，-threads:1 4 將第二個串流的執行緒計數設定為 4。如果 stream_index 用作附加串流指定器（見下文），則它從匹配的串流中選擇串流編號 stream_index。串流編號基於 libavformat 偵測到的串流順序，除非還指定了串流群組指定器或程式 ID。在這種情況下，它基於群組或程式中串流的順序。

stream_type[:additional_stream_specifier]

stream_type 是以下之一：'v' 或 'V' 代表視訊，'a' 代表音訊，'s' 代表字幕，'d' 代表資料，以及 't' 代表附件。'v' 匹配所有視訊串流，'V' 僅匹配非附加圖片、視訊縮圖或封面藝術的視訊串流。如果使用 additional_stream_specifier，則它匹配既具有此類型又匹配 additional_stream_specifier 的串流。否則，它匹配指定類型的所有串流。

g:group_specifier[:additional_stream_specifier]

匹配屬於具有指定器 group_specifier 之群組的串流。如果使用 additional_stream_specifier，則它匹配既是群組的一部分又匹配 additional_stream_specifier 的串流。group_specifier 可以是以下之一

group_index

匹配具有此群組索引的串流。

#group_id 或 i:group_id

匹配具有此群組 ID 的串流。

p:program_id[:additional_stream_specifier]

匹配屬於具有 ID program_id 之程式的串流。如果使用 additional_stream_specifier，則它匹配既是程式的一部分又匹配 additional_stream_specifier 的串流。

#stream_id 或 i:stream_id

通過串流 ID（例如 MPEG-TS 容器中的 PID）匹配串流。

m:key[:value]

匹配具有元數據標籤 key 且具有指定值的串流。如果未給出 value，則匹配包含具有任何值的給定標籤的串流。key 或 value 中的冒號字元 ':' 需要使用反斜線跳脫。

disp:dispositions[:additional_stream_specifier]

匹配具有給定處置的串流。dispositions 是使用 '+' 連接的一個或多個處置（如 -dispositions 選項所印出的）的列表。

u

匹配具有可用組態的串流，編解碼器必須已定義，並且必要的資訊（例如視訊尺寸或音訊取樣率）必須存在。

請注意，在 ffmpeg 中，通過元數據匹配僅適用於輸入檔案。

5.2 通用選項

這些選項在 ff* 工具之間共享。

-L

顯示許可證。

-h, -?, -help, --help [arg]

顯示說明。可以指定一個可選參數來印出關於特定項目的說明。如果未指定任何參數，則僅顯示基本（非進階）工具選項。

arg 的可能值為

long

除了基本工具選項外，還印出進階工具選項。

full

印出完整的選項列表，包括編碼器、解碼器、解多工器、多工器、濾鏡等的共享和私有選項。

decoder=decoder_name

印出關於名為 decoder_name 的解碼器的詳細資訊。使用 -decoders 選項以取得所有解碼器的列表。

encoder=encoder_name

印出關於名為 encoder_name 的編碼器的詳細資訊。使用 -encoders 選項以取得所有編碼器的列表。

demuxer=demuxer_name

印出關於名為 demuxer_name 的解多工器的詳細資訊。使用 -formats 選項以取得所有解多工器和多工器的列表。

muxer=muxer_name

印出關於名為 muxer_name 的多工器的詳細資訊。使用 -formats 選項以取得所有多工器和解多工器的列表。

filter=filter_name

印出關於名為 filter_name 的濾鏡的詳細資訊。使用 -filters 選項以取得所有濾鏡的列表。

bsf=bitstream_filter_name

印出關於名為 bitstream_filter_name 的位元流濾鏡的詳細資訊。使用 -bsfs 選項以取得所有位元流濾鏡的列表。

protocol=protocol_name

印出關於名為 protocol_name 的協定的詳細資訊。使用 -protocols 選項以取得所有協定的列表。

-version

顯示版本。

-buildconf

顯示建置組態，每行一個選項。

-formats

顯示可用的格式（包括裝置）。

-demuxers

顯示可用的解多工器。

-muxers

顯示可用的多工器。

-devices

顯示可用的裝置。

-codecs

顯示 libavcodec 已知的所有編解碼器。

請注意，在整篇文件中，術語「編解碼器」被用作更正確的媒體位元流格式的簡稱。

-decoders

顯示可用的解碼器。

-encoders

顯示所有可用的編碼器。

-bsfs

顯示可用的位元流濾鏡。

-protocols

顯示可用的協定。

-filters

顯示可用的 libavfilter 濾鏡。

-pix_fmts

顯示可用的像素格式。

-sample_fmts

顯示可用的樣本格式。

-layouts

顯示通道名稱和標準通道版面配置。

-dispositions

顯示串流處置。

-colors

顯示已識別的顏色名稱。

-sources device[,opt1=val1[,opt2=val2]...]

顯示輸入裝置的自動偵測來源。某些裝置可能會提供無法自動偵測的系統相關來源名稱。不能假定返回的列表始終完整。

ffmpeg -sources pulse,server=192.168.0.4

-sinks device[,opt1=val1[,opt2=val2]...]

顯示輸出裝置的自動偵測接收器。某些裝置可能會提供無法自動偵測的系統相關接收器名稱。不能假定返回的列表始終完整。

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [flags+]loglevel | -v [flags+]loglevel

設定日誌記錄級別和程式庫使用的標誌。

可選的 flags 字首可以包含以下值

‘repeat’

表示重複的日誌輸出不應壓縮到第一行，並且將省略「最後一條訊息重複 n 次」行。

‘level’

表示日誌輸出應在每條訊息行中添加 [level] 字首。這可以用作日誌著色的替代方案，例如在將日誌轉儲到檔案時。

標誌也可以單獨使用，方法是在前面添加 '+'/'-' 字首以設定/重置單個標誌，而不影響其他 flags 或更改 loglevel。當同時設定 flags 和 loglevel 時，預期在最後一個 flags 值和 loglevel 之前使用 '+' 分隔符。

loglevel 是一個字串或數字，包含以下值之一

‘quiet, -8’

完全不顯示任何內容；保持靜默。

‘panic, 0’

僅顯示可能導致程序崩潰的致命錯誤，例如斷言失敗。目前這沒有用於任何用途。

‘fatal, 8’

僅顯示致命錯誤。這些是程序絕對無法繼續的錯誤之後的錯誤。

‘error, 16’

顯示所有錯誤，包括可以從中恢復的錯誤。

‘warning, 24’

顯示所有警告和錯誤。將顯示任何與可能不正確或意外事件相關的訊息。

‘info, 32’

在處理期間顯示資訊性訊息。這是警告和錯誤之外的訊息。這是預設值。

‘verbose, 40’

與 info 相同，只是更詳細。

‘debug, 48’

顯示所有內容，包括偵錯資訊。

‘trace, 56’

例如，要啟用重複的日誌輸出、添加 level 字首，並將 loglevel 設定為 verbose

ffmpeg -loglevel repeat+level+verbose -i input output

另一個範例，啟用重複的日誌輸出，而不影響 level 字首標誌或 loglevel 的目前狀態

ffmpeg [...] -loglevel +repeat

預設情況下，程式會記錄到 stderr。如果終端機支援著色，則顏色用於標記錯誤和警告。可以通過設定環境變數 AV_LOG_FORCE_NOCOLOR 來停用日誌著色，或者可以通過設定環境變數 AV_LOG_FORCE_COLOR 來強制啟用。

-report

將完整的命令列和日誌輸出轉儲到目前目錄中名為 program-YYYYMMDD-HHMMSS.log 的檔案中。此檔案對於錯誤報告很有用。它也暗示了 -loglevel debug。

將環境變數 FFREPORT 設定為任何值都具有相同的效果。如果該值是以 ':' 分隔的 key=value 序列，則這些選項將影響報告；如果選項值包含特殊字元或選項分隔符 ':'，則必須對其進行跳脫（請參閱 ffmpeg-utils 手冊中的「引號和跳脫」章節）。

以下選項被識別

file

設定用於報告的檔案名稱；%p 展開為程式名稱，%t 展開為時間戳記，%% 展開為純 %

level

使用數值設定日誌詳細程度級別（請參閱 -loglevel）。

例如，要使用 32 的日誌級別（info 日誌級別的別名）將報告輸出到名為 ffreport.log 的檔案

FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

解析環境變數中的錯誤不是致命的，並且不會出現在報告中。

-hide_banner

抑制印出橫幅。

所有 FFmpeg 工具通常都會顯示版權聲明、建置選項和程式庫版本。此選項可用於抑制印出此資訊。

-cpuflags flags (global)

允許設定和清除 CPU 標誌。此選項旨在用於測試。除非您知道自己在做什麼，否則請勿使用它。

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

此選項的可能標誌為

‘x86’

‘mmx’

‘mmxext’

‘sse’

‘sse2’

‘sse2slow’

‘sse3’

‘sse3slow’

‘ssse3’

‘atom’

‘sse4.1’

‘sse4.2’

‘avx’

‘avx2’

‘xop’

‘fma3’

‘fma4’

‘3dnow’

‘3dnowext’

‘bmi1’

‘bmi2’

‘cmov’

‘ARM’

‘armv5te’

‘armv6’

‘armv6t2’

‘vfp’

‘vfpv3’

‘neon’

‘setend’

‘AArch64’

‘armv8’

‘vfp’

‘neon’

‘PowerPC’

‘altivec’

‘Specific Processors’

‘pentium2’

‘pentium3’

‘pentium4’

‘k6’

‘k62’

‘athlon’

‘athlonxp’

‘k8’

-cpucount count (global)

覆寫 CPU 計數的偵測。此選項旨在用於測試。除非您知道自己在做什麼，否則請勿使用它。

ffmpeg -cpucount 2

-max_alloc bytes

為 ffmpeg 系列 malloc 函數在堆積上分配的區塊設定最大大小限制。使用此選項時請極其謹慎。如果您不完全理解這樣做的後果，請勿使用。預設值為 INT_MAX。

5.3 AVOptions

這些選項由 libavformat、libavdevice 和 libavcodec 程式庫直接提供。要查看可用 AVOption 的列表，請使用 -help 選項。它們分為兩類

generic

這些選項可以為任何容器、編解碼器或裝置設定。通用選項列在容器/裝置的 AVFormatContext 選項下，以及編解碼器的 AVCodecContext 選項下。

private

這些選項特定於給定的容器、裝置或編解碼器。私有選項列在其對應的容器/裝置/編解碼器下。

例如，若要將 ID3v2.3 標頭寫入 MP3 檔案，而非預設的 ID3v2.4，請使用 MP3 多工器 (muxer) 的 id3v2_version 私有選項。

ffmpeg -i input.flac -id3v2_version 3 out.mp3

所有編解碼器 AVOptions 都是針對每個串流 (per-stream) 設定的，因此應將串流指定器附加到它們。

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

在上述範例中，一個多聲道音訊串流被對應輸出兩次。第一個實例使用 ac3 編解碼器和 640k 位元率進行編碼。第二個實例被降混為 2 個聲道，並使用 aac 編解碼器進行編碼。使用輸出串流的絕對索引為其指定了 128k 的位元率。

注意：-nooption 語法不能用於布林值 AVOptions，請使用 -option 0/-option 1。

注意：舊的、未公開的文件方式，透過在選項名稱前加上 v/a/s 來指定每個串流的 AVOptions，現在已過時，並將很快移除。

5.4 主要選項

-f fmt (輸入/輸出)

強制輸入或輸出檔案格式。格式通常會自動偵測輸入檔案，並從輸出檔案的副檔名猜測，因此在大多數情況下不需要此選項。

-i url (輸入)

輸入檔案網址 (url)

-y (全域)

覆寫輸出檔案而不詢問。

-n (全域)

不要覆寫輸出檔案，如果指定的輸出檔案已存在，則立即結束。

-stream_loop number (輸入)

設定輸入串流應循環播放的次數。循環 0 表示不循環，循環 -1 表示無限循環。

-recast_media (全域)

允許強制使用與解多工器偵測或指定的媒體類型不同的解碼器。適用於解碼多工為資料串流的媒體資料。

-c[:stream_specifier] codec (輸入/輸出，每個串流)

-codec[:stream_specifier] codec (輸入/輸出，每個串流)

為一個或多個串流選擇編碼器（在輸出檔案之前使用時）或解碼器（在輸入檔案之前使用時）。codec 是解碼器/編碼器的名稱，或特殊值 copy（僅限輸出），表示串流不應重新編碼。

例如

ffmpeg -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT

使用 libx264 編碼所有視訊串流，並複製所有音訊串流。

對於每個串流，都會套用最後一個符合的 c 選項，因此

ffmpeg -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT

將複製除第二個視訊以外的所有串流，第二個視訊將使用 libx264 進行編碼，而第 138 個音訊將使用 libvorbis 進行編碼。

-t duration (輸入/輸出)

當用作輸入選項（在 -i 之前）時，限制從輸入檔案讀取的資料 duration 長度。

當用作輸出選項（在輸出網址之前）時，在輸出持續時間達到 duration 後停止寫入輸出。

duration 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

-to 和 -t 是互斥的，-t 具有優先權。

-to position (輸入/輸出)

在 position 停止寫入輸出或讀取輸入。position 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

-to 和 -t 是互斥的，-t 具有優先權。

-fs limit_size (輸出)

設定檔案大小限制，以位元組表示。超過限制後，不會再寫入任何位元組區塊。輸出檔案的大小會略微超過請求的檔案大小。

-ss position (輸入/輸出)

當用作輸入選項（在 -i 之前）時，在此輸入檔案中搜尋到 position。請注意，在大多數格式中，無法精確搜尋，因此 ffmpeg 將搜尋到 position 之前的最接近搜尋點。當進行轉碼且啟用 -accurate_seek（預設值）時，搜尋點和 position 之間的額外區段將被解碼並丟棄。當執行串流複製或使用 -noaccurate_seek 時，它將被保留。

當用作輸出選項（在輸出網址之前）時，解碼但丟棄輸入，直到時間戳記達到 position。

position 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

-sseof position (輸入)

類似於 -ss 選項，但相對於「檔案結尾」(end of file)。也就是說，負值在檔案中較早，0 在 EOF。

-isync input_index (輸入)

將輸入指定為同步來源。

這將取得目標輸入和參考輸入的開始時間之間的差異，並將目標檔案的時間戳記偏移該差異。兩個輸入的來源時間戳記應來自相同的時鐘來源，以獲得預期的結果。如果設定了 copyts，則也必須設定 start_at_zero。如果任一輸入沒有開始時間戳記，則不會進行同步調整。

可接受的值是參考有效 ffmpeg 輸入索引的值。如果同步參考是目標索引本身或 -1，則不會對目標時間戳記進行調整。同步參考本身不得與任何其他輸入同步。

預設值為 -1。

-itsoffset offset (輸入)

設定輸入時間偏移。

offset 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

偏移會加到輸入檔案的時間戳記。指定正偏移表示對應的串流會延遲 offset 中指定的時間長度。

-itsscale scale (輸入，每個串流)

重新調整輸入時間戳記。scale 應為浮點數。

-timestamp date (輸出)

設定容器中的錄製時間戳記。

date 必須是日期規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的日期章節。

-metadata[:metadata_specifier] key=value (輸出，每個中繼資料)

設定中繼資料鍵/值對。

可以給定選用的 metadata_specifier，以在串流、章節或節目上設定中繼資料。請參閱 -map_metadata 文件以了解詳細資訊。

此選項會覆寫使用 -map_metadata 設定的中繼資料。也可以透過使用空值來刪除中繼資料。

例如，在輸出檔案中設定標題

ffmpeg -i in.avi -metadata title="my title" out.flv

設定第一個音訊串流的語言

ffmpeg -i INPUT -metadata:s:a:0 language=eng OUTPUT

-disposition[:stream_specifier] value (輸出，每個串流)

設定串流的 disposition 旗標。

預設值：預設情況下，所有 disposition 旗標都從輸入串流複製，除非此選項套用的輸出串流是由複雜的濾鏡圖 (filtergraph) 提供 - 在這種情況下，預設不會設定任何 disposition 旗標。

value 是一系列 disposition 旗標，以 '+' 或 '-' 分隔。'+' 前綴會新增給定的 disposition，'-' 前綴會移除它。如果第一個旗標也以 '+' 或 '-' 為前綴，則產生的 disposition 是預設值，並由 value 更新。如果第一個旗標沒有前綴，則產生的 disposition 為 value。也可以透過將其設定為 0 來清除 disposition。

如果沒有為輸出檔案指定 -disposition 選項，當輸出檔案中有多個相同類型的串流，且該類型沒有串流已標記為預設時，ffmpeg 將自動在每種類型的第一個串流上設定 'default' disposition 旗標。

-dispositions 選項列出已知的 disposition 旗標。

例如，將第二個音訊串流設為預設串流

ffmpeg -i in.mkv -c copy -disposition:a:1 default out.mkv

將第二個字幕串流設為預設串流，並從第一個字幕串流中移除預設 disposition

ffmpeg -i in.mkv -c copy -disposition:s:0 0 -disposition:s:1 default out.mkv

新增嵌入式封面/縮圖

ffmpeg -i in.mp4 -i IMAGE -map 0 -map 1 -c copy -c:v:1 png -disposition:v:1 attached_pic out.mp4

從第一個音訊串流新增 'original' 並移除 'comment' disposition 旗標，而不移除其其他 disposition 旗標

ffmpeg -i in.mkv -c copy -disposition:a:0 +original-comment out.mkv

從第一個音訊串流移除 'original' 並新增 'comment' disposition 旗標，而不移除其其他 disposition 旗標

ffmpeg -i in.mkv -c copy -disposition:a:0 -original+comment out.mkv

僅在第一個音訊串流上設定 'original' 和 'comment' disposition 旗標（並移除其其他 disposition 旗標）

ffmpeg -i in.mkv -c copy -disposition:a:0 original+comment out.mkv

從第一個音訊串流中移除所有 disposition 旗標

ffmpeg -i in.mkv -c copy -disposition:a:0 0 out.mkv

並非所有多工器都支援嵌入式縮圖，而支援的多工器也僅支援少數格式，例如 JPEG 或 PNG。

-program [title=title:][program_num=program_num:]st=stream[:st=stream...] (輸出)

建立具有指定 title、program_num 的節目，並將指定的 stream 新增至其中。

-stream_group [map=input_file_id=stream_group][type=type:]st=stream[:st=stream][:stg=stream_group][:id=stream_group_id...] (輸出)

建立指定 type 和 stream_group_id 的串流群組，或透過 map 映射輸入群組，將指定的 stream 和/或先前定義的 stream_group 新增至其中。

type 可以是以下之一

iamf_audio_element

將屬於相同 IAMF 音訊元素 (Audio Element) 的 stream 分組

對於此群組 type，可以使用以下選項

audio_element_type

音訊元素類型。支援以下值

channel

可擴展聲道音訊表示法

scene

Ambisonics 表示法

demixing

用於重建可擴展聲道音訊表示法的解混音 (Demixing) 資訊。此選項必須以 ',' 與其餘部分分隔，並採用以下鍵=值選項

parameter_id

訊框 (frame) 中的識別碼參數區塊可能參考

dmixp_mode

預定義的解混音參數組合

recon_gain

用於重建可擴展聲道音訊表示法的重建增益 (Recon gain) 資訊。此選項必須以 ',' 與其餘部分分隔，並採用以下鍵=值選項

parameter_id

訊框 (frame) 中的識別碼參數區塊可能參考

layer

定義音訊元素中聲道佈局的圖層 (Layer)。此選項必須以 ',' 與其餘部分分隔。可以定義多個以 ',' 分隔的條目，且至少必須設定一個。

它採用以下以 ":" 分隔的鍵=值選項

ch_layout

圖層的聲道佈局

flags

可以使用以下旗標

recon_gain

是否發出訊號表示 recon_gain 是否作為中繼資料存在於訊框內的參數區塊中

output_gain

output_gain_flags

output_gain 適用於哪些聲道。可以使用以下旗標

FL

FR

BL

BR

TFL

TFR

ambisonics_mode

ambisonics 模式。如果 audio_element_type 設定為 channel，則此選項無效。

支援以下值

mono

每個 ambisonics 聲道都編碼為群組中的個別單聲道串流

default_w

預設權重值

iamf_mix_presentation

將屬於所有 IAMF 音訊元素 (Audio Element) 的相同 IAMF 混音呈現 (Mix Presentation) 參考的 stream 分組

對於此群組 type，可以使用以下選項

submix

混音呈現 (Mix Presentation) 內的子混音 (Sub-mix)。此選項必須以 ',' 與其餘部分分隔。可以定義多個以 ',' 分隔的條目，且至少必須設定一個。

它採用以下以 ":" 分隔的鍵=值選項

parameter_id

訊框中的識別碼參數區塊可能參考，用於後處理混合音訊訊號，以產生用於播放的音訊訊號

parameter_rate

參考此 parameter_id 的訊框中參數區塊的取樣率持續時間欄位表示為

default_mix_gain

當給定訊框沒有與 parameter_id 相同的參數區塊時，要套用的預設混音增益值

element

參考此混音呈現 (Mix Presentation) 中使用的音訊元素 (Audio Element)，以產生用於播放的最終輸出音訊訊號。此選項必須以 '|' 與其餘部分分隔。可以定義多個以 '|' 分隔的條目，且至少必須設定一個。

它採用以下以 ":" 分隔的鍵=值選項

stg

此子混音 (Sub-mix) 參考的音訊元素 (Audio Element) 的 stream_group_id

parameter_id

訊框中的識別碼參數區塊可能參考，用於在與其他處理過的音訊元素 (Audio Element) 相加之前，對參考和呈現的音訊元素 (Audio Element) 應用任何處理

parameter_rate

參考此 parameter_id 的訊框中參數區塊的取樣率持續時間欄位表示為

default_mix_gain

當給定訊框沒有與 parameter_id 相同的參數區塊時，要套用的預設混音增益值

annotations

描述子混音元素 (Sub-mix element) 的鍵=值字串，其中 "key" 是符合 BCP-47 的字串，用於指定 "value" 字串的語言。"key" 必須與混音的 annotations 中的 "key" 相同

headphones_rendering_mode

指示當在耳機上播放時，輸入的基於聲道的音訊元素 (Audio Element) 是呈現給立體聲揚聲器還是使用雙耳渲染器進行空間化。如果參考的音訊元素 (Audio Element) 的 audio_element_type 設定為 channel，則此選項無效。

支援以下值

stereo

binaural

layout

指定此子混音 (Sub-mix) 上測量響度資訊的佈局。此選項必須以 '|' 與其餘部分分隔。可以定義多個以 '|' 分隔的條目，且至少必須設定一個。

它採用以下以 ":" 分隔的鍵=值選項

layout_type

loudspeakers

佈局遵循 ITU-2051-3 的揚聲器聲音系統慣例。

binaural

佈局為雙耳。

sound_system

聲道佈局符合 ITU-2051-3 的聲音系統 A 到 J，外加 7.1.2 和 3.1.2。如果 layout_type 設定為 binaural，則此選項無效。

integrated_loudness

程式整合響度資訊，如 ITU-1770-4 中所定義。

digital_peak

音訊訊號的數位（取樣）峰值，如 ITU-1770-4 中所定義。

true_peak

音訊訊號的真峰值，如 ITU-1770-4 中所定義。

dialog_anchored_loudness

對白響度資訊，如 ITU-1770-4 中所定義。

album_anchored_loudness

專輯響度資訊，如 ITU-1770-4 中所定義。

annotations

描述混音的鍵=值字串字串，其中 "key" 是符合 BCP-47 的字串，用於指定 "value" 字串的語言。"key" 必須與所有子混音元素 (Sub-mix element) 的 annotations 中的 "key" 相同

例如，從多個 WAV 輸入檔案建立可擴展的 5.1 IAMF 檔案

ffmpeg -i front.wav -i back.wav -i center.wav -i lfe.wav
-map 0:0 -map 1:0 -map 2:0 -map 3:0 -c:a opus
-stream_group type=iamf_audio_element:id=1:st=0:st=1:st=2:st=3,
demixing=parameter_id=998,
recon_gain=parameter_id=101,
layer=ch_layout=stereo,
layer=ch_layout=5.1,
-stream_group type=iamf_mix_presentation:id=2:stg=0:annotations=en-us=Mix_Presentation,
submix=parameter_id=100:parameter_rate=48000|element=stg=0:parameter_id=100:annotations=en-us=Scalable_Submix|layout=sound_system=stereo|layout=sound_system=5.1
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.iamf

將具有四個串流的輸入 IAMF 檔案中的兩個串流群組（音訊元素 (Audio Element) 和混音呈現 (Mix Presentation)）複製到 mp4 輸出中

ffmpeg -i input.iamf -c:a copy -stream_group map=0=0:st=0:st=1:st=2:st=3 -stream_group map=0=1:stg=0
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.mp4

-target type (輸出)

指定目標檔案類型 (vcd, svcd, dvd, dv, dv50)。type 可以加上 pal-、ntsc- 或 film- 前綴，以使用對應的標準。然後會自動設定所有格式選項（位元率、編解碼器、緩衝區大小）。您可以直接輸入

ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg

儘管如此，您仍然可以指定其他選項，只要您知道它們與標準沒有衝突，例如

ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg

每個目標設定的參數如下。

VCD

pal:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x288 -r 25
-codec:v mpeg1video -g 15 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

ntsc:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 30000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

film:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 24000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

SVCD

pal:
-f svcd -packetsize 2324
-s 480x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

ntsc:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

film:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

DVD

pal:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

ntsc:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

film:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

DV

pal:
-f dv
-s 720x576 -pix_fmt yuv420p -r 25
-ar 48000 -ac 2

ntsc:
-f dv
-s 720x480 -pix_fmt yuv411p -r 30000/1001
-ar 48000 -ac 2

film:
-f dv
-s 720x480 -pix_fmt yuv411p -r 24000/1001
-ar 48000 -ac 2

dv50 目標與 dv 目標相同，不同之處在於為所有三個標準設定的像素格式為 yuv422p。

上述參數的任何使用者設定值都將覆寫目標預設值。在這種情況下，輸出可能不符合目標標準。

-dn (輸入/輸出)

作為輸入選項，阻止檔案的所有資料串流被過濾或自動選擇或映射到任何輸出。請參閱 -discard 選項以個別停用串流。

作為輸出選項，停用資料錄製，即自動選擇或映射任何資料串流。如需完全手動控制，請參閱 -map 選項。

-dframes number (輸出)

設定要輸出的資料訊框 (frame) 數量。這是 -frames:d 的過時別名，您應該改用它。

-frames[:stream_specifier] framecount (輸出，每個串流)

在 framecount 個訊框 (frame) 後停止寫入串流。

-q[:stream_specifier] q (輸出，每個串流)

-qscale[:stream_specifier] q (輸出，每個串流)

使用固定品質比例 (VBR)。q/qscale 的含義取決於編解碼器。如果 qscale 在沒有 stream_specifier 的情況下使用，則它僅適用於視訊串流，這是為了保持與先前行為的相容性，並且當沒有使用 stream_specifier 時，為兩個不同的編解碼器（即音訊和視訊）指定相同的編解碼器特定值通常不是預期的行為。

-filter[:stream_specifier] filtergraph (輸出，每個串流)

建立由 filtergraph 指定的濾鏡圖 (filtergraph)，並使用它來過濾串流。

濾鏡圖表 是用於描述要套用至串流的濾鏡圖表，且必須具有單一輸入和單一輸出，且輸入和輸出的串流類型必須相同。在濾鏡圖表中，輸入會與標籤 in 關聯，而輸出會與標籤 out 關聯。有關濾鏡圖表語法的更多資訊，請參閱 ffmpeg-filters 手冊。

如果您想要建立具有多個輸入和/或輸出的濾鏡圖表，請參閱 -filter_complex 選項。

-reinit_filter[:stream_specifier] integer (input,per-stream)

此布林選項決定當輸入影格參數在串流中途變更時，饋送此串流的濾鏡圖表是否會重新初始化。此選項預設為啟用，因為大多數視訊和所有音訊濾鏡都無法處理輸入影格屬性的變動。重新初始化後，現有的濾鏡狀態會遺失，例如某些濾鏡中可用的影格計數 n 參考。重新初始化時緩衝的任何影格都會遺失。觸發重新初始化的屬性，對於視訊而言是影格解析度或像素格式；對於音訊而言是取樣格式、取樣率、聲道數或聲道配置。

-filter_threads nb_threads (global)

定義用於處理濾鏡管線的執行緒數量。每個管線將產生一個執行緒池，其中包含如此多個可用於平行處理的執行緒。預設值為可用 CPU 的數量。

-pre[:stream_specifier] preset_name (output,per-stream)

指定符合串流的預設集。

-stats (global)

以 "info" 層級日誌（請參閱 -loglevel）記錄編碼進度/統計資訊。預設為啟用，若要明確停用，您需要指定 -nostats。

-stats_period time (global)

設定更新編碼進度/統計資訊的週期。預設值為 0.5 秒。

-progress url (global)

將程式友善的進度資訊傳送到 url。

進度資訊會定期寫入，並在編碼過程結束時寫入。它由「key=value」行組成。key 僅包含字母數字字元。進度資訊序列的最後一個鍵始終為 "progress"，其值為 "continue" 或 "end"。

更新週期是使用 -stats_period 設定的。

例如，將進度資訊記錄到 stdout

ffmpeg -progress pipe:1 -i in.mkv out.mkv

-stdin

啟用標準輸入的互動。預設為啟用，除非標準輸入用作輸入。若要明確停用互動，您需要指定 -nostdin。

停用標準輸入的互動很有用，例如，如果 ffmpeg 位於背景處理程序群組中。使用 ffmpeg ... < /dev/null 可以大致達到相同的結果，但它需要 shell。

-debug_ts (global)

印出時間戳記/延遲資訊。預設為關閉。此選項主要用於測試和除錯目的，且輸出格式可能因版本而異，因此可攜式腳本不應使用它。

另請參閱選項 -fdebug ts。

-attach filename (output)

將附件新增到輸出檔案。少數格式支援此功能，例如 Matroska，用於渲染字幕的字型。附件實作為特定類型的串流，因此此選項將在檔案中新增一個新的串流。然後可以像平常一樣在此串流上使用每個串流選項。使用此選項建立的附件串流將在所有其他串流（即使用 -map 或自動映射建立的串流）之後建立。

請注意，對於 Matroska，您還必須設定 mimetype metadata 標籤

ffmpeg -i INPUT -attach DejaVuSans.ttf -metadata:s:2 mimetype=application/x-truetype-font out.mkv

（假設附件串流將是輸出檔案中的第三個）。

-dump_attachment[:stream_specifier] filename (input,per-stream)

將符合的附件串流提取到名為 filename 的檔案中。如果 filename 為空，則將使用 filename metadata 標籤的值。

例如，將第一個附件提取到名為 'out.ttf' 的檔案

ffmpeg -dump_attachment:t:0 out.ttf -i INPUT

將所有附件提取到由 filename 標籤決定的檔案

ffmpeg -dump_attachment:t "" -i INPUT

技術說明 – 附件實作為編碼解碼器額外資料，因此此選項實際上可用於從任何串流中提取額外資料，而不僅僅是附件。

5.5 視訊選項

-vframes number (output)

設定要輸出的視訊影格數量。這是 -frames:v 的過時別名，您應該改用它。

-r[:stream_specifier] fps (input/output,per-stream)

設定影格率（Hz 值、分數或縮寫）。

作為輸入選項，忽略檔案中儲存的任何時間戳記，並產生時間戳記，假設恆定影格率為 fps。這與用於某些輸入格式（例如 image2 或 v4l2）的 -framerate 選項不同（在舊版本的 FFmpeg 中曾經相同）。如有疑問，請使用 -framerate 而不是輸入選項 -r。

作為輸出選項

視訊編碼

在編碼影格之前複製或丟棄影格，以實現恆定的輸出影格率 fps。

視訊串流複製

告知 muxer fps 是串流影格率。在這種情況下，不會丟棄或複製任何資料。如果 fps 與封包時間戳記決定的實際串流影格率不符，則可能會產生無效的檔案。另請參閱 setts 位元串流濾鏡。

-fpsmax[:stream_specifier] fps (output,per-stream)

設定最大影格率（Hz 值、分數或縮寫）。

當輸出影格率自動設定且高於此值時，限制輸出影格率。在批次處理或輸入影格率被錯誤地偵測為非常高時很有用。它不能與 -r 一起設定。在串流複製期間會忽略它。

-s[:stream_specifier] size (input/output,per-stream)

設定影格大小。

作為輸入選項，這是 video_size 私有選項的快捷方式，某些解多工器會識別它，這些解多工器的影格大小要么未儲存在檔案中，要么是可配置的 – 例如原始視訊或視訊擷取器。

作為輸出選項，這會將 scale 視訊濾鏡插入到相應濾鏡圖表的末尾。請直接使用 scale 濾鏡將其插入到開頭或其他位置。

格式為「wxh」（預設 - 與來源相同）。

-aspect[:stream_specifier] aspect (output,per-stream)

設定由 aspect 指定的視訊顯示長寬比。

aspect 可以是浮點數字串，或 num:den 形式的字串，其中 num 和 den 是長寬比的分子和分母。例如 "4:3"、"16:9"、"1.3333" 和 "1.7777" 是有效的參數值。

如果與 -vcodec copy 一起使用，它將影響儲存在容器層級的長寬比，但不會影響儲存在編碼影格中的長寬比（如果存在）。

-display_rotation[:stream_specifier] rotation (input,per-stream)

設定視訊旋轉 metadata。

rotation 是一個十進制數字，指定視訊在顯示之前應逆時針旋轉的度數。

此選項會覆寫檔案中儲存的旋轉/顯示轉換 metadata（如果有的話）。當視訊正在轉碼（而不是複製）且啟用 -autorotate 時，視訊將在濾鏡階段旋轉。否則，如果 muxer 支援，metadata 將會寫入到輸出檔案中。

如果給定了 -display_hflip 和/或 -display_vflip 選項，則它們會在由此選項指定的旋轉之後套用。

-display_hflip[:stream_specifier] (input,per-stream)

設定在顯示時圖像是否應水平翻轉。

有關更多詳細資訊，請參閱 -display_rotation 選項。

-display_vflip[:stream_specifier] (input,per-stream)

設定在顯示時圖像是否應垂直翻轉。

有關更多詳細資訊，請參閱 -display_rotation 選項。

-vn (input/output)

作為輸入選項，阻止檔案的所有視訊串流被濾鏡處理或被自動選擇或映射以進行任何輸出。請參閱 -discard 選項以個別停用串流。

作為輸出選項，停用視訊錄製，即自動選擇或映射任何視訊串流。如需完全手動控制，請參閱 -map 選項。

-vcodec codec (output)

設定視訊編碼解碼器。這是 -codec:v 的別名。

-pass[:stream_specifier] n (output,per-stream)

選擇 pass 數（1 或 2）。它用於執行雙 pass 視訊編碼。視訊的統計資訊在第一 pass 中記錄到日誌檔案中（另請參閱選項 -passlogfile），在第二 pass 中，該日誌檔案用於以精確要求的位元率產生視訊。在 pass 1 中，您可以停用音訊並將輸出設定為 null，Windows 和 Unix 的範例

ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL
ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null

-passlogfile[:stream_specifier] prefix (output,per-stream)

將雙 pass 日誌檔名前綴設定為 prefix，預設檔名前綴為 “ffmpeg2pass”。完整的檔名將為 PREFIX-N.log，其中 N 是特定於輸出串流的數字

-vf filtergraph (output)

建立由 filtergraph 指定的濾鏡圖 (filtergraph)，並使用它來過濾串流。

這是 -filter:v 的別名，請參閱 -filter 選項。

-autorotate

根據檔案 metadata 自動旋轉視訊。預設為啟用，請使用 -noautorotate 停用它。

-autoscale

根據第一影格的解析度自動縮放視訊。預設為啟用，請使用 -noautoscale 停用它。當停用自動縮放功能時，濾鏡圖表的所有輸出影格可能不在相同的解析度中，並且可能不適用於某些編碼器/muxer。因此，不建議停用它，除非您真的知道自己在做什麼。停用自動縮放功能，風險自負。

5.6 進階視訊選項

-pix_fmt[:stream_specifier] format (input/output,per-stream)

設定像素格式。使用 -pix_fmts 顯示所有支援的像素格式。如果無法選取選定的像素格式，ffmpeg 將印出警告並選取編碼器支援的最佳像素格式。如果 pix_fmt 以 + 為前綴，如果無法選取要求的像素格式，ffmpeg 將以錯誤退出，並且濾鏡圖表內的自動轉換將被停用。如果 pix_fmt 是單個 +，ffmpeg 將選取與輸入（或圖表輸出）相同的像素格式，並且自動轉換將被停用。

-sws_flags flags (input/output)

設定 libswscale 函式庫的預設 flags。這些 flags 由自動插入的 scale 濾鏡和簡單濾鏡圖表中的濾鏡使用，如果在濾鏡圖表定義中未被覆寫。

有關 scaler 選項的列表，請參閱 (ffmpeg-scaler)ffmpeg-scaler 手冊。

-rc_override[:stream_specifier] override (output,per-stream)

特定間隔的速率控制覆寫，格式為以斜線分隔的 "int,int,int" 列表。前兩個值是開始和結束影格編號，最後一個值是要使用的量化器（如果為正數），或品質因數（如果為負數）。

-vstats

將視訊編碼統計資訊傾印到 vstats_HHMMSS.log。有關格式描述，請參閱 vstats 檔案格式 章節。

-vstats_file file

將視訊編碼統計資訊傾印到 file。有關格式描述，請參閱 vstats 檔案格式 章節。

-vstats_version file

指定要使用的 vstats 格式版本。預設值為 2。有關格式描述，請參閱 vstats 檔案格式 章節。

-vtag fourcc/tag (output)

強制視訊標籤/fourcc。這是 -tag:v 的別名。

-force_key_frames[:stream_specifier] time[,time...] (output,per-stream)

-force_key_frames[:stream_specifier] expr:expr (output,per-stream)

-force_key_frames[:stream_specifier] source (output,per-stream)

force_key_frames 可以接受以下形式的參數

time[,time...]

如果參數由時間戳記組成，ffmpeg 將根據編碼器時間基底將指定的時間四捨五入到最接近的輸出時間戳記，並在第一個時間戳記等於或大於計算出的時間戳記的影格處強制關鍵影格。請注意，如果編碼器時間基底太粗糙，則關鍵影格可能會被強制在時間戳記低於指定時間的影格上。預設編碼器時間基底是輸出影格率的倒數，但可以通過 -enc_time_base 另行設定。

如果其中一個時間是 "chapters[delta]"，它將擴展為檔案中所有章節的開始時間，並偏移 delta（以秒為單位表示的時間）。此選項可用於確保在章節標記或輸出檔案中的任何其他指定位置存在搜尋點。

例如，要在 5 分鐘處插入關鍵影格，加上在每個章節開始前 0.1 秒的關鍵影格

-force_key_frames 0:05:00,chapters-0.1

expr:expr

如果參數以 expr: 為前綴，則字串 expr 會被解釋為表達式，並為每個影格評估。如果評估結果為非零，則會強制關鍵影格。

expr 中的表達式可以包含以下常數

n

目前處理的影格編號，從 0 開始

n_forced

強制影格的數量

prev_forced_n

前一個強制影格的編號，當尚未強制關鍵影格時，為 NAN

prev_forced_t

前一個強制影格的時間，當尚未強制關鍵影格時，為 NAN

t

目前處理的影格的時間

例如，要每 5 秒強制一個關鍵影格，您可以指定

-force_key_frames expr:gte(t,n_forced*5)

從第 13 秒開始，強制關鍵影格在上次強制關鍵影格後的 5 秒處

-force_key_frames expr:if(isnan(prev_forced_t),gte(t,13),gte(t,prev_forced_t+5))

source

如果參數是 source，則當 ffmpeg 編碼的當前影格在其來源中被標記為關鍵影格時，ffmpeg 將強制關鍵影格。如果必須捨棄這個特定的來源影格，則強制下一個可用的影格變成關鍵影格。

請注意，強制過多的關鍵影格對於某些編碼器的前瞻演算法非常有害：使用固定 GOP 選項或類似選項會更有效率。

-apply_cropping[:stream_specifier] source (輸入，每串流)

根據檔案 metadata，在解碼後自動裁切影片。預設值為 all。

none (0)

不要套用任何裁切 metadata。

all (1)

套用編碼器和容器層級裁切。這是預設模式。

codec (2)

套用編碼器層級裁切。

container (3)

套用容器層級裁切。

-copyinkf[:stream_specifier] (輸出，每串流)

當執行串流複製時，也複製在開頭找到的非關鍵影格。

-init_hw_device type[=name][:device[,key=value...]]

初始化類型為 type 且名為 name 的新硬體裝置，使用給定的裝置參數。如果未指定名稱，則會收到預設名稱，格式為「type%d」。

device 的含義和後續引數取決於裝置類型

cuda

device 是 CUDA 裝置的編號。

以下選項被識別

primary_ctx

如果設定為 1，則使用主要裝置上下文，而不是建立新的上下文。

範例

-init_hw_device cuda:1

選擇系統上的第二個裝置。

-init_hw_device cuda:0,primary_ctx=1

選擇第一個裝置並使用主要裝置上下文。

dxva2

device 是 Direct3D 9 顯示卡的編號。

d3d11va

device 是 Direct3D 11 顯示卡的編號。如果未指定，它將嘗試使用預設的 Direct3D 11 顯示卡或第一個硬體 VendorId 由 ‘vendor_id’ 指定的 Direct3D 11 顯示卡。

範例

-init_hw_device d3d11va

在預設的 Direct3D 11 顯示卡上建立 d3d11va 裝置。

-init_hw_device d3d11va:1

在索引 1 指定的 Direct3D 11 顯示卡上建立 d3d11va 裝置。

-init_hw_device d3d11va:,vendor_id=0x8086

在硬體 VendorId 為 0x8086 的第一個 Direct3D 11 顯示卡上建立 d3d11va 裝置。

vaapi

device 可以是 X11 顯示名稱、DRM 渲染節點或 DirectX 轉接器索引。如果未指定，它將嘗試開啟預設的 X11 顯示器 ($DISPLAY)，然後開啟第一個 DRM 渲染節點 (/dev/dri/renderD128)，或 Windows 上的預設 DirectX 轉接器。

以下選項被識別

kernel_driver

當未指定 device 時，使用此選項指定與所需裝置關聯的核心驅動程式名稱。此選項僅在啟用硬體加速方法 drm 和 vaapi 時可用。

vendor_id

當未指定 device 和 kernel_driver 時，使用此選項指定與所需裝置關聯的供應商 ID。此選項僅在啟用硬體加速方法 drm 和 vaapi 且未指定 kernel_driver 時可用。

範例

-init_hw_device vaapi

在預設裝置上建立 vaapi 裝置。

-init_hw_device vaapi:/dev/dri/renderD129

在 DRM 渲染節點 /dev/dri/renderD129 上建立 vaapi 裝置。

-init_hw_device vaapi:1

在 DirectX 轉接器 1 上建立 vaapi 裝置。

-init_hw_device vaapi:,kernel_driver=i915

在與核心驅動程式 ‘i915’ 關聯的裝置上建立 vaapi 裝置。

-init_hw_device vaapi:,vendor_id=0x8086

在與供應商 ID ‘0x8086’ 關聯的裝置上建立 vaapi 裝置。

vdpau

device 是 X11 顯示名稱。如果未指定，它將嘗試開啟預設的 X11 顯示器 ($DISPLAY)。

qsv

device 在 ‘MFX_IMPL_*’ 中選擇一個值。允許的值為

auto

sw

hw

auto_any

hw_any

hw2

hw3

hw4

如果未指定，則使用 ‘auto_any’。（請注意，對於 QSV，透過建立平台適用的子裝置（‘dxva2’ 或 ‘d3d11va’ 或 ‘vaapi’），然後從該裝置衍生 QSV 裝置，可能更容易達到所需的結果。）

以下選項被識別

child_device

在 Linux 上指定 DRM 渲染節點，或在 Windows 上指定 DirectX 轉接器。

child_device_type

選擇平台適用的子裝置類型。在 Windows 上，如果在設定時指定了 --enable-libvpl，則 ‘d3d11va’ 用作預設子裝置類型；如果在設定時指定了 --enable-libmfx，則 ‘dxva2’ 用作預設子裝置類型。在 Linux 上，使用者只能使用 ‘vaapi’ 作為子裝置類型。

範例

-init_hw_device qsv:hw,child_device=/dev/dri/renderD129

在 DRM 渲染節點 /dev/dri/renderD129 上建立具有 ‘MFX_IMPL_HARDWARE’ 的 QSV 裝置。

-init_hw_device qsv:hw,child_device=1

在 DirectX 轉接器 1 上建立具有 ‘MFX_IMPL_HARDWARE’ 的 QSV 裝置。

-init_hw_device qsv:hw,child_device_type=d3d11va

選擇類型為 ‘d3d11va’ 的 GPU 子裝置，並建立具有 ‘MFX_IMPL_HARDWARE’ 的 QSV 裝置。

-init_hw_device qsv:hw,child_device_type=dxva2

選擇類型為 ‘dxva2’ 的 GPU 子裝置，並建立具有 ‘MFX_IMPL_HARDWARE’ 的 QSV 裝置。

-init_hw_device qsv:hw,child_device=1,child_device_type=d3d11va

在 DirectX 轉接器 1 上建立具有 ‘MFX_IMPL_HARDWARE’ 且子裝置類型為 ‘d3d11va’ 的 QSV 裝置。

-init_hw_device vaapi=va:/dev/dri/renderD129 -init_hw_device qsv=hw1@va

在 /dev/dri/renderD129 上建立名為 ‘va’ 的 VAAPI 裝置，然後從裝置 ‘va’ 衍生名為 ‘hw1’ 的 QSV 裝置。

opencl

device 以 平台索引.裝置索引 的形式選擇平台和裝置。

也可以使用鍵值對來篩選裝置集，以僅尋找符合特定平台或裝置字串的裝置。

可用作篩選器的字串為

platform_profile

platform_version

platform_name

platform_vendor

platform_extensions

device_name

device_vendor

driver_version

device_version

device_profile

device_extensions

device_type

索引和篩選器必須共同唯一地選擇一個裝置。

範例

-init_hw_device opencl:0.1

選擇第一個平台上的第二個裝置。

-init_hw_device opencl:,device_name=Foo9000

選擇名稱包含字串 Foo9000 的裝置。

-init_hw_device opencl:1,device_type=gpu,device_extensions=cl_khr_fp16

選擇第二個平台上支援 cl_khr_fp16 擴充功能的 GPU 裝置。

vulkan

如果 device 是整數，它會依其在系統相關的裝置列表中的索引選擇裝置。如果 device 是任何其他字串，它會選擇名稱包含該字串作為子字串的第一個裝置。

以下選項被識別

debug

如果設定為 1，則啟用驗證層（如果已安裝）。

linear_images

如果設定為 1，則 hwcontext 分配的影像將是線性的且可本地映射的。

instance_extensions

要啟用的其他實例擴充功能，以加號分隔的列表。

device_extensions

要啟用的其他裝置擴充功能，以加號分隔的列表。

範例

-init_hw_device vulkan:1

選擇系統上的第二個裝置。

-init_hw_device vulkan:RADV

選擇名稱包含字串 RADV 的第一個裝置。

-init_hw_device vulkan:0,instance_extensions=VK_KHR_wayland_surface+VK_KHR_xcb_surface

選擇第一個裝置並啟用 Wayland 和 XCB 實例擴充功能。

-init_hw_device type[=name]@source

初始化類型為 type 且名為 name 的新硬體裝置，從名為 source 的現有裝置衍生而來。

-init_hw_device list

列出此 ffmpeg 建置版本中支援的所有硬體裝置類型。

-filter_hw_device name

將名為 name 的硬體裝置傳遞給任何濾鏡圖中的所有濾鏡。這可用於設定要使用 hwupload 濾鏡上傳到的裝置，或要使用 hwmap 濾鏡映射到的裝置。其他濾鏡在需要硬體裝置時也可能會使用此參數。請注意，這通常僅在輸入還不是硬體影格時才需要 - 當輸入已經是硬體影格時，濾鏡將從它們接收作為輸入的影格的上下文中衍生出它們所需的裝置。

這是一個全域設定，因此所有濾鏡都將接收相同的裝置。

-hwaccel[:stream_specifier] hwaccel (輸入，每串流)

使用硬體加速來解碼符合的串流。 hwaccel 的允許值為

none

不使用任何硬體加速（預設值）。

auto

auto

vdpau

自動選擇硬體加速方法。

dxva2

vdpau

d3d11va

使用 VDPAU（Unix 的影片解碼和呈現 API）硬體加速。

vaapi

dxva2

qsv

使用 DXVA2（DirectX 影片加速）硬體加速。

d3d11va

使用 D3D11VA（DirectX 影片加速）硬體加速。

vaapi

使用 VAAPI（影片加速 API）硬體加速。

qsv

使用 Intel QuickSync Video 加速進行影片轉碼。

與大多數其他值不同，此選項不啟用加速解碼（當選擇 qsv 解碼器時會自動使用），而是加速轉碼，而無需將影格複製到系統記憶體中。

為了使其正常運作，解碼器和編碼器都必須支援 QSV 加速，並且不得使用任何濾鏡。

如果選定的 hwaccel 不可用或不被選擇的解碼器支援，則此選項無效。

請注意，大多數加速方法旨在用於播放，並且在現代 CPU 上不會比軟體解碼更快。此外，ffmpeg 通常需要將解碼後的影格從 GPU 記憶體複製到系統記憶體中，從而導致進一步的效能損失。因此，此選項主要用於測試。

-hwaccel_device[:stream_specifier] hwaccel_device (輸入，每串流)

選擇用於硬體加速的裝置。

僅當也指定了 -hwaccel 選項時，此選項才有意義。它可以透過名稱引用使用 -init_hw_device 建立的現有裝置，或者它可以建立一個新裝置，就像在之前立即呼叫了 ‘-init_hw_device’ type:hwaccel_device 一樣。

5.7 音訊選項

-hwaccels

列出此 ffmpeg 建置版本中啟用的所有硬體加速元件。實際的執行時間可用性取決於硬體及其安裝的合適驅動程式。

-fix_sub_duration_heartbeat[:stream_specifier]

根據隨機存取封包的接收情況，設定特定的輸出影片串流作為心跳串流，根據該串流拆分並推送目前正在進行的字幕。

這降低了結束封包或後續字幕尚未收到的字幕的延遲。作為缺點，這很可能會導致字幕事件重複以涵蓋完整持續時間，因此當處理字幕事件傳遞到輸出的延遲不相關的使用案例時，不應使用此選項。

需要為相關的輸入字幕串流設定 -fix_sub_duration 才能使其生效，並且輸入字幕串流必須直接映射到心跳串流所在的相同輸出中。

-aframes number (輸出)

設定要輸出的音訊影格數。這是 -frames:a 的過時別名，您應該改用它。

-ar[:stream_specifier] freq (輸入/輸出，每串流)

設定音訊採樣頻率。對於輸出串流，預設設定為對應輸入串流的頻率。對於輸入串流，此選項僅對音訊擷取裝置和原始解多工器有意義，並且映射到對應的解多工器選項。

-aq q (輸出)

設定音訊品質（編碼器特定的，VBR）。這是 -q:a 的別名。

-ac[:stream_specifier] channels (輸入/輸出，每串流)

設定音訊聲道數。對於輸出串流，預設設定為輸入音訊聲道數。對於輸入串流，此選項僅對音訊擷取裝置和原始解多工器有意義，並且映射到對應的解多工器選項。

-an (輸入/輸出)

作為輸入選項，阻止檔案的所有音訊串流被濾鏡處理或自動選擇或映射到任何輸出。請參閱 -discard 選項以單獨停用串流。

建立由 filtergraph 指定的濾鏡圖 (filtergraph)，並使用它來過濾串流。

作為輸出選項，停用音訊錄製，即自動選擇或映射任何音訊串流。如需完全手動控制，請參閱 -map 選項。

5.8 進階音訊選項

-acodec codec (輸入/輸出)

設定音訊編碼器。這是 -codec:a 的別名。

-sample_fmt[:stream_specifier] sample_fmt (輸出，每串流)

設定音訊採樣格式。使用 -sample_fmts 取得支援的採樣格式列表。

-af filtergraph (輸出)

這是 -filter:a 的別名，請參閱 -filter 選項。

-atag fourcc/tag (輸出)

強制音訊標籤/fourcc。這是 -tag:a 的別名。

5.9 字幕選項

-ch_layout[:stream_specifier] layout (輸入/輸出，每串流)

-channel_layout 的別名。

-channel_layout[:stream_specifier] layout (輸入/輸出，每串流)

設定音訊聲道佈局。對於輸出串流，預設設定為輸入聲道佈局。對於輸入串流，它會覆寫輸入的聲道佈局。並非所有解碼器都遵循覆寫的聲道佈局。此選項也設定音訊擷取裝置和原始解多工器的聲道佈局，並映射到對應的解多工器選項。

-guess_layout_max channels (輸入，每串流)

5.10 進階字幕選項

如果某些輸入聲道佈局未知，則僅當它對應於最多指定數量的聲道時才嘗試猜測。例如，2 告訴 ffmpeg 將 1 個聲道識別為單聲道，將 2 個聲道識別為立體聲，但不將 6 個聲道識別為 5.1 聲道。預設值是始終嘗試猜測。使用 0 停用所有猜測。使用 -channel_layout 選項明確指定輸入佈局也會停用猜測。

-scodec codec (輸入/輸出)

設定字幕編碼器。這是 -codec:s 的別名。

-sn (輸入/輸出)

設定用於渲染字幕的畫布大小。

5.11 進階選項

-map [-]input_file_id[:stream_specifier][:view_specifier][:?] | [linklabel] (輸出)

在輸出檔案中建立一個或多個串流。此選項有兩種形式來指定資料來源：第一種是從某些輸入檔案（以 -i 指定）中選擇一個或多個串流，第二種是採用來自複雜濾鏡圖（以 -filter_complex 指定）的輸出。

在第一種形式中，會為輸入檔案中索引為 input_file_id 的每個串流建立一個輸出串流。如果給定了 stream_specifier，則僅使用符合指定符的那些串流（關於 stream_specifier 語法，請參閱 串流指定符 章節）。

串流識別符前的 - 字元會建立「負向」映射。它會停用來自已建立映射的匹配串流。

在串流指定符之後，可以給定一個可選的 view_specifier，對於多視圖視訊，它指定要使用的視圖。視圖指定符可以具有以下格式之一

view:view_id

依其 ID 選擇視圖；view_id 可以設定為 'all' 以使用交錯到一個串流中的所有視圖；

vidx:view_idx

依其索引選擇視圖；即 0 是基礎視圖，1 是第一個非基礎視圖，依此類推。

vpos:position

依其顯示位置選擇視圖；position 可以是 left 或 right

轉碼的預設設定是僅使用基礎視圖，即等同於 vidx:0。對於串流複製，不支援視圖指定符，並且始終複製所有視圖。

在串流索引後面的尾隨 ? 將允許映射成為可選的：如果映射沒有匹配任何串流，則會忽略該映射，而不是失敗。請注意，如果使用了無效的輸入檔案索引，例如映射引用了不存在的輸入，則映射仍然會失敗。

另一種 [linklabel] 形式會將來自複雜濾鏡圖（請參閱 -filter_complex 選項）的輸出映射到輸出檔案。linklabel 必須對應於圖中定義的輸出連結標籤。

此選項可以指定多次，每次都會向輸出檔案新增更多串流。任何給定的輸入串流也可以多次映射為不同輸出串流的來源，例如，為了使用不同的編碼選項和/或濾鏡。串流會以在命令列上給定 -map 選項的相同順序在輸出中建立。

使用此選項會停用此輸出檔案的預設映射。

範例

映射所有內容

將第一個輸入檔案中的所有串流映射到輸出

ffmpeg -i INPUT -map 0 output

選擇特定串流

如果您的第一個輸入檔案中有兩個音訊串流，則這些串流由 0:0 和 0:1 識別。您可以使用 -map 來選擇要放置在輸出檔案中的串流。例如

ffmpeg -i INPUT -map 0:1 out.wav

將 INPUT 中的第二個輸入串流映射到 out.wav 中的（單個）輸出串流。

建立多個串流

要從輸入檔案 a.mov（由識別符 0:2 指定）中選擇索引為 2 的串流，以及從輸入 b.mov（由識別符 1:6 指定）中選擇索引為 6 的串流，並將它們複製到輸出檔案 out.mov

ffmpeg -i a.mov -i b.mov -c copy -map 0:2 -map 1:6 out.mov

建立多個串流 2

要從輸入檔案中選擇所有視訊和第三個音訊串流

ffmpeg -i INPUT -map 0:v -map 0:a:2 OUTPUT

負向映射

要映射除第二個音訊之外的所有串流，請使用負向映射

ffmpeg -i INPUT -map 0 -map -0:a:1 OUTPUT

可選映射

要映射來自第一個輸入的視訊和音訊串流，並使用尾隨 ?，如果第一個輸入中不存在音訊串流，則忽略音訊映射

ffmpeg -i INPUT -map 0:v -map 0:a? OUTPUT

依語言映射

要選取英語音訊串流

ffmpeg -i INPUT -map 0:m:language:eng OUTPUT

-ignore_unknown

忽略具有未知類型的輸入串流，而不是在嘗試複製此類串流時失敗。

-copy_unknown

允許複製具有未知類型的輸入串流，而不是在嘗試複製此類串流時失敗。

-map_metadata[:metadata_spec_out] infile[:metadata_spec_in] (輸出，每個元數據)

從 infile 設定下一個輸出檔案的元數據資訊。請注意，這些是檔案索引（從零開始），而不是檔案名稱。可選的 metadata_spec_in/out 參數指定要複製哪些元數據。元數據指定符可以具有以下形式

g

全域元數據，即適用於整個檔案的元數據

s[:stream_spec]

每個串流的元數據。stream_spec 是 串流指定符 章節中描述的串流指定符。在輸入元數據指定符中，從第一個匹配的串流複製。在輸出元數據指定符中，複製到所有匹配的串流。

c:chapter_index

每個章節的元數據。chapter_index 是從零開始的章節索引。

p:program_index

每個節目的元數據。program_index 是從零開始的節目索引。

如果省略元數據指定符，則預設為全域。

預設情況下，全域元數據從第一個輸入檔案複製，每個串流和每個章節的元數據與串流/章節一起複製。透過建立任何相關類型的映射來停用這些預設映射。可以使用負向檔案索引來建立僅停用自動複製的虛擬映射。

例如，要將輸入檔案的第一個串流的元數據複製到輸出檔案的全域元數據

ffmpeg -i in.ogg -map_metadata 0:s:0 out.mp3

要反向操作，即將全域元數據複製到所有音訊串流

ffmpeg -i in.mkv -map_metadata:s:a 0:g out.mkv

請注意，在這個範例中，簡單的 0 也會有效，因為預設情況下假定為全域元數據。

-map_chapters input_file_index (輸出)

將索引為 input_file_index 的輸入檔案中的章節複製到下一個輸出檔案。如果未指定章節映射，則從第一個具有至少一個章節的輸入檔案複製章節。使用負向檔案索引來停用任何章節複製。

-benchmark (全域)

在編碼結束時顯示基準測試資訊。顯示使用的實際時間、系統時間和使用者時間，以及最大記憶體消耗。並非所有系統都支援最大記憶體消耗，如果不支持，通常會顯示為 0。

-benchmark_all (全域)

在編碼期間顯示基準測試資訊。顯示在各個步驟（音訊/視訊編碼/解碼）中使用的實際時間、系統時間和使用者時間。

-timelimit duration (全域)

在 ffmpeg 以 CPU 使用者時間執行 duration 秒後退出。

-dump (全域)

將每個輸入封包傾印到 stderr。

-hex (全域)

傾印封包時，也傾印酬載。

-readrate speed (輸入)

限制輸入讀取速度。

其值是一個浮點正數，表示在一秒的實際時間內應攝取的最大媒體持續時間（以秒為單位）。預設值為零，表示對攝取速度沒有施加限制。值 1 表示即時速度，相當於 -re。

主要用於模擬捕獲裝置或即時輸入串流（例如，從檔案讀取時）。當輸入是實際的捕獲裝置或即時串流時，不應使用較低的值，因為這可能會導致封包遺失。

當輸出封包的流速很重要時，例如即時串流，這很有用。

-re (輸入)

以原生幀率讀取輸入。這相當於設定 -readrate 1。

-readrate_initial_burst seconds

設定初始讀取爆發時間（以秒為單位），在此之後將強制執行 -re/-readrate。

-vsync parameter (全域)

-fps_mode[:stream_specifier] parameter (輸出，每個串流)

設定視訊同步方法/幀率模式。vsync 應用於所有輸出視訊串流，但可以透過設定 fps_mode 來覆寫串流的 vsync。vsync 已被棄用，將在未來版本中移除。

出於相容性原因，vsync 的某些值可以指定為數字（在下表中以括號顯示）。

passthrough (0)

每個幀都以其時間戳記從解多工器傳遞到多工器。

cfr (1)

幀將被複製和丟棄，以精確地達到請求的恆定幀率。

vfr (2)

幀將以其時間戳記傳遞或丟棄，以防止 2 個幀具有相同的时间戳記。

auto (-1)

根據多工器的功能在 cfr 和 vfr 之間選擇。這是預設方法。

請注意，時間戳記可能會在此之後被多工器進一步修改。例如，在格式選項 avoid_negative_ts 啟用的情況下。

使用 -map，您可以選擇應從哪個串流取得時間戳記。您可以保持視訊或音訊不變，並將剩餘的串流同步到未變更的串流。

-frame_drop_threshold parameter

幀丟棄閾值，它指定視訊幀可以落後多少幀才被丟棄。以幀率單位表示，因此 1.0 是一幀。預設值為 -1.1。一個可能的用例是避免在時間戳記雜訊的情況下丟幀，或在精確時間戳記的情況下提高幀丟棄精度。

-apad parameters (輸出，每個串流)

填充輸出音訊串流。這與應用 -af apad 相同。參數是一個濾鏡參數字串，其組成方式與 apad 濾鏡相同。必須為此輸出設定 -shortest 選項才能生效。

-copyts

不要處理輸入時間戳記，而是保留它們的值，而不嘗試清理它們。特別是，不要移除初始開始時間偏移值。

請注意，根據 vsync 選項或特定的多工器處理（例如，在格式選項 avoid_negative_ts 啟用的情況下），即使選擇了此選項，輸出時間戳記也可能與輸入時間戳記不符。

-start_at_zero

與 copyts 一起使用時，將輸入時間戳記位移，使其從零開始。

這表示使用例如 -ss 50 將使輸出時間戳記從 50 秒開始，而不管輸入檔案從哪個時間戳記開始。

-copytb mode

指定在串流複製時如何設定編碼器時基。mode 是一個整數數值，可以採用以下值之一

1

使用解多工器時基。

時基從對應的輸入解多工器複製到輸出編碼器。當複製具有可變幀率的視訊串流時，有時需要這樣做以避免時間戳記非單調遞增。

0

使用解碼器時基。

時基從對應的輸入解碼器複製到輸出編碼器。

-1

嘗試自動做出選擇，以便產生合理的輸出。

預設值為 -1。

-enc_time_base[:stream_specifier] timebase (輸出，每個串流)

設定編碼器時基。timebase 可以採用以下值之一

0

根據媒體類型指定預設值。

對於視訊 - 使用 1/幀率，對於音訊 - 使用 1/取樣率。

demux

使用來自解多工器的時基。

filter

使用來自濾鏡圖的時基。

正數

使用提供的數字作為時基。

此欄位可以提供為兩個整數的比率（例如 1:24、1:48000）或十進制數字（例如 0.04166、2.0833e-5）

預設值為 0。

-bitexact (輸入/輸出)

為（解）多工器和（解/編）碼器啟用位元精確模式

-shortest (輸出)

當最短的輸出串流結束時完成編碼。

請注意，此選項可能需要緩衝幀，這會引入額外的延遲。可以使用 -shortest_buf_duration 選項來控制此延遲的最大量。

-shortest_buf_duration duration (輸出)

當至少一個串流是「稀疏的」（即在幀之間有很大的間隙 – 這通常是字幕的情況）時，-shortest 選項可能需要緩衝可能大量資料。

此選項控制緩衝幀的最大持續時間（以秒為單位）。較大的值可能允許 -shortest 選項產生更精確的結果，但會增加記憶體使用量和延遲。

預設值為 10 秒。

-dts_delta_threshold threshold

時間戳記不連續性增量閾值，表示為十進制秒數。

此選項啟用的時間戳記不連續性校正僅適用於接受時間戳記不連續性的輸入格式（為其啟用 AVFMT_TS_DISCONT 旗標），例如 MPEG-TS 和 HLS，並且在使用 -copyts 選項時會自動停用（除非檢測到換行）。

如果檢測到時間戳記不連續性，其絕對值大於 threshold，ffmpeg 將透過將目前的 DTS 和 PTS 減少/增加相應的增量值來移除不連續性。

預設值為 10。

-dts_error_threshold threshold

時間戳記錯誤增量閾值，表示為十進制秒數。

此選項啟用的時間戳記校正僅適用於不接受時間戳記不連續性的輸入格式（為其未啟用 AVFMT_TS_DISCONT 旗標）。

如果檢測到時間戳記不連續性，其絕對值大於 threshold，ffmpeg 將丟棄 PTS/DTS 時間戳記值。

預設值為 3600*30 (30 小時)，此值為任意選取且相當保守。

-muxdelay seconds (輸出)

設定最大解多工-解碼延遲。

-muxpreload seconds (輸出)

設定初始解多工-解碼延遲。

-streamid output-stream-index:new-value (輸出)

為輸出串流指定新的串流 ID 值。此選項應在套用到的輸出檔案名稱之前指定。對於存在多個輸出檔案的情況，可以將串流 ID 重新分配給不同的值。

例如，要為輸出 mpegts 檔案將串流 0 PID 設定為 33，串流 1 PID 設定為 36

ffmpeg -i inurl -streamid 0:33 -streamid 1:36 out.ts

-bsf[:stream_specifier] bitstream_filters (輸入/輸出，每串流)

將位元串流濾波器套用至符合的串流。濾波器會在從解多工器接收到每個封包時套用（當用作輸入選項時），或在將其發送到多工器之前套用（當用作輸出選項時）。

bitstream_filters 是以逗號分隔的位元串流濾波器規格列表，每個規格的形式如下

filter[=optname0=optval0:optname1=optval1:...]

任何要作為選項值一部分的「’,=:’」字元都需要使用反斜線跳脫字元。

使用 -bsfs 選項取得位元串流濾波器的清單。

例如：

ffmpeg -bsf:v h264_mp4toannexb -i h264.mp4 -c:v copy -an out.h264

將 h264_mp4toannexb 位元串流濾波器（將 MP4 封裝的 H.264 串流轉換為 Annex B）套用至輸入視訊串流。

另一方面，

ffmpeg -i file.mov -an -vn -bsf:s mov2textsub -c:s copy -f rawvideo sub.txt

將 mov2textsub 位元串流濾波器（從 MOV 字幕中提取文字）套用至輸出字幕串流。但是請注意，由於這兩個範例都使用 -c copy，因此濾波器是在輸入還是輸出時套用並不重要 - 如果發生轉碼，情況就會改變。

-tag[:stream_specifier] codec_tag (輸入/輸出，每串流)

強制符合串流的標籤/fourcc。

-timecode hh:mm:ssSEPff

指定要寫入的時間碼。SEP 對於非丟幀時間碼為「:」，對於丟幀時間碼為「;」（或「.」）。

ffmpeg -i input.mpg -timecode 01:02:03.04 -r 30000/1001 -s ntsc output.mpg

-filter_complex filtergraph (全域)

定義複雜的濾波器圖，即具有任意數量的輸入和/或輸出的濾波器圖。對於簡單的圖形（具有相同類型的一個輸入和一個輸出），請參閱 -filter 選項。filtergraph 是濾波器圖的描述，如 ffmpeg-filters 手冊的「濾波器圖語法」章節中所述。可以多次指定此選項 - 每次使用都會建立一個新的複雜濾波器圖。

複雜濾波器圖的輸入可能來自不同的來源類型，並透過對應的連結標籤格式來區分

• 要連接輸入串流，請使用 [file_index:stream_specifier]（即與 -map 相同的語法）。如果 stream_specifier 符合多個串流，則將使用第一個串流。對於多視圖視訊，串流指定符後面可以跟視圖指定符，請參閱 -map 選項的文件以了解其語法。
• 要連接迴路解碼器，請使用 [dec:dec_idx]，其中 dec_idx 是要連接到給定輸入的迴路解碼器的索引。對於多視圖視訊，解碼器索引後面可以跟視圖指定符，請參閱 -map 選項的文件以了解其語法。
• 要連接來自另一個複雜濾波器圖的輸出，請使用其連結標籤。例如，以下範例

  ffmpeg -i input.mkv \
    -filter_complex '[0:v]scale=size=hd1080,split=outputs=2[for_enc][orig_scaled]' \
    -c:v libx264 -map '[for_enc]' output.mkv \
    -dec 0:0 \
    -filter_complex '[dec:0][orig_scaled]hstack[stacked]' \
    -map '[stacked]' -c:v ffv1 comparison.mkv
  

  讀取輸入視訊並

  • （第 2 行）使用具有一個輸入和兩個輸出的複雜濾波器圖，將視訊縮放到 1920x1080，並將結果複製到兩個輸出；
  • （第 3 行）使用 libx264 編碼一個縮放後的輸出，並將結果寫入 output.mkv；
  • （第 4 行）使用迴路解碼器解碼此編碼串流；
  • （第 5 行）將迴路解碼器的輸出（即 libx264 編碼的視訊）與縮放後的原始輸入並排放置；
  • （第 6 行）然後將組合後的視訊無損編碼並寫入 comparison.mkv。

  請注意，這兩個濾波器圖無法合併為一個，因為這樣轉碼管線中會存在循環（濾波器圖輸出進入編碼，從那裡進入解碼，然後返回到同一個圖），而這種循環是不允許的。

未標記的輸入將連接到符合類型的第一個未使用的輸入串流。

輸出連結標籤透過 -map 引用。未標記的輸出會新增到第一個輸出檔案。

請注意，使用此選項可以僅使用 lavfi 來源，而無需正常的輸入檔案。

例如，將影像覆蓋在視訊上

ffmpeg -i video.mkv -i image.png -filter_complex '[0:v][1:v]overlay[out]' -map
'[out]' out.mkv

這裡 [0:v] 指的是第一個輸入檔案中的第一個視訊串流，它連結到覆蓋濾波器的第一個（主要）輸入。同樣地，第二個輸入中的第一個視訊串流連結到覆蓋的第二個（覆蓋）輸入。

假設每個輸入檔案中只有一個視訊串流，我們可以省略輸入標籤，因此以上等效於

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay[out]' -map
'[out]' out.mkv

此外，我們可以省略輸出標籤，濾波器圖的單個輸出將自動新增到輸出檔案，因此我們可以簡單地寫成

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay' out.mkv

作為一個特殊的例外，您可以使用點陣圖字幕串流作為輸入：它將轉換為與檔案中最大視訊相同大小的視訊，如果沒有視訊，則轉換為 720x576。請注意，這是一個實驗性和臨時性的解決方案。一旦 libavfilter 正式支援字幕，它將被移除。

例如，要將字幕硬編碼到儲存在 MPEG-TS 格式中的 DVB-T 錄製內容的頂部，並將字幕延遲 1 秒

ffmpeg -i input.ts -filter_complex \
  '[#0x2ef] setpts=PTS+1/TB [sub] ; [#0x2d0] [sub] overlay' \
  -sn -map '#0x2dc' output.mkv

（0x2d0、0x2dc 和 0x2ef 分別是視訊、音訊和字幕串流的 MPEG-TS PID；0:0、0:3 和 0:7 也會有效）

要使用 lavfi color 來源產生 5 秒的純紅色視訊

ffmpeg -filter_complex 'color=c=red' -t 5 out.mkv

-filter_complex_threads nb_threads (全域)

定義用於處理 filter_complex 圖的執行緒數量。與 filter_threads 類似，但僅用於 -filter_complex 圖。預設值是可用的 CPU 數量。

-lavfi filtergraph (全域)

定義複雜的濾波器圖，即具有任意數量的輸入和/或輸出的濾波器圖。等效於 -filter_complex。

-accurate_seek (輸入)

此選項啟用或停用使用 -ss 選項在輸入檔案中進行精確搜尋。預設情況下啟用，因此在轉碼時搜尋是精確的。使用 -noaccurate_seek 停用它，這可能在複製某些串流並轉碼其他串流時很有用。

-seek_timestamp (輸入)

此選項啟用或停用使用 -ss 選項在輸入檔案中按時間戳記搜尋。預設情況下停用。如果啟用，則 -ss 選項的引數會被視為實際時間戳記，並且不會被檔案的開始時間偏移。這僅對於不從時間戳記 0 開始的檔案（例如傳輸串流）才重要。

-thread_queue_size size (輸入/輸出)

對於輸入，此選項設定從檔案或裝置讀取時排隊封包的最大數量。對於低延遲/高速率即時串流，如果未及時讀取封包，則可能會丟棄封包；設定此值可以強制 ffmpeg 使用單獨的輸入執行緒並在封包到達時立即讀取封包。預設情況下，ffmpeg 僅在指定多個輸入時才執行此操作。

對於輸出，此選項指定可以排隊到每個多工執行緒的最大封包數量。

-sdp_file file (全域)

將輸出串流的 sdp 資訊列印到 file。這允許在至少一個輸出不是 rtp 串流時傾印 sdp 資訊。（需要至少一個輸出格式為 rtp）。

-discard (輸入)

允許從串流中捨棄特定的串流或影格。可以使用值 all 完全捨棄任何輸入串流，而從串流中選擇性捨棄影格發生在解多工器中，並非所有解多工器都支援。

none

不捨棄任何影格。

預設

預設值，不捨棄任何影格。

noref

捨棄所有非參考影格。

bidir

捨棄所有雙向影格。

nokey

捨棄除關鍵影格外的所有影格。

all

捨棄所有影格。

-abort_on flags (全域)

在各種條件下停止並中止。以下旗標可用

empty_output

沒有封包傳遞到多工器，輸出為空。

empty_output_stream

在某些輸出串流中，沒有封包傳遞到多工器。

-max_error_rate (全域)

設定所有輸入中解碼影格失敗的分數，當超過此分數時，ffmpeg 將傳回結束代碼 69。超過此閾值不會終止處理。範圍是介於 0 到 1 之間的浮點數。預設值為 2/3。

-xerror (全域)

在錯誤時停止並退出

-max_muxing_queue_size packets (輸出，每串流)

當轉碼音訊和/或視訊串流時，ffmpeg 將在每個串流都有一個封包之前不會開始寫入輸出。在等待這種情況發生時，其他串流的封包會被緩衝。此選項設定此緩衝區的大小，以封包為單位，用於符合的輸出串流。

此選項的預設值對於大多數用途來說應該足夠高，因此僅在確定需要時才調整此選項。

-muxing_queue_data_threshold bytes (輸出，每串流)

這是最小閾值，在此閾值之前，不會考慮多工佇列大小。預設值為每個串流 50 兆位元組，並且基於傳遞到多工器的封包的總大小。

-auto_conversion_filters (全域)

在所有濾波器圖中自動啟用插入格式轉換濾波器，包括由 -vf、-af、-filter_complex 和 -lavfi 定義的濾波器圖。如果濾波器格式協商需要轉換，則濾波器的初始化將失敗。仍然可以透過在圖形中插入相關的轉換濾波器（scale、aresample）來執行轉換。預設為啟用，要明確停用它，您需要指定 -noauto_conversion_filters。

-bits_per_raw_sample[:stream_specifier] value (輸出，每串流)

宣告給定輸出串流中每個原始樣本的位元數為 value。請注意，此選項設定提供給編碼器/多工器的資訊，它不會變更串流以符合此值。設定與串流屬性不符的值可能會導致編碼失敗或無效的輸出檔案。

-stats_enc_pre[:stream_specifier] path (輸出，每串流)

-stats_enc_post[:stream_specifier] path (輸出，每串流)

-stats_mux_pre[:stream_specifier] path (輸出，每串流)

將關於符合串流的每個影格編碼資訊寫入由 path 給定的檔案中。

-stats_enc_pre 在原始視訊或音訊影格即將發送進行編碼之前寫入關於它們的資訊，而 -stats_enc_post 則在從編碼器接收到編碼封包時寫入關於它們的資訊。-stats_mux_pre 寫入關於封包即將發送到多工器時的資訊。每個影格或封包都會在指定的檔案中產生一行。此行的格式由 -stats_enc_pre_fmt / -stats_enc_post_fmt / -stats_mux_pre_fmt 控制。

當多個串流的統計資訊寫入到單個檔案中時，對應於不同串流的行將會交錯。此交錯的精確順序未指定，並且不保證在程式的不同調用之間保持穩定，即使使用相同的選項也是如此。

-stats_enc_pre_fmt[:stream_specifier] format_spec (輸出，每串流)

-stats_enc_post_fmt[:stream_specifier] format_spec (輸出，每串流)

-stats_mux_pre_fmt[:stream_specifier] format_spec (輸出，每串流)

指定使用 -stats_enc_pre / -stats_enc_post / -stats_mux_pre 寫入的行的格式。

format_spec 是一個字串，可能包含 {fmt} 形式的指令。format_spec 是反斜線跳脫字元的 — 使用 \{、\} 和 \\ 分別將文字 {、} 或 \ 寫入輸出。

與 fmt 一起給出的指令可以是以下之一

fidx

輸出檔案的索引。

sidx

檔案中輸出串流的索引。

n

影格編號。預編碼：到目前為止發送到編碼器的影格數。後編碼：到目前為止從編碼器接收到的封包數。多工：到目前為止為此串流提交到多工器的封包數。

ni

輸入影格編號。與此輸出影格或封包對應的輸入影格（即解碼器輸出的影格）的索引。如果不可用，則為 -1。

tb

影格/封包的時間戳記所表達的時間基底，為有理數 num/den。請注意，編碼器和多工器可能使用不同的時間基底。

tbi

ptsi 的時間基底，為有理數 num/den。當 ptsi 可用時可用，否則為 0/1。

pts

影格或封包的呈現時間戳記，為整數。應乘以時間基底以計算呈現時間。

ptsi

輸入影格的呈現時間戳記（請參閱 ni），為整數。應乘以 tbi 以計算呈現時間。當不可用時，印為 (2^63 - 1 = 9223372036854775807)。

t

呈現時間

輸入影格的呈現時間（請參閱 ni），為十進制數。等於 ptsi 乘以 tbi。當不可用時，印為 inf。

ti

影格或封包的解碼時間戳記，為整數。應乘以時間基底以計算呈現時間。

dts (封包)

影格或封包的解碼時間，為十進制數。等於 dts 乘以 tb。

dt (封包)

到目前為止發送到編碼器的音訊樣本數。

sn (影格，音訊)

影格中的音訊樣本數。

samp (影格，音訊)

編碼封包的大小（以位元組為單位）。

size (封包)

目前的位元率（以位元/秒為單位）。

br (封包)

到目前為止整個串流的平均位元率，以位元/秒為單位，如果在此時無法確定，則為 -1。

abr (封包)

如果封包包含關鍵影格，則為字元 'K'，否則為字元 'N'。

key (封包)

標記為封包的指令只能與 -stats_enc_post_fmt 和 -stats_mux_pre_fmt 一起使用。

標記為影格的指令只能與 -stats_enc_pre_fmt 一起使用。

標記為音訊的指令只能與音訊串流一起使用。

預設格式字串為

前編碼

{fidx} {sidx} {n} {t}

後編碼

{fidx} {sidx} {n} {t}

未來，新的項目可能會被添加到預設格式字串的末尾。依賴格式完全不變的使用者，應手動指定格式。

請注意，寫入同一個檔案的不同串流的統計資訊可能會有不同的格式。

5.12 預設檔案

預設檔包含一連串的 option=value 配對，每行一對，用於指定一系列選項，這些選項若在命令列中指定會很麻煩。以井字號（'#'）字元開頭的行會被忽略，並用於提供註解。請查看 FFmpeg 原始碼樹狀目錄中的 presets 目錄以取得範例。

預設檔有兩種型別：ffpreset 檔和 avpreset 檔。

5.12.1 ffpreset 檔案

ffpreset 檔使用 vpre、apre、spre 和 fpre 選項指定。fpre 選項接受預設檔的檔名作為輸入，而不是預設名稱，並且可以用於任何型別的編解碼器。對於 vpre、apre 和 spre 選項，預設檔中指定的選項會應用於目前選定的相同型別編解碼器（如同預設選項的型別）。

傳遞給 vpre、apre 和 spre 預設選項的引數，會根據以下規則識別要使用的預設檔

首先，ffmpeg 會在目錄 $FFMPEG_DATADIR（如果已設定）、$HOME/.ffmpeg，以及配置時定義的資料目錄（通常是 PREFIX/share/ffmpeg）或 win32 上可執行檔旁的 ffpresets 資料夾中，依序搜尋名為 arg.ffpreset 的檔案。例如，如果引數為 libvpx-1080p，它將搜尋檔案 libvpx-1080p.ffpreset。

如果找不到此類檔案，則 ffmpeg 將在上述目錄中搜尋名為 codec_name-arg.ffpreset 的檔案，其中 codec_name 是將套用預設檔選項的編解碼器的名稱。例如，如果您使用 -vcodec libvpx 選擇視訊編解碼器，並使用 -vpre 1080p，則它將搜尋檔案 libvpx-1080p.ffpreset。

5.12.2 avpreset 檔案

avpreset 檔使用 pre 選項指定。它們的工作方式與 ffpreset 檔類似，但它們僅允許編碼器特定的選項。因此，不能使用指定編碼器的 option=value 配對。

當指定 pre 選項時，ffmpeg 將在目錄 $AVCONV_DATADIR（如果已設定）、$HOME/.avconv，以及配置時定義的資料目錄（通常是 PREFIX/share/ffmpeg）中，依序搜尋帶有 .avpreset 後綴的檔案。

首先，ffmpeg 會在上述目錄中搜尋名為 codec_name-arg.avpreset 的檔案，其中 codec_name 是將套用預設檔選項的編解碼器的名稱。例如，如果您使用 -vcodec libvpx 選擇視訊編解碼器，並使用 -pre 1080p，則它將搜尋檔案 libvpx-1080p.avpreset。

如果找不到此類檔案，則 ffmpeg 將在相同目錄中搜尋名為 arg.avpreset 的檔案。

5.13 vstats 檔案格式

-vstats 和 -vstats_file 選項啟用生成包含有關產生視訊輸出的統計資訊的檔案。

-vstats_version 選項控制生成的檔案的格式版本。

對於版本 1，格式為

frame= FRAME q= FRAME_QUALITY PSNR= PSNR f_size= FRAME_SIZE s_size= STREAM_SIZEkB time= TIMESTAMP br= BITRATEkbits/s avg_br= AVERAGE_BITRATEkbits/s

對於版本 2，格式為

out= OUT_FILE_INDEX st= OUT_FILE_STREAM_INDEX frame= FRAME_NUMBER q= FRAME_QUALITYf PSNR= PSNR f_size= FRAME_SIZE s_size= STREAM_SIZEkB time= TIMESTAMP br= BITRATEkbits/s avg_br= AVERAGE_BITRATEkbits/s

以下描述每個鍵對應的值

avg_br

平均位元率，以 Kbits/s 表示

br

位元率，以 Kbits/s 表示

frame

編碼影格數

out

輸出檔案索引

PSNR

峰值訊噪比

q

影格品質

f_size

編碼封包大小，以位元組數表示

s_size

串流大小，以 KiB 表示

st

輸出檔案串流索引

time

封包時間

type

圖片型別

另請參閱 -stats_enc 選項，以取得顯示編碼統計資訊的替代方法。

6 範例

6.1 視訊與音訊擷取

如果您指定輸入格式和裝置，則 ffmpeg 可以直接擷取視訊和音訊。

ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg

或使用 ALSA 音訊來源（單聲道輸入，卡片 ID 為 1）而不是 OSS

ffmpeg -f alsa -ac 1 -i hw:1 -f video4linux2 -i /dev/video0 /tmp/out.mpg

請注意，您必須在使用任何電視檢視器（例如 Gerd Knorr 的 xawtv）啟動 ffmpeg 之前，先啟用正確的視訊來源和頻道。您還必須使用標準混音器正確設定音訊錄製音量。

6.2 X11 擷取

透過以下方式，使用 ffmpeg 擷取 X11 顯示器

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0 /tmp/out.mpg

0.0 是您的 X11 伺服器的顯示器.螢幕編號，與 DISPLAY 環境變數相同。

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0+10,20 /tmp/out.mpg

0.0 是您的 X11 伺服器的顯示器.螢幕編號，與 DISPLAY 環境變數相同。10 是擷取的 x 偏移量，20 是 y 偏移量。

6.3 視訊與音訊檔案格式轉換

任何支援的檔案格式和協定都可以作為 ffmpeg 的輸入

範例

• 您可以使用 YUV 檔案作為輸入

  ffmpeg -i /tmp/test%d.Y /tmp/out.mpg
  

  它將使用檔案

  /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
  /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
  

  Y 檔案使用的解析度是 U 和 V 檔案的兩倍。它們是原始檔案，沒有標頭。它們可以由所有優良的視訊解碼器產生。如果 ffmpeg 無法猜測影像大小，您必須使用 -s 選項指定影像大小。

• 您可以從原始 YUV420P 檔案輸入

  ffmpeg -i /tmp/test.yuv /tmp/out.avi
  

  test.yuv 是一個包含原始 YUV 平面資料的檔案。每個影格都由 Y 平面組成，後跟垂直和水平解析度減半的 U 和 V 平面。

• 您可以輸出到原始 YUV420P 檔案

  ffmpeg -i mydivx.avi hugefile.yuv
  

• 您可以設定多個輸入檔案和輸出檔案

  ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
  

  將音訊檔案 a.wav 和原始 YUV 視訊檔案 a.yuv 轉換為 MPEG 檔案 a.mpg。

• 您也可以同時進行音訊和視訊轉換

  ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2
  

  以 22050 Hz 取樣率將 a.wav 轉換為 MPEG 音訊。

• 您可以同時編碼為多種格式，並定義從輸入串流到輸出串流的映射

  ffmpeg -i /tmp/a.wav -map 0:a -b:a 64k /tmp/a.mp2 -map 0:a -b:a 128k /tmp/b.mp2
  

  將 a.wav 轉換為 64 kbits 的 a.mp2 和 128 kbits 的 b.mp2。'-map file:index' 指定每個輸出串流使用的輸入串流，依輸出串流定義的順序排列。

• 您可以轉碼解密的 VOB

  ffmpeg -i snatch_1.vob -f avi -c:v mpeg4 -b:v 800k -g 300 -bf 2 -c:a libmp3lame -b:a 128k snatch.avi
  

  這是一個典型的 DVD 翻錄範例；輸入是 VOB 檔案，輸出是帶有 MPEG-4 視訊和 MP3 音訊的 AVI 檔案。請注意，在此命令中，我們使用 B 影格，因此 MPEG-4 串流與 DivX5 相容，並且 GOP 大小為 300，這表示對於 29.97fps 輸入視訊，每 10 秒有一個畫面內影格。此外，音訊串流是 MP3 編碼的，因此您需要透過傳遞 --enable-libmp3lame 給 configure 來啟用 LAME 支援。映射對於 DVD 轉碼以取得所需的音訊語言特別有用。

  注意：若要查看支援的輸入格式，請使用 ffmpeg -demuxers。

• 您可以從視訊中擷取影像，或從多個影像建立視訊

  對於從視訊中擷取影像

  ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
  

  這將從視訊中每秒擷取一個視訊影格，並將它們輸出到名為 foo-001.jpeg、foo-002.jpeg 等的檔案中。影像將被重新縮放以符合新的 WxH 值。

  如果您只想擷取有限數量的影格，您可以將上述命令與 -frames:v 或 -t 選項結合使用，或與 -ss 結合使用以從時間上的特定點開始擷取。

  對於從多個影像建立視訊

  ffmpeg -f image2 -framerate 12 -i foo-%03d.jpeg -s WxH foo.avi
  

  語法 foo-%03d.jpeg 指定使用由三個數字組成的十進制數字（用零填充）來表示序號。它與 C printf 函式支援的語法相同，但只有接受一般整數的格式才適用。

  當匯入影像序列時，-i 也支援在內部展開 shell 類型的萬用字元模式（globbing），方法是選擇影像 2 特定的 -pattern_type glob 選項。

  例如，對於從符合 glob 模式 foo-*.jpeg 的檔名建立視訊

  ffmpeg -f image2 -pattern_type glob -framerate 12 -i 'foo-*.jpeg' -s WxH foo.avi
  

• 您可以在輸出中放入多個相同型別的串流

  ffmpeg -i test1.avi -i test2.avi -map 1:1 -map 1:0 -map 0:1 -map 0:0 -c copy -y test12.nut
  

  產生的輸出檔案 test12.nut 將包含來自輸入檔案的前四個串流，順序相反。

• 強制 CBR 視訊輸出

  ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
  

• lmin、lmax、mblmin 和 mblmax 這四個選項使用「lambda」單位，但您可以使用 QP2LAMBDA 常數輕鬆地從「q」單位轉換

  ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
  

7 語法

本節說明 FFmpeg 程式庫和工具採用的語法和格式。

7.1 引號與跳脫字元

除非另有明確指定，否則 FFmpeg 採用以下引號和跳脫字元機制。套用以下規則

• 「'」和「\」是特殊字元（分別用於引號和跳脫字元）。除了它們之外，根據採用跳脫字元和引號的特定語法，可能還有其他特殊字元。
• 特殊字元透過在其前面加上「\」來跳脫。
• 所有用「'」括起來的字元都會按字面包含在已剖析的字串中。引號字元「'」本身無法被引號，因此您可能需要關閉引號並跳脫它。
• 除非經過跳脫或引號，否則已剖析字串的前導和尾隨空格會被移除。

請注意，當使用命令列或腳本時，您可能需要新增第二層跳脫字元，這取決於採用的 shell 語言的語法。

libavutil/avstring.h 中定義的函式 av_get_token 可用於根據上述規則剖析帶引號或跳脫字元的符記。

FFmpeg 原始碼樹狀目錄中的工具 tools/ffescape 可用於在腳本中自動引用或跳脫字串。

7.1.1 範例

• 跳脫字串 Crime d'Amour，其中包含 ' 特殊字元

  Crime d\'Amour
  

• 上面的字串包含引號，因此在引用時需要跳脫 '

  'Crime d'\''Amour'
  

• 使用引號包含前導或尾隨空格

  '  this string starts and ends with whitespaces  '
  

• 跳脫字元和引號可以混合使用

  ' The string '\'string\'' is a string '
  

• 若要包含字面上的「\」，您可以使用跳脫字元或引號

  'c:\foo' can be written as c:\\foo
  

7.2 日期

接受的語法為

[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
now

如果值為 "now"，則會採用目前時間。

時間為本地時間，除非附加 Z，在這種情況下，它會被解釋為 UTC。如果未指定年-月-日部分，則會採用目前的年-月-日。

7.3 時間長度

有兩種接受的語法用於表示持續時間。

[-][HH:]MM:SS[.m...]

HH 表示小時數，MM 表示分鐘數（最多 2 位數字），SS 表示秒數（最多 2 位數字）。結尾的 m 表示 SS 的小數值。

或

[-]S+[.m...][s|ms|us]

S 表示秒數，帶有可選的小數部分 m。可選的字面後綴「s」、「ms」或「us」分別表示將該值解釋為秒、毫秒或微秒。

在這兩種表示式中，可選的「-」表示負持續時間。

7.3.1 範例

以下範例都是有效的持續時間

「55」

55 秒

「0.2」

0.2 秒

「200ms」

200 毫秒，即 0.2 秒

「200000us」

200000 微秒，即 0.2 秒

「12:03:45」

12 小時、03 分鐘和 45 秒

「23.189」

23.189 秒

7.4 視訊尺寸

指定來源視訊的大小，它可以是 widthxheight 形式的字串，或是大小縮寫的名稱。

以下縮寫被識別

「ntsc」

720x480

「pal」

720x576

「qntsc」

352x240

「qpal」

352x288

「sntsc」

640x480

「spal」

768x576

「film」

352x240

「ntsc-film」

352x240

「sqcif」

128x96

「qcif」

176x144

「cif」

352x288

「4cif」

704x576

「16cif」

1408x1152

「qqvga」

160x120

「qvga」

320x240

「vga」

640x480

「svga」

800x600

「xga」

1024x768

「uxga」

1600x1200

「qxga」

2048x1536

「sxga」

1280x1024

「qsxga」

2560x2048

「hsxga」

5120x4096

「wvga」

852x480

「wxga」

1366x768

「wsxga」

1600x1024

「wuxga」

1920x1200

「woxga」

2560x1600

「wqsxga」

3200x2048

「wquxga」

3840x2400

「whsxga」

6400x4096

「whuxga」

7680x4800

「cga」

320x200

「ega」

640x350

「hd480」

852x480

「hd720」

1280x720

「hd1080」

1920x1080

「2k」

2048x1080

「2kflat」

1998x1080

「2kscope」

2048x858

「4k」

4096x2160

「4kflat」

3996x2160

「4kscope」

4096x1716

「nhd」

640x360

「hqvga」

240x160

「wqvga」

400x240

「fwqvga」

432x240

「hvga」

480x320

「qhd」

960x540

「2kdci」

2048x1080

「4kdci」

4096x2160

「uhd2160」

3840x2160

「uhd4320」

7680x4320

7.5 視訊速率

指定視訊的影格率，以每秒產生的影格數表示。它必須是 frame_rate_num/frame_rate_den 格式的字串、整數、浮點數或有效的視訊影格率縮寫。

以下縮寫被識別

「ntsc」

30000/1001

「pal」

25/1

「qntsc」

30000/1001

「qpal」

25/1

「sntsc」

30000/1001

「spal」

25/1

「film」

24/1

「ntsc-film」

24000/1001

7.6 比例

比率可以用運算式或 numerator:denominator 的形式表示。

請注意，具有無限大 (1/0) 或負值的比率被視為有效，因此如果您想排除這些值，則應檢查傳回的值。

未定義的值可以使用 "0:0" 字串表示。

7.7 顏色

它可以是如下定義的顏色名稱（不區分大小寫），或是 [0x|#]RRGGBB[AA] 序列，可能後跟 @ 和代表 alpha 分量的字串。

alpha 分量可以是 "0x" 後跟十六進制數字或介於 0.0 和 1.0 之間的十進制數字組成的字串，它表示不透明度值（「0x00」或「0.0」表示完全透明，「0xff」或「1.0」表示完全不透明）。如果未指定 alpha 分量，則假定為「0xff」。

字串「random」將產生隨機顏色。

以下顏色名稱被識別

「AliceBlue」

0xF0F8FF

「AntiqueWhite」

0xFAEBD7

「Aqua」

0x00FFFF

「Aquamarine」

0x7FFFD4

「Azure」

0xF0FFFF

「Beige」

0xF5F5DC

「Bisque」

0xFFE4C4

「Black」

0x000000

「BlanchedAlmond」

0xFFEBCD

「Blue」

0x0000FF

「BlueViolet」

0x8A2BE2

「Brown」

0xA52A2A

「BurlyWood」

0xDEB887

「CadetBlue」

0x5F9EA0

「Chartreuse」

0x7FFF00

「Chocolate」

0xD2691E

「Coral」

0xFF7F50

「CornflowerBlue」

0x6495ED

「Cornsilk」

0xFFF8DC

「Crimson」

0xDC143C

「Cyan」

0x00FFFF

「DarkBlue」

0x00008B

「DarkCyan」

0x008B8B

「DarkGoldenRod」

0xB8860B

「DarkGray」

0xA9A9A9

「DarkGreen」

0x006400

「DarkKhaki」

0xBDB76B

「DarkMagenta」

0x8B008B

「DarkOliveGreen」

0x556B2F

「Darkorange」

0xFF8C00

「DarkOrchid」

0x9932CC

「DarkRed」

0x8B0000

「DarkSalmon」

0xE9967A

‘深海綠’

0x8FBC8F

‘深石板藍’

0x483D8B

‘深石板灰’

0x2F4F4F

‘深土耳其玉色’

0x00CED1

‘深紫羅蘭色’

0x9400D3

‘深粉紅色’

0xFF1493

‘深天藍色’

0x00BFFF

‘暗灰色’

0x696969

‘道奇藍’

0x1E90FF

‘火磚紅’

0xB22222

‘花卉白’

0xFFFAF0

‘森林綠’

0x228B22

‘紫紅色’

0xFF00FF

‘淡灰色’

0xDCDCDC

‘幽靈白’

0xF8F8FF

‘金色’

0xFFD700

‘金麒麟色’

0xDAA520

‘灰色’

0x808080

‘綠色’

0x008000

‘黃綠色’

0xADFF2F

‘蜜瓜色’

0xF0FFF0

‘鮮粉紅色’

0xFF69B4

‘印度紅’

0xCD5C5C

‘靛藍色’

0x4B0082

‘象牙色’

0xFFFFF0

‘卡其色’

0xF0E68C

‘淡紫色’

0xE6E6FA

‘淡紫紅’

0xFFF0F5

‘草坪綠’

0x7CFC00

‘檸檬雪紡’

0xFFFACD

‘淺藍色’

0xADD8E6

‘淺珊瑚色’

0xF08080

‘淺青色’

0xE0FFFF

‘淺金麒麟黃’

0xFAFAD2

‘淺綠色’

0x90EE90

‘淺灰色’

0xD3D3D3

‘淺粉紅色’

0xFFB6C1

‘淺鮭魚色’

0xFFA07A

‘淺海綠’

0x20B2AA

‘淺天藍色’

0x87CEFA

‘淺石板灰’

0x778899

‘淺鋼青色’

0xB0C4DE

‘淺黃色’

0xFFFFE0

‘萊姆綠’

0x00FF00

‘萊姆綠’

0x32CD32

‘亞麻布色’

0xFAF0E6

‘洋紅色’

0xFF00FF

‘褐紅色’

0x800000

‘中海藍寶石綠’

0x66CDAA

‘中藍色’

0x0000CD

‘中蘭花紫’

0xBA55D3

‘中紫色’

0x9370D8

‘中海綠’

0x3CB371

‘中石板藍’

0x7B68EE

‘中春綠’

0x00FA9A

‘中土耳其玉色’

0x48D1CC

‘中紫紅’

0xC71585

‘午夜藍’

0x191970

‘薄荷奶油’

0xF5FFFA

‘薄霧玫瑰’

0xFFE4E1

‘鹿皮鞋色’

0xFFE4B5

‘Navajo 白’

0xFFDEAD

‘海軍藍’

0x000080

‘古董白’

0xFDF5E6

‘橄欖綠’

0x808000

‘橄欖褐色’

0x6B8E23

‘橙色’

0xFFA500

‘橙紅色’

0xFF4500

‘蘭花紫’

0xDA70D6

‘蒼麒麟黃’

0xEEE8AA

‘蒼綠色’

0x98FB98

‘蒼土耳其玉色’

0xAFEEEE

‘蒼紫紅’

0xD87093

‘木瓜奶油’

0xFFEFD5

‘桃子泡芙’

0xFFDAB9

‘秘魯棕’

0xCD853F

‘粉紅色’

0xFFC0CB

‘李子色’

0xDDA0DD

‘粉藍色’

0xB0E0E6

‘紫色’

0x800080

‘紅色’

0xFF0000

‘玫瑰棕色’

0xBC8F8F

‘皇家藍’

0x4169E1

‘馬鞍棕色’

0x8B4513

‘鮭魚色’

0xFA8072

‘沙棕色’

0xF4A460

‘海綠色’

0x2E8B57

‘海貝殼白’

0xFFF5EE

‘黃土赭色’

0xA0522D

‘銀色’

0xC0C0C0

‘天藍色’

0x87CEEB

‘石板藍’

0x6A5ACD

‘石板灰’

0x708090

‘雪白色’

0xFFFAFA

‘春綠色’

0x00FF7F

‘鋼青色’

0x4682B4

‘棕褐色’

0xD2B48C

‘青鴨色’

0x008080

‘薊色’

0xD8BFD8

‘番茄紅’

0xFF6347

‘土耳其玉色’

0x40E0D0

‘紫羅蘭色’

0xEE82EE

‘小麥色’

0xF5DEB3

‘白色’

0xFFFFFF

‘白煙色’

0xF5F5F5

‘黃色’

0xFFFF00

‘黃綠色’

0x9ACD32