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

既定言語コードは 'und' つまり「未定義」です。

詳細は、後述の区分情報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>' は楽章の開始時刻印に置き換わります。

文字列 '<FILE_NAME>' および '<FILE_NAME_WITH_EXT>' は追加ファイルに対して楽章を生成した場合にのみ置換されます。それぞれ追加したファイルの名前の拡張子を含まないもの，含むものに置き換わります。注意: ファイルの基底名と拡張子が挿入されるだけで，そのディレクトリやドライブ構成は挿入されません。

You can specify a minimum number of places for the chapter number with '<NUM:places>', e.g. '<NUM:3>'. The resulting number will be padded with leading zeroes if the number of places is less than specified.

You can control the format used by the start timestamp with <START:format>. The format defaults to '%H:%M:%S' if none is given. Valid format codes are:

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

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

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

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

既定は、データ団体毎に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.

At the moment mkvmerge(1) supports four different 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.mkv
$ mkvmerge -o full.mkv =file1.mkv

これは、例えばDVDのVOBファイルやMPEGトランスポートストリーム等のために使用することができます。通常AVIやMP4のようなスタンドアローンのファイルの場合ですが、各ファイルが自身の頭部を一通り含んでいる場合には使用することができません。

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

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

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

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

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を指定することで複数のトラックを処理できます。

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

'mono', 'side_by_side_left_first', 'top_bottom_right_first', 'top_bottom_left_first', 'checkerboard_right_first', 'checkerboard_left_first', 'row_interleaved_right_first', 'row_interleaved_left_first', 'column_interleaved_right_first', 'column_interleaved_left_first', 'anaglyph_cyan_red', 'side_by_side_right_first', 'anaglyph_green_magenta', 'both_eyes_laced_left_first', 'both_eyes_laced_right_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)

If the output is redirected with cmd.exe itself, e.g. with mkvinfo file.mkv > info.txt, then the charset is always UTF-8 and cannot be changed.

Otherwise (when writing directly to the console) the Windows function WriteConsoleW() is used and the option --output-charset is ignored. The console should be able to output all Unicode characters for which the corresponding language support is installed (e.g. Chinese characters might not be displayed on English Windows versions).

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