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

Table of contents

1. 書式

mkvinfo [options] {source-filename}

2. 説明

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

Option Description
-g, --gui

GUIを起動します。このオプションは、mkvinfoがGUIをサポートするようにコンパイルされていなければ無効です。

-c, --checksums

フレームごとにAdler32チェックサムを計算し、表示します。デバッグのためにのみ有用です。

-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

指定したcodeを強制的に言語コード(例: 日本語ならば'ja_JP')として使用します。しかし、環境変数LANGLC_MESSAGESLC_ALLを使用したほうが好ましいでしょう。codelistと指定すると、指定できる言語コードの一覧を出力します。

--debug topic

Turn on debugging for a specific feature. This option is only useful for developers.

--engage feature

Turn on experimental features. A list of available features can be requested with mkvinfo --engage list. These features are not meant to be used in normal situations.

-v, --verbose

冗長モードになります。冗長レベルセクションに、どの冗長レベルでどの情報が出力されるかの説明があります。

-h, --help

コマンド書式情報を出力して終了します。

-V, --version

バージョン情報を出力して終了します。

--check-for-updates

http://mkvtoolnix-releases.bunkus.org/latest-release.xmlをダウンロードすることで、新しいリリースがないかオンラインでチェックします。key=valueという書式で、4行が出力されます:どこから情報を取得したか (key version_check_url)、現在実行中のバージョン (key running_version)、最新のリリースのバージョン (key available_version) 及びそのダウンロードURL (key download_url)。

その後プログラムは、新しいリリースが入手可能ではなかった場合は終了コード0で、新しいリリースが入手可能であった場合は終了コード1で、エラーが発生した場合(例:アップデート情報を取得できなかった場合)は終了コード2で、それぞれ終了します。

このオプションは、プログラムがlibcurlのサポートつきでビルドされた場合のみ使用できます。

@options-file

options-fileで指定されたファイルから追加のコマンドラインオプションを読み込みます。行で最初の空白文字でない文字がハッシュマーク('#')である行はコメントとして扱われ、無視されます。行頭、及び行末の空白文字は取り除かれます。各行には一つずつしかオプションを指定できません。

エスケープすることのできる文字もあります。例えば、コメントではない行を'#'で始める必要のある場合です。そのルールは、エスケープ文字についてのセクションで説明されています。

'mkvinfo -v -v input.mkv --redirect-output info.txtというコマンドラインと同じことは、次のようなオプションファイルで指定できます。

# 冗長モード
-v
-v
# input.mkvを解析する
input.mkv
# info.txtに出力を書き込む
--redirect-output
info.txt     

3. 冗長レベル

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

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

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

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

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

4. 返り値

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

5. テキスト中の特殊文字をエスケープする

特殊文字をエスケープしなければならない、あるいはすべき場所が少しだけあります。エスケープのルールは単純です:エスケープする必要のある各文字を、バックスラッシュ(Windows上の日本語フォントでは\記号)の後ろに違う文字が1つついたものと入れ替えます。

ルール:' '(半角スペース)は'\s'に、'"'(ダブルクォーテーション)は'\2'に、':'は'\c'に、'#'は'\h'に、そして'\'それ自体は'\\'になります。

6. Environment variables

mkvinfo(1) uses the default variables that determine the system's locale (e.g. LANG and the LC_* family). Additional variables:

Option Description
MKVTOOLNIX_DEBUG and its short form MTX_DEBUG

The content is treated as if it had been passed via the --debug option.

MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE

The content is treated as if it had been passed via the --engage option.

MKVTOOLNIX_OPTIONS and its short form MTX_OPTIONS

The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see the section about escaping special characters in text).

7. 関連項目

mkvmerge(1), mkvextract(1), mkvpropedit(1), mmg(1)

8. ウェブ

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