既知の編集可能なプロパティの名前、型(文字列、整数、真偽値等)、短い説明を一覧表示します。その後、プログラムは終了します。よって、source-filenameパラメータを指定する必要はありません。

解析モードを設定します。「mode」パラメータは「fast」（既定）と「full」のどちらかを指定できます。「fast」モードはファイル全体を解析するのではなく、高次送り出し要素を使って原ファイル内の必要な要素を探します。99%の場合これで十分です。しかし、高次送り出し要素を含まないファイルや破損したファイルに対しては「full」解析モードを指定する必要があるかもしれません。「full」走査には数分かかることがありますが、「fast」走査には数秒しかかかりません。

このオプション以降のadd、set、deleteアクションが適用されるMatroskaファイルセクション(区分情報または特定のトラックの頭部)を指定します。このオプションは、複数の要素を修正するために、複数回指定することができます。

既定では、mkvpropedit(1)は区分情報のセクションを編集します。

文法の完全な説明は、編集選択子のセクションを参照してください。

nameで指定された名前のプロパティをvalueで指定した値で追加します。プロパティは、既にその名前のプロパティが存在する場合も追加されます。ほとんどのプロパティは一意的で、複数回追加できないことに注意してください。

見付けた全ての、プロパティ名がnameであるプロパティの値を、valueに設定します。そのようなプロパティが存在しないときは、プロパティは追加されます。

見付けた全ての、プロパティ名がnameであるプロパティを削除します。いくつかのプロパティは必須で、削除できないことに注意してください。

filenameからのタグを、このファイル中のタグに追加、あるいは置換します。もしfilenameが空白なら、タグを削除します。mkvpropedit(1)は、mkvmerge(1)が読み込むのと同じXMLタグ形式を読み込みます。

selectorは、all、global、またはtrackのうちどれか一つを指定してください。allを指定すると、mkvpropedit(1)はファイル中の全てのタグを置換あるいは削除します。globalを指定すると、広域タグだけが置換あるいは削除されます。

trackを指定すると、mkvpropedit(1)は特定のトラックのタグを置換します。また、filenameから読み込まれたタグは、同じトラックに割り当てられます。トラックの指定は、編集選択子と同じ方法（以下を参照）で行います。例：--tags track:a1:new-audio-tags.xml.

ファイル内の全てのトラックの統計情報を計算し、新しい統計タグを追加します。既に統計タグが含まれている場合は更新されます。

ファイルから既存の全てのトラック統計タグを削除します。ファイルに統計タグが含まれていない場合は修正されません。

filenameからのチャプタを、このファイル中のチャプタに追加、あるいは置換します。もしfilenameが空白なら、チャプタを削除します。mkvpropedit(1)は、mkvmerge(1)が読み込むのと同じXMLまたはシンプルチャプタ形式を読み込みます。

filenameから新しい添付ファイルを追加します。

このオプションの前に--attachment-nameオプションが使用されている場合、その値が新しい添付ファイルの名前として使用されます。そうでない場合は、filenameから派生した名前が使用されます。

このオプションの前に--attachment-mime-typeオプションが使用されている場合、その値が新しい添付ファイルのMIMEタイプとして使用されます。そうでない場合は、filenameの内容から自動検出されます。

このオプションの前に--attachment-descriptionオプションが使用されている場合、その値が新しい添付ファイルの説明として使用されます。そうでない場合は、説明は設定されません。

このオプションの前に--attachment-uidオプションが使用されている場合、その値が新しい添付ファイルのUIDとして使用されます。そうでない場合は、ランダムなUIDが自動的に生成されます。

selectorに一致する一つ以上の添付ファイルを、ファイルfilenameで置換します。複数の既存の添付ファイルがselectorに一致する場合、それらすべての内容がfilenameの内容で置換されます。

selectorは4つの形式のいずれかをとることができます。これらについては、後述の添付ファイル選択子のセクションで説明します。

このオプションの前に--attachment-nameオプションが使用されている場合、その値が修正された各添付ファイルの新しい名前として設定されます。そうでない場合は、名前は変更されません。

