チャプターとタグについては、一部の要素のみが許可されます。仕様で許可されていない要素は、 mkvmerge(1) によって自動的に削除されます。

デフォルトの言語コードは「und」（undetermined：未指定）です。

詳細は、後述の 「セグメント情報 XML ファイル」セクションを参照してください。

SID が「=」で始まる場合、それ以降の文字列は Matroska ファイルの名前として解釈され、そのファイルから読み取られたセグメント UID が使用されます。

作成される各ファイルには 1 つのセグメントが含まれ、各セグメントには 1 つのセグメント UID が割り当てられます。作成されるセグメントの数よりも多くのセグメント UID が指定された場合、余分な UID は無視されます。指定された UID が作成されるセグメント数より少ない場合は、不足分に対してランダムな UID が生成されます。

このオプションは、単純なチャプターファイルだけでなく、チャプターは含まれているが言語情報が欠落しているソースファイル（MP4 や OGM ファイルなど）に対しても使用できます。

ここで設定した言語は、 --generate-chapters オプション でチャプターを自動生成する場合にも適用されます。

この切替は楽章が特定のコンテナ種別（例: Ogg・OGMやMP4ファイル）から複製する際にも適用されます。詳細については後述の楽章についての節をご覧ください。

o/p： タイムスタンプを o/p 倍に調整し、線形ドリフトを補正します。 p を省略した場合、デフォルト値は 1 です。 o と p にはどちらも浮動小数点数を指定可能です。

デフォルト設定： 手動同期補正なし（d = 0 かつ o/p = 1.0 と同等）。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

新規楽章の名前は--generate-chapters-name-templateオプションで制御します。言語は--chapter-languageで設定し，--generate-chaptersの後ろでなければなりません。

雛形では幾つかの変数が使用でき，それらは楽章が生成する際に実際の値に置き換わります。文字列 '<NUM>' は楽章番号に置き換わります。文字列 '<START>' は楽章の開始時刻印に置き換わります。

The strings '<FILE_NAME>' and '<FILE_NAME_WITH_EXT>' are only filled when generating chapters for appended files. They will be replaced by the appended file's name without respectively with its extension. Note that only the file's base name and extension are inserted, not its directory or drive components.

楽章を設定する場所の最小値を「<NUM;場所>」という形式で指定できます（例: <NUM:3>）。指定した数より場所が少ない場合は，番号をゼロ埋めして出力します。

<START:形式>によって開始する時刻表示の書式を制御できます。なにも指定されていない場合の既定の書式は「%H:%M:%S」です。有効な書式指定子は以下の通りです:

The string '<TITLE>' is only filled when generating chapters for appended files. It'll be replaced by the appended file's title if one is present.

このオプションが指定されない場合、デフォルトの書式は「%p - %t」（演奏者、スペース、ダッシュ、スペース、タイトル）となります。

書式を指定した場合、以下のメタ文字以外の文字はそのままコピーされ、メタ文字は次のように置換されます：

このオプションが指定されない場合、トラックはまず「種類」、次に「ソースファイルの順序」でソートされます。具体的にはビデオトラックが最初で、次にオーディオ、字幕と続き、その他のあまり使用されない種類のトラックが最後になります。

単位が指定されない場合、 mkvmerge(1) は各クラスターに最大 n 個のデータブロックを格納します。ブロック数の最大値は 65535 です。

数値に「ms」が付加されている場合、 mkvmerge(1) は各クラスターに最大 d ミリ秒分のデータを格納します。指定可能な最小値は 「100ms」、最大値は 「32000ms」です。

mkvmerge(1) のデフォルト設定では、 1 つのクラスターに最大 65535 個のデータブロック、または 5000 ミリ秒分のデータを格納します。

特定のフレームを探索するプログラムは、まずクラスターを直接シークし、その後にクラスター全体を読み込む必要があります。そのため、クラスターのサイズを大きくしすぎると、シークが不正確になったり低速になったりする可能性があります。

