MKVPROPEDIT(1) | MKVPROPEDIT(1) |
mkvpropedit - 再MUXすることなく、既存のMatroskaファイルのプロパティを修正する
mkvpropedit [options] {source-filename} {actions}
このプログラムは、既存のMatroskaファイルを解析し、そのプロパティのいくつかを修正します。そして、それらの修正を既存のファイルに書き込みます。プロパティの中で変更可能なのは、セグメント情報エレメント(例えばタイトル)と、トラックヘッダ(例えば言語コードや'デフォルトトラック'フラグ、トラック名)です。
オプション:
-l, --list-property-names
-p, --parse-mode mode
Actions that deal with track and segment info properties:
-e, --edit selector
デフォルトでは、mkvpropedit(1)はセグメント情報のセクションを編集します。
文法の完全な説明は、エディットセレクタのセクションを参照してください。
-a, --add name=value
-s, --set name=value
-d, --delete name
Actions that deal with tags and chapters:
-t, --tags selector:filename
セレクタは、all、global、またはtrackのうちどれか一つを指定してください。allを指定すると、mkvpropedit(1)はファイル中の全てのタグを置換あるいは削除します。globalを指定すると、グローバルタグだけが置換あるいは削除されます。
trackを指定すると、mkvpropedit(1)は特定のトラックのタグを置換します。また、filenameから読み込まれたタグは、同じトラックに割り当てられます。edit selectorsが指定されるのと同じ様に(下を参照してください)、トラックは指定されます。(see below), e.g. --tags track:a1:new-audio-tags.xml.
--add-track-statistics-tags
--delete-track-statistics-tags
-c, --chapters filename
Actions for handling attachments:
--add-attachment filename
If the option --attachment-name has been used prior to this option then its value is used as the new attachment's name. Otherwise it is derived from filename.
If the option --attachment-mime-type has been used prior to this option then its value is used as the new attachment's MIME type. Otherwise it is auto-detected from the content of filename.
If the option --attachment-description has been used prior to this option then its value is used as the new attachment's description. Otherwise no description will be set.
If the option --attachment-uid has been used prior to this option then its value is used as the new attachment's UID. Otherwise a random UID will be generated automatically.
--replace-attachment selector:filename
The selector can have one of four forms. They're exlained below in the section attachment selectors.
If the option --attachment-name has been used prior to this option then its value is set as the new name for each modified attachment. Otherwise the names aren't changed.
If the option --attachment-mime-type has been used prior to this option then its value is set as the new MIME type for each modified attachment. Otherwise the MIME types aren't changed.
If the option --attachment-description has been used prior to this option then its value is set as the new description for each modified attachment. Otherwise the descriptions aren't changed.
If the option --attachment-uid has been used prior to this option then its value is set as the new UID for each modified attachment. Otherwise the UIDs aren't changed.
--update-attachment selector
The selector can have one of four forms. They're exlained below in the section attachment selectors.
If the option --attachment-name has been used prior to this option then its value is set as the new name for each modified attachment. Otherwise the names aren't changed.
If the option --attachment-mime-type has been used prior to this option then its value is set as the new MIME type for each modified attachment. Otherwise the MIME types aren't changed.
If the option --attachment-description has been used prior to this option then its value is set as the new description for each modified attachment. Otherwise the descriptions aren't changed.
If the option --attachment-uid has been used prior to this option then its value is set as the new UID for each modified attachment. Otherwise the UIDs aren't changed.
--delete-attachment selector
The selector can have one of four forms. They're exlained below in the section attachment selectors.
Options for attachment actions:
--attachment-name name
--attachment-mime-type mime-type
--attachment-description description
その他のオプション:
--command-line-charset character-set
--output-charset character-set
-r, --redirect-output file-name
--ui-language code
--abort-on-warnings
--debug topic
--engage feature
--gui-mode
-v, --verbose
-h, --help
-V, --version
@options-file.json
--editオプションは、以降のadd、set及びdeleteアクションが適用されるMatroskaファイルセクション(セグメント情報または特定のトラックヘッダ)を設定します。これは次の--editオプションが見付かるまでずっと有効です。このオプションへの引数はエディットセレクタと呼ばれます。
デフォルトでは、mkvpropedit(1)はセグメント情報のセクションを編集します。
セグメント情報は次の3つの単語によって選択されます。'info'、'segment_info'または'segmentinfo'です。これはセグメントタイトルやセグメントUIDなどのプロパティを格納しています。
トラックヘッダはもうちょっとだけ複雑なセレクタで選択されます。全ての場合でセレクタは'track:'で始まります。トラックヘッダプロパティには、言語コード、'デフォルトトラック'フラグやトラック名のようなエレメントがあります。
track:n
Numbering starts at 1.
track:tn
Numbering starts at 1.
track:=uid
track:@number
トラックエディットセレクタの性質から、いくつかのセレクタが同じトラックヘッダにマッチすることがあります。このような場合、それらのエディットセレクタへの全てのアクションは一つにまとめられ、コマンドラインに指定された順番に実行されます。
An attachment selector is used with the two actions --replace-attachment and --delete-attachment. It can have one of the following four forms:
下に'movie.mkv'というファイルを編集する例を示します。この例では、セグメントタイトルを設定し、オーディオトラックと字幕トラックの言語コードを修正します。この例は、最初の--editオプションが見付かる前の全てのオプションはデフォルトで結局セグメント情報エレメントを編集するので、最初の--editオプションを省略して短縮できることに注意してください。
$ mkvpropedit movie.mkv --edit info --set "title=The movie" --edit track:a1 --set language=fre --edit track:a2 --set language=ita
二番目の例は、最初の字幕トラックから'デフォルトトラックフラグ'を削除し二番目の字幕トラックに設定します。mkvpropedit(1)はmkvmerge(1)とは違い、'デフォルトトラックフラグ'が違うトラックで'1'に設定されているからといって自動的に他のトラックの'デフォルトトラックフラグ'を'0'に設定はしない、という点に注意してください。
$ mkvpropedit movie.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1
ファイル中で2番目の字幕トラックのタグを置換するには、以下のようにします:
$ 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 ''
Adding a font file (Arial.ttf) as an attachment:
$ mkvpropedit movie.mkv --add-attachment Arial.ttf
Adding a font file (89719823.ttf) as an attachment and providing some information as it really is just Arial:
$ 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
Replacing one attached font (Comic.ttf) file with another one (Arial.ttf):
$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --replace-attachment name:Comic.ttf:Arial.ttf
Deleting the second attached file, whatever it may be:
$ mkvpropedit movie.mkv --delete-attachment 2
Deleting all attached fonts by MIME type:
$ mkvpropedit movie.mkv --delete-attachment mime-type:application/x-truetype-font
mkvpropedit(1)は下の3つの返り値を返します。
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.
mkvpropedit(1)はシステムのロケールを決めるデフォルトの変数(例:LANGやLC_*系)を使用します。追加の変数は以下の通りです:
MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG
MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE
最新のバージョンは、常時MKVToolNixのホームページ[1]から取得できます。
Bunkus Moritz[FAMILY Given] <moritz@bunkus.org>
2019-02-09 | MKVToolNix 31.0.0 |