楽章および標識に対しては、要素の部分集合のみが許容されます。mkvmerge(1)は仕様が許可していない項目を全て消去します。

The default language code is 'und' for 'undetermined'.

詳細は、後述の区分情報XMLファイルについての節をご覧ください。

SIDが=で始まる場合は、読み取り使用した区分UIDを持つMatroskaファイルの名前として残りの部分を解釈します。

作成される各ファイルには一つの区分があり，各区分には一つの区分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である場合と同じです)。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラック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」です。有効な書式指定子は以下の通りです:

このオプションが指定されていない場合、既定で'%p - %t'という形式が使用されます。

形式が指定された場合、下のメタ文字以外はそのまま複製され、メタ文字は以下のように置換されます。

単位が指定されなかった場合、群団ごとのデータ区画の最大個数はnに設定されます。上限は65535です。

数字dに「ms」が後置されていた場合、mkvmerge(1)は各群団毎に最大でもdミリ秒分のデータしか格納しません。dの最小値は「100ms」、最大値は「32000ms」です。

mkvmerge(1)は既定で一つの群団に最大65535のデータ区画，5000msのデータを書き込みます。

プログラムがある齣を探索する際は，群団を直接読み出すことしかできず、その後に群団全体を読まなければなりません。そのため、群団を大きくすると、送り出しが不正確になったり、遅くなったりすることがあります。

mkvmerge(1)が通常用いる値は1000000です。これは時刻印と齣持続期間が1ミリ秒単位の精度を持つことを意味します。映像トラックを含まず、1つ以上の音声トラックを含むファイルでは、mkvmerge(1)は全ての時刻印と齣持続時間が標本音1つ分の精度を持つように時刻印の桁数係数を自動的に選択します。これによって処理負荷は増えますが、正確な送り出しと展開が可能になります。

特殊値-1を指定した場合、映像トラックが存在している場合でも標本音の精度を使用します。

Enabling this option prevents mkvmerge(1) from writing those tags and from touching any existing tags with same names.

In the canonical form all subtags for which preferred values exist are replaced by those preferred values. This converts e.g. 'zh-yue-jyutping' to 'yue-jyutping' or 'fr-FX' to 'fr-FR'.

For the extended language subtags form the canonical form is built first. Afterwards all primary languages for which an extended language subtag exists are replaced by that extended language subtag and its prefix. This converts e.g. 'yue-jyutping' back to 'zh-yue-jyutping' but has no effect on 'fr-FR' as 'fr' is not an extended language subtag.

At the moment mkvmerge(1) supports the following modes:

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

Another possible pattern is '%c' which will be replaced by the name of the first chapter in the file. Note that when '%c' is present, the pattern '-%03d' will not be added automatically.

SIDが=で始まる場合は、読み取り使用した区分UIDを持つMatroskaファイルの名前として残りの部分を解釈します。

SIDが=で始まる場合は、読み取り使用した区分UIDを持つMatroskaファイルの名前として残りの部分を解釈します。

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

残念ながら、mkvmergeはどちらのモードが適切であるか判断はできません。既定は'file'モードになっています。'file'モードは独立に作られたファイル同士を結合する際、例えばAVI又はMP4ファイルを結合する際に、通常はより上手く働きます。'track'モードは、例えばVOBやEVOファイルなどの大きなファイルの一部がソースの場合より上手く働くかもしれません。

字幕トラックは'track'モードが指定された場合でも、常に'file'が指定されたかのように処理されます。

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

This is an alternative syntax to using '+' between the file names. Therefore the following two commands are equivalent:

$ 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のようなスタンドアローンのファイルの場合ですが、各ファイルが自身の頭部を一通り含んでいる場合には使用することができません。

ファイル名を括弧で括るのは、オプション=で説明されているように同じ基底名を持つファイルをmkvmerge(1)に検索させない効果もあります。 よって、これらの2つの命令行は同値です：

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

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

If no MIME type is given a for an attachment, its type will be detected automatically.

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

This affects both new attachments if its MIME type is detected automatically and existing attachments whose stored MIME types will be remapped to the legacy ones.

The affected MIME types are 'font/sfnt', 'font/ttf' and 'font/collection' which are all mapped to 'application/x-truetype-fonts' and 'font/otf' which is mapped to 'application/vnd.ms-opentype'.

Instead of track IDs you can also provide ISO 639-2 language codes. This will only work for source files that provide language tags for their tracks.

Default: copy all tracks of this kind.

If the IDs are prefixed with ! then the meaning is reversed: copy all tracks of this kind but the ones listed after the !.

Instead of track IDs you can also provide ISO 639-2 language codes. This will only work for source files that provide language tags for their tracks.

If the IDs are prefixed with ! then the meaning is reversed: copy all tracks of this kind but the ones listed after the !.