通常、 mkvmerge(1) は 1000000 を使用します。これはタイムスタンプと期間が 1 ミリ秒（1ms）の精度を持つことを意味します。ビデオトラックを含まず、少なくとも 1 つのオーディオトラックを含むファイルの場合、 mkvmerge(1) はすべてのタイムスタンプと期間が 1 オーディオサンプル単位の精度になるよう、スケーリング係数を自動的に選択します。これによりオーバーヘッドは増加しますが、より正確なシークや抽出が可能になります。

特殊値 -1 を使用すると、ビデオトラックが存在する場合でも、サンプル単位の精度が適用されます。

このオプションを有効にすると、 mkvmerge(1) はこれらのタグの書き込みを行わず、同名の既存タグも変更しません。

標準形式（canonical）では、より好ましい値が存在するすべてのサブタグがその値に置換されます。例えば、「zh-yue-jyutping」は「yue-jyutping」に、「fr-FX」は「fr-FR」に変換されます。

拡張言語サブタグ形式では、まず標準形式が作成されます。その後、拡張言語サブタグが存在するすべての主要言語が、その拡張言語サブタグと接頭辞の組み合わせに置換されます。これにより、例えば「yue-jyutping」は「zh-yue-jyutping」に戻されますが、「fr-FR」には影響しません（「fr」は拡張言語サブタグではないため）。

現在、 mkvmerge(1) は以下のモードをサポートしています：

この分割モードでは、出力ファイル名は通常の操作とは異なる扱いを受けます。このモードでは出力ファイル名はprintfのように'%d'というパターンを含むことができます。'%02d'のように幅指定を追加することもできます。出力ファイル名がこのパターンを含む場合、ファイル番号が適切な形式で指定された位置に挿入されます。含まない場合、'-%03d'というパターンがファイルの拡張子の直前に指定されたものとみなされ、例えば'-o output.mkv'を指定した場合、'output-001.mkv'等のファイル名に出力されます。拡張子が存在しない場合、'-%03d'はファイル名の末尾に追加されます。

もう一つの指定可能なパターンは「%c」で、これはファイル内の最初のチャプター名に置換されます。なお、「%c」が含まれる場合、デフォルトの「-%03d」パターンは自動付加されません。

SID が「=」で始まる場合、それ以降の文字列は Matroska ファイルの名前として解釈され、そのファイルから読み取られたセグメント UID が使用されます。

SID が「=」で始まる場合、それ以降の文字列は Matroska ファイルの名前として解釈され、そのファイルから読み取られたセグメント UID が使用されます。

mkvmergeが二つめのファイル(以後'file2'と呼ぶ)のトラック(以後'track2_1'と呼ぶ)を、一つめのファイル(以後'file1'と呼ぶ)のトラック(以後'track1_1'と呼ぶ)と結合する際、'track2_1'の時刻印は一定量だけずらす必要があります。'file'モードでは、ずらす量は'file1'の中の'track1_1'以外のトラックを含む全てのトラックの中で一番大きい時刻印の値になります。'track'モードでは、'track1_1'の中で一番大きい時刻印の値になります。

残念ながら mkvmerge は、どちらのモードが適切かを確実には判断できません。そのため、既定値は 'file' モードになっています。'file' モードは、個別に作成されたファイル（AVI や MP4 など）を結合する際に適しています。一方 'track' モードは、元々 1 つの大きなファイルの一部であったソース（VOB や EVO など）に対してより効果的に機能する場合があります。

字幕トラックについては、実際に 'track' モードが有効であっても、常に 'file' モードとして処理されます。

このオプションが指定されない場合、標準のマッピングが使用されます。この場合、前のファイルのトラックに、現在のファイルのトラックIDが同じであるトラックが追加されます。これにより、動画が二つのファイルに分割されており、かつ同じトラック数とトラックIDを持つ場合、mkvmerge -o output.mkv part1.mkv +part2.mkvのようにして簡単に結合することができます。

これはファイル名の間に「+」を記述するのと同等の構文です。したがって、以下の 2 つのコマンドは等価です:

$ mkvmerge -o full.mkv file1.mkv + file2.mkv
$ mkvmerge -o full.mkv '[' file1.mkv file2.mkv ']'

'=' は次のファイル名の直前に置くことも可能です。したがって、次の 2 つのコマンドは等価になります:

