MKVMERGE(1)

名前¶

mkvmerge - マルチメディアストリームをMatroska(TM)ファイルに格納します。

書式¶

mkvmerge [global options] {-o out} [options1] {file1} [[options2] {file2}] [@optionsfile]

説明¶

このプログラムはいくつかのメディアファイルを入力とし、それらに格納されたストリームのうち全て、もしくは選択されたものをMatroska(TM)ファイルに書き込みます。 Matroska(TM)[1]のウェブサイトも参照してください。

重要項目

コマンドラインオプションの順番は重要です。もしあなたが初心者なら、"オプションの順番"セクションを読んで下さい。

グローバルオプション¶

-v, --verbose

より詳細な情報を表示します

-q, --quiet

ステータス情報の出力を抑制します。

-o, --output file-name

file-nameで指定したファイルに書き込みます。もし、ファイル分割が有効な場合このオプションは若干解釈が違います。詳細は--splitオプションの説明を参照してください。

-w, --webm

WebMの規格に準拠したファイルを作成します。mkvmergeは出力ファイル名の拡張子が"webm"であった場合にもこれをオンにします。このモードではいくつかの制限が実施されます。使用できるコーデックはVP8ビデオとVorbisオーディオのトラックのみです。チャプタとタグは使用することができません。DocTypeヘッダアイテムは"webm"へと変更されます。

--title title

出力ファイル全体のタイトルを指定します(例:映画のタイトルなど)。

--default-language language-code

デフォルトの言語コードを指定します。--languageオプションで指定しなかったトラックはすべてここで指定した言語コードになります。デフォルトは'und'、つまり'未定義'です。

セグメント情報の扱い (グローバルオプション)¶

--segmentinfo filename.xml

XMLファイルからセグメント情報を読み取ります。このファイルは、セグメントファミリUID、セグメントUID、前、及び、後セグメントUIDエレメントを含むことができます。MKVToolNixは、サンプルファイルとDTDを含んで配布されています。

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

--segment-uid SID1,SID2,...

使用するセグメントUIDを設定します。これはコンマで区切られた、通常のUID形式("0x"を前置する、またはしない、空白を含む、または含まない、ちょうど32桁の16進数)128ビットセグメントUIDのリストです。

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

チャプタ及びタグの扱い (グローバルオプション)¶

--chapter-language language-code

各チャプタのエントリに書き込むISO639-2言語コードを指定します。デフォルトは'eng'です。詳細はチャプタのセクションを参照してください。

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

--chapter-charset character-set

シンプルチャプタファイルをUTF-8に変換する際の文字コードを指定します。mkvmerge(1)の文字コード変換については、テキストファイルと文字コードのセクションを参照してください。

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

--cue-chapter-name-format format

mkvmerge(1)は音声ファイル向けのCUEシートからチャプタ情報を読み込むことができます。CUEシートには通常PERFORMERエントリ及びTITLEエントリが各インデックスエントリに存在します。mkvmerge(1)はこれら二つの文字列をチャプタの名前を生成するのに使用します。このフォーマットをこのオプションで指定することができます。

このオプションが指定されていない場合、デフォルトで'%p - %t'というフォーマットが使用されます。

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

•%pはそのエントリのPERFORMER文字列で置換されます。

•%tはそのエントリのTITLE文字列で置換されます。

•%nはそのエントリのトラック番号で置換されます。

•%Nは、そのエントリのトラック番号が10未満の場合0を前置して二桁にした数字で置換されます。

--chapters file-name

チャプタ情報をfile-nameで指定したファイルから読み込みます。詳細はチャプタのセクションを参照してください。

--global-tags file-name

file-nameで指定したファイルからグローバルタグを読み込みます。詳細はタグのセクションを参照してください。

出力一般のコントロール（高度なグローバルオプション）¶

--track-order FID1:TID1,FID2:TID2,...

このオプションは入力されたトラックが配置される順序を変更します。オプション引数はコンマで区切られるIDペアのリストです。各ペアは最初を0としてコマンドラインの何番目に指定したファイルであるかを示すファイルID(FID1)と、そのファイルの中の何番目のトラックかを示すトラックID(TID1)からなります。ここで指定されなかったトラックは、指定されたトラックの後に配置されます。

--cluster-length spec

クラスタごとの、データブロック個数の上限または持続時間を指定します。specパラメータには単位なしの数字nもしくは、'ms'を後ろに付けた数字dを指定することができます。

