mkvinfo -- Matroska(tm)ファイルの要素についての情報を表示します。

# 1. 書式

mkvinfo options {source-filename}

# 2. 説明

このプログラムは、Matroska(tm) ファイルに格納されている全ての要素の一覧を表示します。出力は、使用されているコーデックを含む、トラックのリストのみに制限することもできます。

Option | Description
--- | ---
-c, --checksums | フレームごとにAdler-32チェックサムを計算し、表示します。デバッグのためにのみ有用です。
-s, --summary | 全てのエレメントについて表示するのではなく、mkvinfo(1)の見つけたものの簡潔なサマリを表示します。
-t, --track-info | 各トラックの統計情報を冗長モードで表示します。また、冗長レベルが0だった場合は1に設定します。
-x, --hexdump | 各フレームの最初の16バイトを16進数のダンプとして表示します。
-X, --full-hexdump | 各フレームの全てのバイトを16進数のダンプとして表示します。
-z, --size | ヘッダも含めた各要素のサイズを表示します。
--command-line-charset character-set | コマンドライン文字列の文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。
--output-charset character-set | 出力する文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。
-r, --redirect-output file-name | 全てのメッセージをコンソールではなくfile-nameで指定したファイルに書き出します。出力リダイレクトによっても同じことが簡単にできますが、このオプションが必要な場合もあります。ターミナルがファイルに書き込む前に出力を処理してしまう場合などです。--output-charsetによって指定された文字コードは尊重されます。
--ui-language code | Forces the translations for the language code to be used (e.g. 'de_DE' for the German translations). Entering 'list' as the code will cause the program to output a list of available translations.
--abort-on-warnings | Tells the program to abort after the first warning is emitted. The program's exit code will be 1.
--debug topic | 特定の機能のデバッグをオンにします。このオプションは開発者にのみ有用です。
--engage feature | 実験的機能をオンにします。利用可能な機能のリストはmkvinfo --engage listで得られます。これらの機能は通常の状況で使用されることを意図されていません。
--gui-mode | Turns on GUI mode. In this mode specially-formatted lines may be output that can tell a controlling GUI what's happening. These messages follow the format '#GUI#message'. The message may be followed by key/value pairs as in '#GUI#message#key1=value1#key2=value2…'. Neither the messages nor the keys are ever translated and always output in English.
-v, --verbose | 冗長モードになります。冗長レベルセクションに、どの冗長レベルでどの情報が出力されるかの説明があります。
-h, --help | コマンド書式情報を出力して終了します。
-V, --version | バージョン情報を出力して終了します。
@options-file.json | Reads additional command line arguments from the file options-file. For a full explanation on the supported formats for such files see the section called "Option files" in the mkvmerge(1) man page.

# 3. 冗長レベル

-vオプションにより、mkvinfo(1)の冗長レベルを上げ、入力ファイルについてのより詳しい情報を出力させることができます。

レベル0では、トラックヘッダとトラックの種類のみを出力します。mkvinfo(1)は、ヘッダを完全に解析し終るとすぐに(より技術的には、最初のクラスタを検出した直後に)終了します。このレベルでは、シークヘッドエントリ及びCUEがトラック情報の前に格納されていたとしても表示されません。

レベル1では、ファイル全体にあるシークヘッドエントリとCUE以外のMatroska(tm)エレメントを表示します。もし、サマリモードが有効の場合、フレーム位置も出力します。

レベル2では、シークヘッドエントリ、CUE、及び各Matroska(tm)エレメントのファイル内位置も表示します。

レベル3以上では、Matroska(tm)エレメントに直接関係ない情報も表示します。他のエレメントについては、見付かったものだけを表示します。レベル3はデバッグ用にメタ情報を追加します(開発者向け)。レベル3で追加された行は、全て角括弧で囲われています。

# 4. テキストファイルと文字コード変換

For an in-depth discussion about how all tools in the MKVToolNix suite handle character set conversions, input/output encoding, command line encoding and console encoding please see the identically-named section in the mkvmerge(1) man page.

# 5. 返り値

mkvinfo(1)は下の3つの返り値を返します。

- 0 -- この返り値は正常に終了したことを示します。

- 1 -- この返り値は、少なくとも一つの警告が表示されましたが、処理が続行されたことを意味します。警告は '警告:' という文字列を先頭につけて出力されます。

- 2 -- この返り値は、エラーが発生し、エラーメッセージを表示した直後にmkvinfo(1)が終了したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。

# 6. 環境変数

mkvinfo(1)はシステムのロケールを決めるデフォルトの変数（例：LANGやLC_*系）を使用します。追加の変数は以下の通りです：

Option | Description
--- | ---
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG | その内容は、あたかも--debugオプション経由で渡されたかのように扱われます。
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE | その内容は、あたかも--engageオプション経由で渡されたかのように扱われます。

# 7. 関連項目

mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)

# 8. ウェブ

最新のバージョンは、常時MKVToolNixのホームページから取得できます。