$ mkvmerge -o full.mkv = file1.vob
$ mkvmerge -o full.mkv =file1.vob

これは、DVD の VOB ファイルや MPEG トランスポートストリーム等に対して使用できます。AVI や MP4 のように、各ファイルが独自のヘッダーセットを持つ「スタンドアローン」形式のファイルには使用できません。

ファイル名を括弧で囲むと、オプション = で説明した「同じベース名を持つ連番ファイルの自動検索」を無効にする効果もあります。したがって、以下の 2 つのコマンドラインは等価です:

$ mkvmerge -o out.mkv = file.mkv
$ mkvmerge -o out.mkv '(' file.mkv ')'

いくつか注意事項があります：

添付ファイルに対して MIME タイプが指定されない場合、そのタイプは自動的に判別されます。

mkvextract(1) を使用して、Matroska ファイルから添付ファイルを抽出することができます。

これは、MIME タイプが自動判別される新規の添付ファイルと、保存済みの MIME タイプがレガシーなものに再マッピングされる既存の添付ファイルの両方に影響します。

影響を受ける MIME タイプは、'font/sfnt'、'font/ttf'、'font/collection'（これらはすべて 'application/x-truetype-fonts' にマッピング）および 'font/otf'（'application/vnd.ms-opentype' にマッピング）です。

トラック ID の代わりに、ISO 639-2 言語コードを指定することも可能です。ただし、これはトラックに言語タグが含まれているソースファイルでのみ機能します。

デフォルト：この種類のすべてのトラックをコピーします。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての該当種類のトラックをコピーします。

トラック ID の代わりに、ISO 639-2 言語コードを指定することも可能です。ただし、これはトラックに言語タグが含まれているソースファイルでのみ機能します。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての該当種類のトラックをコピーします。

トラック ID の代わりに、ISO 639-2 言語コードを指定することも可能です。ただし、これはトラックに言語タグが含まれているソースファイルでのみ機能します。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての該当種類のトラックをコピーします。

トラック ID の代わりに、ISO 639-2 言語コードを指定することも可能です。ただし、これはトラックに言語タグが含まれているソースファイルでのみ機能します。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての該当種類のトラックをコピーします。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての要素をコピーします。

デフォルトでは、すべての添付ファイルがすべての出力ファイルにコピーされます。

ID の前に ! を付加すると、意味が反転します。すなわち、 ! の後にリストされた ID 以外のすべての要素をコピーします。

この挙動は、MakeMKV ソフトウェアで作成された Matroska ファイルに対しては自動的に有効になります。その理由は、MakeMKV がランダムな UID を生成する代わりに、連番（1, 2, 3...）を UID として使用するためです。

o/p： タイムスタンプを o/p 倍に調整し、線形ドリフトを補正します。 p を省略した場合、デフォルト値は 1 です。 o と p にはどちらも浮動小数点数を指定可能です。

デフォルト設定： 手動同期補正なし（d = 0 かつ o/p = 1.0 と同等）。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

The default is 'iframes' for video and subtitle tracks and 'none' for audio tracks. See also option --no-cues which inhibits the creation of cue entries regardless of the --cues options used.

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

再生中にユーザーが明示的にトラックを選択しなかった場合、プレーヤーは「デフォルトトラック」フラグが設定されているトラックの中から、ユーザーが好む言語などの設定を考慮して 1 つを選択する必要があります。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

「トラック有効」フラグが設定されているトラックのみが再生候補として考慮されるべきです。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

ソースファイルが Matroska ファイルの場合、通常は CodecID によって SBR AAC を検知できます。しかし、 CodecID が間違っている場合には、このスイッチを使用して修正することができます。

もし mkvmerge(1) が AAC ファイルを誤って SBR と認識してしまった場合、トラック ID に ':0' を付加することで指定を解除できます。

現在のところ、このオプションの影響を受けるのは DTS トラックのみです。 AC-3 コアが埋め込まれた TrueHD トラックの場合は、代わりに 2 つの独立したトラックとして表示され、ユーザーがどちらをコピーするか選択できます。 DTS の場合は、 HD 拡張部分が（ TrueHD データとは異なり）単体でデコードできないため、このような仕組みは採用されていません。