単位が指定されなかった場合、クラスタごとのデータブロックの最大個数は nに設定されます。上限は65535です。

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

デフォルトは、データクラスタ毎に65535データブロック以下、5000ms以下のデータを書き込みます。

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

--no-cues

キューデータ(AVIファイルにおけるインデックスのようなもの)を作成しません。キューデータなしでもファイルは再生できますが、シークは不正確かつ遅くなるでしょう。このオプションは、少しでもファイルサイズを小さくしようと必死なとき、またはテスト目的以外には使用しないでください。--cuesオプションは各入力ファイルごとに指定できます。

--clusters-in-meta-seek

ファイルの終端に全てのクラスタを含むメタシーク要素を作成します。Matroska(TM)ファイルレイアウトのセクションも参照してください。

--disable-lacing

全てのトラックで複数のフレームを1つのブロックにまとめません。これは特に多数のオーディオトラックがある場合に、ファイルサイズを増大させます。テスト目的でのみ使用してください。

--enable-durations

全てのブロックの長さを記録します。これはファイルサイズを増大させますが、現在のところプレーヤには何のメリットももたらしません。

--timecode-scale factor

タイムコードスケールの係数をfactorに強制設定します。この値は1000～10000000、もしくは-1に設定しなければなりません。

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

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

ファイルの分割と紐付け、追加結合、連結(グローバルオプションの続き):¶

--split specification

出力ファイルを指定したサイズ、又は時間で分割します。トラックはキーフレームの直後でしか分割できないことに注意してください。mkvmerge(1)はバッファリングを行うため、ファイルは分割すべき点の次にくるキーフレームの直前で分割されます。よって、分割点はユーザが指定した点よりも若干後ろになります。

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

1.指定サイズで分割します。

書式: --split [size:] d[k|m|g]

例: --split size:700m or --split 150000000

パラメータ dの後ろには'k'・'m'・'g'を付けて、単位がそれぞれKB・MB・GBであることを示すことができます。付けない場合はバイト単位になります。出力中のファイルがこの上限に達したら、次の新しいファイルへの出力が開始されます。

'size:'という接頭辞は、互換性のために省略できるようになっています。

2.指定時間で分割します。

書式: --split [duration:] HH:MM:SS.nnnnnnnnn|ds

例: --split duration:00:60:00.000 or --split 3600s

パラメータは HH:MM:SS.nnnnnnnnnという形式でナノ秒精度で長さを指定するか、数字 dのあとに's'と書いて秒数で長さを指定しなければなりません。HHは時間、MMは分、SSは秒数でnnnnnnnnnナノ秒を示します。時間及びナノ秒は省略できます。小数点の後ろには9桁までの数字を指定できます。指定した長さだけ出力されたら、次のファイルへの出力が開始されます。

'duration:'という接頭辞は、互換性のために省略できるようになっています。

3.指定した各タイムコードで分割します。

書式: --split timecodes: A[,B[,C...]]

例: --split timecodes:00:45:00.000,01:20:00.250,6300s

パラメータ A、B、C...は、durationで使用されるものと同じフォーマットで指定しなければなりません(上記参照)。タイムコードのリストはコンマで区切られます。入力ストリームが現在の分割点に達すると次のファイルが作成され、このリストから次の分割点が使用されます。

'timecodes:'という接頭辞は、互換性のために省略できるようになっています。

4.Keeping specific parts by specifying timecode ranges while discarding others.

Syntax: --split parts: start1-end1[,[+]start2-end2[,[+] start3-end3...]]

Examples:

1.--split parts:00:01:20-00:02:45,00:05:50-00:10:30.RE

2.--split parts:00:01:20-00:02:45,+00:05:50-00:10:30.RE

3.--split parts:-00:02:45,00:05:50-.RE

The parts mode tells mkvmerge(1) to keep certain ranges of timecodes while discarding others. The ranges to keep have to be listed after the parts: keyword and be separated by commas. A range itself consists of a start and an end timecode in the same format the other variations of --split accept (e.g. both 00:01:20 and 80s refer to the same timecode).

If a start timecode is left out then it defaults to the previous range's end timecode. If there was no previous range then it defaults to the start of the file (see example 3).

If an end timecode is left out then it defaults to the end of the source files which basically tells mkvmerge to keep the rest (see example 3).

Normally each range will be written to a new file. This can be changed so that consecutive ranges are written to the same file. For that the user has to prefix the start timecode with a +. This tells mvkmerge not to create a new file and instead append the range to the same file the previous range was written to. Timecodes will be adjusted so that there will be no gap in the output file even if there was a gap in the two ranges in the input file.

