For chapters and tags only a subset of elements are allowed. mkvmerge(1) will automatically remove all elements not allowed by the specification.

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

詳細は、下にあるセグメント情報XMLファイルのセクションを参照してください。

If SID starts with = then its rest is interpreted as the name of a Matroska file whose segment UID is read and used.

作成される各ファイルは一つのセグメントを含み、そして各セグメントは一つのセグメントUIDを持ちます。もし、作成されたセグメントよりも多数のセグメントUIDが指定された場合、余ったセグメントUIDは無視されます。また、もし指定されたセグメントUIDよりも多数のセグメントが作成された場合は、ランダムなUIDが作成されて使用されます。

このオプションはシンプルチャプタファイルを読み込んだ場合、そしてソースファイルがチャプタを含むがチャプタの言語情報を含まなかった場合(例:MP4,OGMファイル)に適用されます。

The language set with this option is also used when chapters are generated with the --generate-chapters option.

このスイッチはチャプタがOgg,OGMファイルなどのコンテナからコピーされる際にも適用されます。詳細については後述のチャプタについてのセクションを参照してください。

o/p: タイムスタンプをo/pの割合で調整し、リニアドリフトを修正します。pが省略された場合、デフォルトで1が使用されます。o及びpには小数を指定できます。

デフォルト: マニュアル同期修正は行われません(d = 0 かつo = 1.0の場合と同じです)。

このオプションは異るトラックIDを指定することで複数の入力トラックに対して使用することができます。

The names for the new chapters are controlled by the option --generate-chapters-name-template. The language is set with --chapter-language which must occur before --generate-chapters.

There are several variables that can be used in the template that are replaced by their actual values when a chapter is generated. The string '<NUM>' will be replaced by the chapter number. The string '<START>' will be replaced by the chapter's start timestamp.

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 wihtout respectively with its extension. Note that only the file's base name and extension are inserted, not its directory or drive components.

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以下のデータを書き込みます。

プログラムがあるフレームを見つけようとするときは、クラスタに直接シークして、その後クラスタ全体を読み込みます。よって、より大きなクラスタを作ると、シークが不正確かつ遅くなるかもしれません。

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

通常mkvmerge(1)は1000000を使用します。これはタイムコードとフレーム持続期間が1ミリ秒単位の精度を持つことを意味します。ビデオトラックを含まず、1つ以上のオーディオトラックを含むファイルでは、mkvmerge(1)は全てのタイムコードとフレーム持続時間がサンプリング音1つ分の精度を持つようタイムコードスケールの係数を自動的に選択します。これによってオーバーヘッドは大きくなりますが、正確なシークと展開が可能になります。

特殊な値-1が指定された場合、たとえビデオトラックが存在していてもサンプリング音の精度を使用します。

At the moment mkvmerge(1) supports four different modes.

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

If SID starts with = then its rest is interpreted as the name of a Matroska file whose segment UID is read and used.

If SID starts with = then its rest is interpreted as the name of a Matroska file whose segment UID is read and used.

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 = 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.

If tracks are known to be present but not found then the percentage to probe can be changed with this option. The minimum of 10 MB is built-in and cannot be changed.

Selecting 'lowest' also causes mkvmerge(1) to select idle I/O priority in addition to the lowest possible process priority.

$ 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