このオプションの前に--attachment-mime-typeオプションが使用されている場合、その値が修正された各添付ファイルの新しいMIMEタイプとして設定されます。そうでない場合は、MIMEタイプは変更されません。

このオプションの前に--attachment-descriptionオプションが使用されている場合、その値が修正された各添付ファイルの新しい説明として設定されます。そうでない場合は、説明は変更されません。

このオプションの前に--attachment-uidオプションが使用されている場合、その値が修正された各添付ファイルの新しいUIDとして設定されます。そうでない場合は、UIDは変更されません。

selectorに一致する一つ以上の添付ファイルのプロパティを設定します。複数の既存の添付ファイルがselectorに一致する場合、それらすべてのプロパティが更新されます。

selectorは4つの形式のいずれかをとることができます。これらについては、後述の添付ファイル選択子のセクションで説明します。

このオプションの前に--attachment-nameオプションが使用されている場合、その値が修正された各添付ファイルの新しい名前として設定されます。そうでない場合は、名前は変更されません。

このオプションの前に--attachment-mime-typeオプションが使用されている場合、その値が修正された各添付ファイルの新しいMIMEタイプとして設定されます。そうでない場合は、MIMEタイプは変更されません。

このオプションの前に--attachment-descriptionオプションが使用されている場合、その値が修正された各添付ファイルの新しい説明として設定されます。そうでない場合は、説明は変更されません。

このオプションの前に--attachment-uidオプションが使用されている場合、その値が修正された各添付ファイルの新しいUIDとして設定されます。そうでない場合は、UIDは変更されません。

selectorに一致する一つ以上の添付ファイルを削除します。

selectorは4つの形式のいずれかをとることができます。これらについては、後述の添付ファイル選択子のセクションで説明します。

以降の --add-attachment または --replace-attachment 操作で使用する名前を設定します。

以降の --add-attachment または --replace-attachment 操作で使用するMIMEタイプを設定します。

以降の --add-attachment または --replace-attachment 操作で使用する説明を設定します。

特定のフォント添付ファイルに対して、レガシーな MIME タイプの使用を有効にします。例えば、TrueType フォントに対して 'fonts/ttf' の代わりに 'application/x-truetype-font' が使用されるようになります。

これは、新しい添付ファイルの追加と既存の添付ファイルの置換の両方に影響しますが、新しい MIME タイプが指定されていない場合に限ります。その他の既存の添付ファイルは変更されません。

影響を受ける MIME タイプは、'font/sfnt'、'font/ttf'、'font/collection'（これらはすべて 'application/x-truetype-fonts' にマッピング）および 'font/otf'（'application/vnd.ms-opentype' にマッピング）です。

通常、利用者がトラック頭部プロパティの「language」の変更を要求すると、mkvpropedit(1) はレガシーな Language 要素に加えて、新しい LanguageIETF トラック頭部要素にも同じ変更を適用します。このオプションを使用すると、変更はレガシーな Language 要素にのみ適用されます。

このオプションは、「language-ietf」トラック頭部プロパティ経由で要求された変更には影響しません。

すべての IETF BCP 47 言語タグの正規化を有効にします。「canonical」モードでは標準形式に、「extlang」モードでは拡張言語サブタグ形式に正規化されます。「off」で無効にできます。デフォルトでは標準形式（canonical）への正規化が適用されます。

標準形式（canonical）では、より好ましい値が存在するすべてのサブタグがその値に置換されます。例えば、「zh-yue-jyutping」は「yue-jyutping」に、「fr-FX」は「fr-FR」に変換されます。

拡張言語サブタグ形式では、まず標準形式が作成されます。その後、拡張言語サブタグが存在するすべての主要言語が、その拡張言語サブタグと接頭辞の組み合わせに置換されます。これにより、例えば「yue-jyutping」は「zh-yue-jyutping」に戻されますが、「fr-FR」には影響しません（「fr」は拡張言語サブタグではないため）。

この正規化は、実際に変更された要素にのみ適用されます:

ファイル内の既存のすべての言語タグを正規化する最良の方法は、mkvmerge(1) で再多重化し、その「--normalize-language-ietf」オプションを目的のモードに設定することです。

コマンドラインで指定された文字列の変換に使用する文字セットを設定します。デフォルトはシステムの現在のロケールに基づいた文字セットです。

出力される文字列を変換するのに用いる文字集合を設定します。既定では機構の現行地域特性で指定している文字集合になります。

全てのメッセージをコンソールではなくfile-nameで指定したファイルに書き出します。出力リダイレクトによっても同じことが簡単にできますが、このオプションが必要な場合もあります。ターミナルがファイルに書き込む前に出力を処理してしまう場合などです。--output-charsetによって指定された文字コードは尊重されます。

Normally text files that are created & encoded in one of the UTF variants will start with a byte order marker (BOM). Using this option disables writing that byte order marker.

用いる翻訳を指定した言語符号のものに強制します（例えば「de_DE」ならドイツ語翻訳です）。符号に「list」を指定すると利用可能な翻訳の一覧を出力します。

最初の警告が出た時点でプログラムを中止するように指示します。この場合のプログラムの終了コードは1になります。

特定の機能のデバッグ出力を有効にします。このオプションは開発者向けです。

実験的機能をオンにします。利用可能な機能のリストはmkvpropedit --engage listで得られます。これらの機能は通常の状況で利用されることは意図されていません。

GUIモードを有効にします。このモードでは、制御しているGUIに状況を伝えるための特殊な形式の行が出力されます。これらのメッセージは「#GUI#メッセージ」という形式に従います。メッセージの後には、「#GUI#メッセージ#キー1=値1#キー2=値2...」のようにキーと値のペアが続くことがあります。メッセージ内容やキー名は翻訳されず、常に英語で出力されます。

詳細（冗長）モードを有効にし、読み込まれた重要なMatroska要素をすべて表示します。

ヘルプを表示して終了します。

バージョン情報を表示して終了します。

指定したファイル（オプションファイル）から追加のコマンドライン引数を読み込みます。サポートされている形式の詳細については、mkvmerge(1)のmanページにある「オプションファイル」のセクションを参照してください。

1.添付ファイル識別子での選択。この形式では、選択子は単に数字であり、mkvmerge(1)の識別命令が出力する添付ファイル識別子と同じものです。

2.添付ファイル固有識別子での選択。この形式では、選択子は等号=に続く数字であり、mkvmerge(1)の識別命令が出力する添付ファイル固有識別子と同じものです。

3.添付ファイル名による選択。この形式では、選択子は即値語name:に続く存在する添付ファイルの名前です。この選択子を--replace-attachmentと共に用いる場合は、合致する名前中のコロンは\cと退避させなくてはなりません。

4.MIME種別による選択。この形式では、選択子は即値語mime-type:に続く存在する添付ファイルのMIME種別です。この選択子を--replace-attachmentと共に用いる場合は、合致するMIME種別中のコロンは\cと退避させなくてはなりません。

$ mkvpropedit movie.mkv --edit info --set "title=The movie" --edit track:a1 --set language=fre --edit track:a2 --set language=ita

$ mkvpropedit movie.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1

$ mkvpropedit movie.mkv --tags track:s2:new-subtitle-tags.xml

$ mkvpropedit movie.mkv --tags all:

$ mkvpropedit movie.mkv --chapters new-chapters.xml

$ mkvpropedit movie.mkv --chapters ''

$ mkvpropedit movie.mkv --add-attachment Arial.ttf

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --replace-attachment name:Comic.ttf:Arial.ttf

$ mkvpropedit movie.mkv --delete-attachment 2

$ mkvpropedit movie.mkv --delete-attachment mime-type:application/x-truetype-font

•0 -- この終了コードは変更が成功したことを示します。

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

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

その内容を、あたかも --debug オプション経由で渡されたかのように扱います。

その内容を、あたかも --engage オプション経由で渡されたかのように扱います。

開発者