現在のところ、このオプションの影響を受けるのは AC-3 、 DTS 、 TrueHD トラックのみです。

既定のこま持続時間が強制設定されなかった場合、 mkvmerge(1) はコンテナ、または（ AVC/H.264 や MPEG-2 などの特定のトラック形式では）エンコードされたビットストリームから、そのトラックの既定のこま持続時間を取得しようと試みます。

このオプションは、外部タイムスタンプファイルを使用せずに映像トラックの FPS を変更する目的でも使用できます。

圧縮形式 'mpeg4_p2' / 'mpeg4p2' は、「ヘッダー除去 (header removal)」と呼ばれる特殊な圧縮方法で、 MPEG-4 Part 2 映像トラックに対してのみ使用可能です。

一部の字幕形式では、デフォルトで 'zlib' 圧縮が使用されます。この圧縮形式は、ほとんどすべて（もしすべてでないにしても）の再生アプリケーションがサポートしています。 'none' 以外の他の圧縮形式については、サポートが保証されていません。

これらの値を設定する別の方法として、--aspect-ratio又は--aspect-ratio-factorオプションが使用できます(下記参照)。これらのオプションは互いに排他的です。

これらの値を指定する別の方法として、 --aspect-ratio-factor または --display-dimensions オプションを使用することもできます（前述および後述）。これらのオプションは互いに排他的です。

これらの値を指定する別の方法として、 --aspect-ratio または --display-dimensions オプションを使用することもできます（前述参照）。これらのオプションは互いに排他的です。

有効な値とその意味は以下の通りです:

0: GBR, 1: BT709, 2: 指定なし, 3: 予約済み, 4: FCC, 5: BT470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: YCOCG, 9: BT2020 非定輝度, 10: BT2020 定輝度

例： 4:2:0 クロマサブサンプリングの映像の場合、パラメータは TID:1,1 に設定する必要があります。

例： 4:2:1 クロマサブサンプリングの映像の場合、 --chroma-subsample を TID:1,0 に、 Cb-subsample を TID:1,0 に設定する必要があります。

有効な値とその意味は以下の通りです:

0: 予約済み, 1: ITU-R BT.709, 2: 未指定, 3: 予約済み, 4: ガンマ 2.2 曲線, 5: ガンマ 2.8 曲線, 6: SMPTE 170M, 7: SMPTE 240M, 8: リニア, 9: ログ, 10: ログ・ルート, 11: IEC 61966-2-4, 12: ITU-R BT.1361 拡張色域, 13: IEC 61966-2-1, 14: ITU-R BT.2020 10bit, 15: ITU-R BT.2020 12bit, 16: SMPTE ST 2084, 17: SMPTE ST 428-1; 18: ARIB STD-B67 (HLG)

有効な値とその意味は以下の通りです:

0: 予約済み, 1: ITU-R BT.709, 2: 未指定, 3: 予約済み, 4: ITU-R BT.470M, 5: ITU-R BT.470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: FILM, 9: ITU-R BT.2020, 10: SMPTE ST 428-1, 22: JEDEC P22 蛍光体

0: プログレッシブ、1: インターレース (トップフィールドを先に表示、トップフィールドを先に格納)、2: フィールド順序未確定、6: インターレース (ボトムフィールドを先に表示、ボトムフィールドを先に格納)、9: インターレース (ボトムフィールドを先に表示、トップフィールドを先に格納)、14: インターレース (トップフィールドを先に表示、ボトムフィールドを先に格納)

このオプションは、1 つの入力ファイルに対して複数回使用でき、それぞれ異なるトラック ID を指定することで複数のトラックに適用できます。

結果に使用される出力形式は、--identification-format オプションで変更できます。

トラックの存在を認識しているのに見付けられなかった場合は，このオプションを用いて探測の度合いを変更することができます。最低値10MBは組み込まれており変更することはできません。

'lowest' を選択すると、プロセスの優先度が最低になるだけでなく、I/O 優先度もアイドル（idle）に設定されます。

シード値には任意の文字列を指定でき、数値である必要はありません。

バイト単位での同一性は、以下の条件下においてのみ保証されます:

