mkvinfo -- Matroska(tm) ファイル内の要素に関する情報を表示します

# 1. 書式

mkvinfo オプション {ソースファイル名}

# 2. 説明

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

Option | Description
--- | ---
-a, --all | 既定ではmkvinfo(1)は最初の群団を読み取ると停止します。加えて、mkvinfo(1)は要素の出現をしばしば明示しません。このオプションを指定すると、mkvinfo(1)は冗長度に拘わらず処理を続行し、全ての要素を表示します。
-c, --checksums | 各フレームの Adler-32 チェックサムを計算して表示します。デバッグ目的でのみ有用です。
-o, --continue | 既定ではmkvinfo(1)は最初の群団を読み取ると停止します。このオプションを指定すると、mkvinfo(1)は冗長度に拘わらず処理を続行し、全ての要素を表示します。
-p, --hex-positions | 詳細レベルの設定に関わらず、すべての要素の位置を16進数で表示します。
-P, --positions | 詳細レベルの設定に関わらず、すべての要素の位置を10進数で表示します。
-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 文字セット | 出力される文字列を変換するのに用いる文字集合を設定します。既定では機構の現行地域特性で指定している文字集合になります。
-r, --redirect-output ファイル名 | 全ての通報を操作卓にではなくファイル名のファイルに書き出します。出力を転送することで同じことが簡単にできるものの、このオプションが必要な場合は存在します:ファイルに転送する前に端末が出力を再解釈してしまう場合です。--output-charsetで設定した文字集合を優先します。
--no-bom | 通常、UTF形式で作成・エンコードされたテキストファイルには、先頭にバイトオーダーマーク（BOM）が付与されます。このオプションを使用すると、BOMの書き込みを無効にします。
--ui-language コード | 用いる翻訳を指定した言語符号のものに強制します（例えば「de_DE」ならドイツ語翻訳です）。符号に「list」を指定すると利用可能な翻訳の一覧を出力します。
--abort-on-warnings | 最初の警告が出た時点でプログラムを中止するように指示します。この場合のプログラムの終了コードは1になります。
--debug トピック | 特定の機能のデバッグ出力を有効にします。このオプションは開発者向けです。
--engage 機能 | 実験的な機能を有効にします。利用可能な機能の一覧は mkvinfo --engage list で確認できます。これらの機能は通常の使用を意図したものではありません。
--gui-mode | GUIモードを有効にします。このモードでは、制御しているGUIに状況を伝えるための特殊な形式の行が出力されます。これらのメッセージは「#GUI#メッセージ」という形式に従います。メッセージの後には、「#GUI#メッセージ#キー1=値1#キー2=値2...」のようにキーと値のペアが続くことがあります。メッセージ内容やキー名は翻訳されず、常に英語で出力されます。
-v, --verbose | 詳細出力を有効にします。どのレベルでどのような情報が出力されるかについては、 詳細レベル のセクションを参照してください。
-h, --help | ヘルプを表示して終了します。
-V, --version | バージョン情報を表示して終了します。
@オプションファイル.json | 指定したファイル（オプションファイル）から追加のコマンドライン引数を読み込みます。サポートされている形式の詳細については、mkvmerge(1)のmanページにある「オプションファイル」のセクションを参照してください。

# 3. 詳細レベル（Verbosity levels）

-v オプションを使用すると、 mkvinfo(1) の詳細レベルを上げ、ファイルに関するより詳細な情報を表示できます。

レベル 0 では、検出されたトラックヘッダーとそのタイプのみを表示します。 mkvinfo(1) はヘッダーの解析が完了すると（技術的には最初のクラスターに到達すると）すぐに終了します。このレベルでは、たとえトラック情報より前に配置されていても、シークヘッド（seek head）エントリやキュー（cues）は表示されません。

レベル 1 では、ファイル全体で検出されたすべての Matroska 要素を表示しますが、シークヘッドエントリとキューエントリは除外されます。サマリーモードが有効な場合は、フレームの位置も出力されます。

この動作は --continue オプションでも指定可能です。

レベル 2 では、シークヘッドエントリ、キューエントリ、および各 Matroska 要素がファイル内のどの位置にあるかを表示します。

この動作は --all --positions オプションでも指定可能です。

At level 3 and above mkvinfo(1) will print some information that is not directly connected to a Matroska(tm) element. At all other levels it only prints information about the elements that were just found. Level 3 adds meta information to ease debugging (read: it's intended for developers only). All lines written by level 3 are enclosed in square brackets to make filtering them out easy.

# 4. テキストファイルと文字セット変換

MKVToolNixスイートの各ツールが文字セット変換、入出力エンコーディング、コマンドラインおよびコンソールのエンコーディングをどのように処理するかについての詳細は、mkvmerge(1) のmanページにある同名のセクションを参照してください。

# 5. 終了コード

mkvinfo(1) は以下の 3 つの終了コードのいずれかを返します：

- 0 -- 処理が正常に完了したことを意味します。

- 1 -- この返り値は、一つ以上の警告が出力されたが動作が続行されたことを意味します。警告は 'Warning:' という文字列を先頭にして出力されます。結果ファイルが無事かどうかは状況によります。出力ファイルを確認することを強く推奨します。

- 2 -- この返り値は、誤りが発生し、誤り通報を出力した直後にmkvinfo(1)が終了したことを示します。誤り通報の原因は命令行の間違いやファイル読み/書き誤り、壊れたファイルなど多岐に渡ります。

# 6. 環境変数

mkvinfo(1) は、システムのロケールを決定する標準的な環境変数（LANG や LC_* ファミリなど）を使用します。追加の環境変数は以下の通りです：

Option | Description
--- | ---
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG およびその短縮形 MTX_DEBUG | 指定された内容は、 --debug オプションを介して渡されたものとして処理されます。
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE およびその短縮形 MTX_ENGAGE | 指定された内容は、 --engage オプションを介して渡されたものとして処理されます。

# 7. 関連項目

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

# 8. WWW

最新バージョンは常に MKVToolNix のホームページ から入手できます。