Instead of track IDs you can also provide ISO 639-2 language codes. This will only work for source files that provide language tags for their tracks.

If the IDs are prefixed with ! then the meaning is reversed: copy all tracks of this kind but the ones listed after the !.

Instead of track IDs you can also provide ISO 639-2 language codes. This will only work for source files that provide language tags for their tracks.

If the IDs are prefixed with ! then the meaning is reversed: copy all tracks of this kind but the ones listed after the !.

もしIDに!が接頭していた場合には、意味が逆転します，すなわち，!の後に列挙されたIDを除く全てのトラック標識を複製します。

既定では、全ての添付ファイルが全ての出力ファイルに複製されます。

もしIDに!が接頭していた場合には、意味が逆転します，すなわち，!の後に列挙されたIDを除く全てのトラック標識を複製します。

o/p: 時刻印をo/pだけ調整し，線型偏流を修正します。既定ではpを省略した場合1になります。oおよびp双方に浮動点小数を指定できます。

既定: 手動同期修正なし（d = 0でありo/p = 1.0である場合と同じです)。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラック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.

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

If the user does not explicitly select a track during playback, the player should select one of the tracks that has its "default track" flag set, taking user preferences such as their preferred language into account.

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

Only tracks whose "track enabled" flag is set should be considered for playback.

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

ソースファイルがMatroskaファイルの場合、CodecIDによりSBR AACを検知できます。しかし、CodecIDが不正な場合、このスイッチで修正することができます。

もし、mkvmergeがAACファイルを間違ってSBRと認識してしまった場合、トラックIDに':0'を指定できます。

Currently only DTS tracks are affected by this option. TrueHD tracks that contain an embedded AC-3 core are instead presented as two separate tracks for which the user can select which track to copy. For DTS such a scheme would not work as the HD extensions cannot be decoded by themselves – unlike the TrueHD data.

Currently only AC-3, DTS and TrueHD tracks are affected by this option.

既定のこま持続時間が指定されなかった場合は、mkvmergeはそのトラックの既定のこま持続時間を、コンテナと、AVC/H.264やMPEG-2のような特定のトラックタイプの場合はエンコードされたビットストリームから取得しようと試みます。

このオプションは、外部時刻印ファイルを使用せずに映像トラックのFPSを変更するのにも使えます。

'mpeg4_p2'/'mpeg4p2'圧縮法は、 MPEG4 part2 映像トラックにのみ適用できる、'header removal'と呼ばれる特殊な圧縮法です。

The default for some subtitle types is 'zlib' compression. This compression method is also the one that most if not all playback applications support. Support for other compression methods other than 'none' is not assured.

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

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

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

Valid values and their meaning are:

0: GBR, 1: BT709, 2: unspecified, 3: reserved, 4: FCC, 5: BT470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: YCOCG, 9: BT2020 non-constant luminance, 10: BT2020 constant luminance

Example: For video with 4:2:0 chroma subsampling, the parameter should be set to TID:1,1.

Example: For video with 4:2:1 chroma subsampling, the parameter --chroma-subsample should be set to TID:1,0 and Cb-subsample should be set to TID:1,0.

Valid values and their meaning are:

0: reserved, 1: ITU-R BT.709, 2: unspecified, 3: reserved, 4: gamma 2.2 curve, 5: gamma 2.8 curve, 6: SMPTE 170M, 7: SMPTE 240M, 8: linear, 9: log, 10: log sqrt, 11: IEC 61966-2-4, 12: ITU-R BT.1361 extended color gamut, 13: IEC 61966-2-1, 14: ITU-R BT.2020 10 bit, 15: ITU-R BT.2020 12 bit, 16: SMPTE ST 2084, 17: SMPTE ST 428-1; 18: ARIB STD-B67 (HLG)

Valid values and their meaning are:

0: reserved, 1: ITU-R BT.709, 2: unspecified, 3: reserved, 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 phosphors

0: progressive; 1: interlaced with top field displayed first and top field stored first; 2: undetermined field order; 6: interlaced with bottom field displayed first and bottom field stored first; 9: interlaced with bottom field displayed first and top field stored first; 14: interlaced with top field displayed first and bottom field stored first

このオプションを一つの入力ファイルに対して複数回使用でき，毎回異なるトラックIDを指定することで複数のトラックを処理できます。

The output format used for the result can be changed with the option --identification-format.

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

'lowest' を選択することはまた，mkvmerge(1)のプロセス優先度に加えて入出力優先度も最低にします。

初期種は任意の文字列で，数値であってはなりません。

結果ファイルのバイト同一性が保証されるのは次述の条件下に限ります:

違う版のmkvmerge(1)や，異なる命令行オプションを使用していても結果としてファイルがバイト同一である場合があるますが，保証外です。

$ 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