In example 1 mkvmerge will create two files. The first will contain the content starting from 00:01:20 until 00:02:45. The second file will contain the content starting from 00:05:50 until 00:10:30.

In example 2 mkvmerge will create only one file. This file will contain both the content starting from 00:01:20 until 00:02:45 and the content starting from 00:05:50 until 00:10:30.

In example 3 mkvmerge will create two files. The first will contain the content from the start of the source files until 00:02:45. The second file will contain the content starting from 00:05:50 until the end of the source files.

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

--link

分割された出力ファイルを相互に紐付けします。詳細はファイル紐付けのセクションを参照してください。

--link-to-previous segment-UID

最初の出力ファイルをsegment-UIDで指定したセグメントUIDに紐付けします。詳細はファイル紐付けのセクションを参照してください。

--link-to-next segment-UID

最後の出力ファイルをsegment-UIDで指定したセグメントUIDに紐付けします。詳細はファイル紐付けのセクションを参照してください。

--append-mode mode

ファイルを結合する際に、タイムコードがどのように計算されるかを決定します。パラメータmodeは'file'(デフォルト)、'trackの二つの値を取り得ます。

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

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

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

--append-to SFID1:STID1:DFID1:DTID1[,...]

このオプションは、どのトラックがどのトラックに追加されるのかを制御します。ファイルID、トラックID、追加するファイルID、追加するトラックIDの4つのIDで一組の指定を構成します。最初のファイルIDとトラックIDの組み合わせは、追加される対象のトラックを指定します。次のファイルIDとトラックIDは、そのトラックに追加されるトラックを指定します。

このオプションが指定されない場合、標準のマッピングが使用されます。この場合、前のファイルのトラックに、現在のファイルのトラック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

通常mkvmergeは、入力ファイルと同じディレクトリにあり、同じ基底名を持ち、通し番号だけが異なるファイル（例：'VTS_01_1.VOB', 'VTS_01_2.VOB', 'VTS_01_3.VOB' etc）を検索し、それらのファイル全てを、まるで1つの大きなファイルへと連結されているかのように扱います。この'='一文字のオプションを使うと、mkvmergeはそういった追加ファイルを検索しません。

'='は次のファイル名の直前に置くこともできます。よって、次の2つのコマンドは等価です。

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

( file1 file2 )

複数のファイル名が括弧の中に含まれている場合、それらのファイルは、各ファイルの内容によって順々に構成される1つの大きなファイルへと連結されているかのように扱われます。

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

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

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

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

1.開く括弧の後と閉じる括弧の前の両方に空白が必要です。

2.括弧内の全てのパラメータはファイル名として解釈されます。よって、この論理上のファイルに適用される全てのオプションは、開く括弧の前に記述する必要があります。

3.括弧を特殊文字として扱うシェルもあります。よって、上の例で示されているように括弧をエスケープするかクォーテーションで囲む必要があります。

添付ファイルのサポート（グローバルオプションの続き）¶

--attachment-description description

次の添付ファイルを説明するプレーンテキストを指定します。次の--attach-fileオプション又は--attach-file-onceオプションで指定した添付ファイルに適用されます。

--attachment-mime-type MIME type

次の添付ファイルのMIMEタイプを指定します。--attach-file及び--attach-file-onceオプションに適用されます。公式に認知されているMIMEタイプは例えばIANAのホームページ[2]に掲載されています。MIMEタイプは添付ファイルに必須です。

--attachment-name name

この添付ファイルの、出力ファイル内での名前を指定します。このオプションが指定されなかった場合、--attach-fileまたは--attach-file-onceで指定されたファイル名がそのまま使用されます。

--attach-file file-name, --attach-file-once file-name

Matroska(TM)ファイルの内部に添付ファイルを作成します。これらのオプションを使用するには、MIMEタイプをこれらのオプションより前に指定しなければなりません。二つのオプションの違いは、出力ファイルを分割する際に、 --attach-fileでは全ての出力ファイルに添付されますが、--attach-file-onceでは最初に作成されたファイルにしか添付されない点です。分割が使用されない場合、2つは等価です。

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

各入力ファイルに指定できるオプション¶

-a, --audio-tracks [!]n,m,...

オーディオトラックn、m...をコピーします。番号は--identifyオプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(トラックIDのセクションを参照してください)。デフォルト: 全てのオーディオトラックをコピーします。