other versions
- wheezy 5.6.0-1
- jessie 7.3.0-1
- testing 9.8.0-dmo1
- unstable 9.8.0-dmo1
- experimental 12.0.0-1
other languages
MKVEXTRACT(1) | MKVEXTRACT(1) |
名前¶
mkvextract - Matroska(TM) ファイルから、他の形式のファイルを抽出する書式¶
mkvextract
{mode} {source-filename} [options] [extraction-spec]
説明¶
共通オプション¶
以下のオプションは、全てのmodeで使用できるので、このセクションで一括して説明します。 -f, --parse-fully解析モードを'full'に設定します。デフォルトのモードでは、ソースファイルの必要な要素を見つけるのにファイル全体を解析せずにメタシーク要素を使用します。99%のケースではこれで十分ですが、メタシーク要素が含まれていなかったり壊れていたりするファイルにはこのモードを使用しなければならないかもしれません。高速スキャンが数秒しかかからないのに対して、ファイルをフルスキャンするのには数分かかることがあります。
--command-line-charset character-set
コマンドライン文字列の文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。
--output-charset character-set
出力する文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。
-r, --redirect-output file-name
全てのメッセージを、コンソールではなくfile-nameに書き出します。出力をリダイレクトすることで同じことが容易に可能ですが、このオプションが必要になることもあります。ターミナルが出力を、ファイルに書き出す前に処理してしまう場合などです。--output-charsetによって指定された文字コードは尊重されます。
--ui-language code
指定したcodeを強制的に言語コード(例:
日本語ならば'ja_JP')として使用します。しかし、環境変数
LANGやLC_MESSAGES、LC_ALLを使用したほうが好ましいでしょう。codeにlistと指定すると、指定できる言語コードの一覧を出力します。
--debug topic
特定の機能のデバッグをオンにします。このオプションは開発者にのみ有用です。
--engage feature
実験的機能をオンにします。利用可能な機能のリストは
mkvextract --engage
listで得られます。これらの機能は通常の状況で使用されることを意図されていません。
-v, --verbose
出力が冗長になり、Matroska(TM)のエレメントにとって重要なこと全てを、読み込まれるつどに表示していきます。
-h, --help
コマンド書式情報を出力して終了します。
-V, --version
バージョン情報を出力して終了します。
--check-for-updates
# source.mkv からトラックを抽出 tracks source.mkv # トラックをrawデータとして出力 --raw 1:destination.raw
トラック抽出モード¶
書式: mkvextract tracks source-filename [ options] TID1:dest-filename1 [ TID2:dest-filename2 ...] 以下のコマンドラインオプションは、トラック抽出モードでは各トラック毎に指定することができます。これらのオプションは、作用するトラック指定子(下記参照)の前に指定しなければなりません。 -c character-set直後の字幕トラックの出力文字コードを指定します。直後のトラックIDが指すのが、字幕トラックのときのみ有効です。デフォルトはUTF-8になります。
--blockadd level
このレベルまでのBlockAdditionを保持します。デフォルトでは全て保持します。このオプションは、WAVPACK4などの特定のコーデックにのみ有効です。
--cuesheet
コンテナ情報を含まない、rawデータをファイルに抽出します。--fullrawフラグとは違い、このフラグはCodecPrivate要素の内容はファイルに書き出しません。このモードは、mkvextract(1)がサポートしないものも含めて全てのCodecIDで使用できますが、出力されたファイルは使用できないかもしれません。
--fullraw
コンテナ情報を含まない、rawデータをファイルに抽出します。トラックがCodecPrivate要素のヘッダ情報を含む場合、その内容はファイルの先頭に書き出されます。このモードは、mkvextract(1)がサポートしないCodecIDにも使用できますが、出力されたファイルは使用できないかもしれません。
TID:outname
IDがTIDであるトラックがソースファイルに存在すれば、outnameに抽出します。このオプションは複数回指定できます。トラックIDは、mkvmerge(1)に--identifyを指定して実行した際の出力に表示されるものと同じです。
各出力ファイル名は一回しか使用されません。RealAudio及びRealVideoトラックは例外です。もし、異なるトラックに同じファイル名が指定された場合、それらは同一のファイルに保存されます。例:
$ mkvextract tracks input.mkv 1:output-two-tracks.rm 2:output-two-tracks.rm
タグ抽出モード¶
書式: mkvextract tags source-filename [ options] 抽出されたタグは、出力がリダイレクトされていなればコンソールに出力されます。(詳細については、出力リダイレクトについてのセクションを参照ください。)添付ファイル抽出モード¶
書式: mkvextract attachments source-filename [ options] AID1:outname1 [ AID2:outname2 ...] AID:outnameIDがAIDである添付ファイルがもしソースファイルに存在すれば抽出します。outnameが指定されない場合、Matroska(TM)に格納された添付ファイルの名前が使用されます。このオプションは複数回指定できます。添付ファイルIDは、mkvmerge(1)に--identifyオプションを指定したときに出力されるものと同じです。
チャプタ抽出モード¶
書式: mkvextract chapters source-filename [ options] -s, --simpleチャプタ情報をOGM
toolsで使用される、シンプルフォーマット(CHAPTER01=...,
CHAPTER01NAME=...)で出力します。このモードでは、一部の情報は破棄されます。デフォルトでは、チャプタはXMLフォーマットで出力されます。
抽出されたチャプタは、出力がリダイレクトされていなればコンソールに出力されます。(詳細については、出力リダイレクトについてのセクションを参照ください。)
CUEシート抽出モード¶
書式: mkvextract cuesheet source-filename [ options] 抽出されたCUEシートは、出力がリダイレクトされていなればコンソールに出力されます。(詳細については、出力リダイレクトについてのセクションを参照ください。)タイムコード抽出モード¶
書式: mkvextract timecodes_v2 source-filename [ options] TID1:dest-filename1 [ TID2:dest-filename2 ...] 抽出されたタイムコードは、出力がリダイレクトされていなればコンソールに出力されます。(詳細については、出力リダイレクトについてのセクションを参照ください。) TID:outnameIDがTIDであるトラックがソースファイルに存在すれば、タイムコードをoutnameに抽出します。このオプションは複数回指定できます。トラックIDは、mkvmerge(1)に--identifyを指定して実行した際の出力に表示されるものと同じです。
例:
$ mkvextract timecodes_v2 input.mkv 1:tc-track1.txt 2:tc-track2.txt
出力リダイレクト¶
いくつかのモードでは、 mkvextract(1)は抽出されたデータをコンソールに出力します。一般的に、このデータをファイルに書き出すには二つの方法があります。一つはシェルによって提供され、もう一つはmkvextract(1)自体によって提供されます。 シェルビルトインのリダイレクト機構は、コマンドラインに'> output-filename.ext'を追加することで使用できます。例:$ mkvextract tags source.mkv > tags.xml
$ mkvextract tags source.mkv --redirect-output tags.xml
出力ファイルフォーマット¶
出力ファイルのフォーマットの決定は、トラックの種類によって決まり、出力ファイル名の拡張子は使用されません。現在、以下の種類のトラックがサポートされています。 V_MPEG4/ISO/AVCこのCodecIDをもつ、固定FPSビデオトラックはAVIファイルに書き出されます。
V_REAL/*
これらは、生のMP3ファイル及びAC3ファイルに抽出されます。
A_PCM/INT/LIT
全てのAACファイルは、ADTSヘッダを各パケットの前に追加されたうえでAACファイルに書き出されます。ADTSヘッダは、廃止予定であるエンファシスフィールドを含みません。
A_VORBIS
Vorbis
audioはOggVorbis(TM)ファイルに書き出されます。
A_REAL/*
シンプル・テキスト字幕はSRTファイルに書き出されます。
S_TEXT/SSA, S_TEXT/ASS
タグは、XMLフォーマットに変換されます。このフォーマットはmkvmerge(1)でタグを読み込む際のフォーマットと同じです。
添付ファイル
添付ファイルはそのままの形式で出力ファイルに書き出されます。変換等の処理は全く行われません。
チャプタ
チャプタはXMLフォーマットに変換されます。このフォーマットはmkvmerge(1)がチャプタを読み込む際のフォーマットと同じです。他にも、簡略化されたOGMスタイルのフォーマットで出力することもできます。
タイムコード
タイムコードはまず整列された後に、mkvmerge(1)で読み込むことのできる
timecode v2
形式に準拠するファイルに書き出されます。他の形式(v1,
v3,
v4)への抽出はサポートされていません。
返り値¶
•
0 --
この返り値は抽出が成功したことを意味します。
•
1 --
この返り値は、一つ以上の警告が出力されましたが、抽出が続行されたことを意味します。警告は
'警告:'
という文字列を先頭につけて出力されます。出力ファイルが無事であるかどうかは、場合によります。出力ファイルを確認することを強く推奨します。
•
2 --
この返り値は、エラーが発生し、エラーメッセージを出力した後に
mkvextract(1)が処理を中断したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。
テキスト中の特殊文字をエスケープする¶
特殊文字をエスケープしなければならない、あるいはすべき場所が少しだけあります。エスケープのルールは単純です:エスケープする必要のある各文字を、バックスラッシュ(Windows上の日本語フォントでは\記号)の後ろに違う文字が1つついたものと入れ替えます。 ルール:' '(半角スペース)は'\s'に、'"'(ダブルクォーテーション)は'\2'に、':'は'\c'に、'#'は'\h'に、そして'\'それ自体は'\\'になります。環境変数¶
その内容は、あたかも--debugオプション経由で渡されたかのように扱われます。
MKVTOOLNIX_ENGAGEとその短縮形MTX_ENGAGE
その内容は、あたかも--debugオプション経由で渡されたかのように扱われます。
MKVTOOLNIX_OPTIONSとその短縮形MTX_OPTIONS
内容は空白で分割されます。得られた一部の文字列は、あたかもそれがコマンドラインオプションとして渡されたかのように扱われます。もし特殊な文字(例:空白)を渡す必要があるなら、それらをエスケープする必要があります(テキスト中の特殊文字のエスケープについてのセクションをご覧ください)。
関連項目¶
ウェブ¶
最新のバージョンは、常時 MKVToolNixのホームページ[1]から取得できます。著者¶
Bunkus Moritz[FAMILY Given] <moritz@bunkus.org>開発者
注記¶
- 1.
- MKVToolNixのホームページ
2012-05-27 | MKVToolNix 5.6.0 |