異なるバージョンの mkvmerge(1) や異なるコマンドラインオプションを使用した場合でも、結果としてバイト単位で同一なファイルが生成されることがありますが、それは保証されません。

'--title' などのオプションの引数の先頭文字として @ 記号を使用したい場合は、2 つ目の @ 記号を付けてエスケープする必要があります。例:

$ mkvmerge -o midnight-s01e01.mkv --title @@midnight midnight-s01e01.mp4

$ mkvmerge -i v.mkv
File 'v.mkv': container: Matroska
Track ID 0: video (V_MS/VFW/FOURCC, DIV3)
Track ID 1: audio (A_MPEG/L3)

CHAPTER01=00:00:00.000
CHAPTER01NAME=Intro
CHAPTER02=00:02:30.000
CHAPTER02NAME=Baby prepares to rock
CHAPTER03=00:02:42.300
CHAPTER03NAME=Baby rocks the house

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Chapters SYSTEM "matroskachapters.dtd">
<Chapters>


  <EditionEntry>


    <ChapterAtom>


      <ChapterTimeStart>00:00:30.000</ChapterTimeStart>


      <ChapterTimeEnd>00:01:20.000</ChapterTimeEnd>


      <ChapterDisplay>


        <ChapterString>A short chapter</ChapterString>


        <ChapterLanguage>eng</ChapterLanguage>


      </ChapterDisplay>


      <ChapterAtom>


        <ChapterTimeStart>00:00:46.000</ChapterTimeStart>


        <ChapterTimeEnd>00:01:10.000</ChapterTimeEnd>


        <ChapterDisplay>


          <ChapterString>A part of that short chapter</ChapterString>


          <ChapterLanguage>eng</ChapterLanguage>


        </ChapterDisplay>


      </ChapterAtom>


    </ChapterAtom>


  </EditionEntry>
</Chapters>

Chapters (master)


  EditionEntry (master)


    EditionUID (unsigned integer, valid range: 1 <= value)


    EditionFlagHidden (unsigned integer, valid range: 0 <= value <= 1)


    EditionFlagDefault (unsigned integer, valid range: 0 <= value <= 1)


    EditionFlagOrdered (unsigned integer, valid range: 0 <= value <= 1)


    ChapterAtom (master)


      ChapterAtom (master)


      ChapterUID (unsigned integer, valid range: 1 <= value)


      ChapterTimeStart (unsigned integer)


      ChapterTimeEnd (unsigned integer)


      ChapterFlagHidden (unsigned integer, valid range: 0 <= value <= 1)


      ChapterFlagEnabled (unsigned integer, valid range: 0 <= value <= 1)


      ChapterSegmentUID (binary, valid range: 1 <= length in bytes)


      ChapterSegmentEditionUID (unsigned integer, valid range: 1 <= value)


      ChapterPhysicalEquiv (unsigned integer)


      ChapterTrack (master)


        ChapterTrackNumber (unsigned integer, valid range: 1 <= value)


      ChapterDisplay (master)


        ChapterString (UTF-8 string)


        ChapterLanguage (UTF-8 string)


        ChapterCountry (UTF-8 string)


      ChapterProcess (master)


        ChapterProcessCodecID (unsigned integer)


        ChapterProcessPrivate (binary)


        ChapterProcessCommand (master)


          ChapterProcessTime (unsigned integer)


          ChapterProcessData (binary)

$ mkvmerge -o file.mkv --tags 0:tags.xml file.avi

Tags (master)


  Tag (master)


    Targets (master)


      TargetTypeValue (unsigned integer)


      TargetType (UTF-8 string)


      TrackUID (unsigned integer)


      EditionUID (unsigned integer)


      ChapterUID (unsigned integer)


      AttachmentUID (unsigned integer)


    Simple (master)


      Simple (master)


      Name (UTF-8 string)


      TagLanguage (UTF-8 string)


      DefaultLanguage (unsigned integer)


      String (UTF-8 string)


      Binary (binary)

# timestamp format v1
assume 27.930
800,1000,25
1500,1700,30

# timestamp format v2
0
40
80

# timestamp format v3
assume 0.0
25.325
7.530,38.236
gap, 10.050
2.000,38.236