列出所有已知的可编辑的属性名称、它们的类型（字符串型、整数型、布尔型等等）及简短说明。程序随后将退出执行。因此不必提供 source-filename 参数。

设置解析模式。参数 '模式' 可以为 'fast（快速）'（此项为默认值）或 'full（完整）'。'fast（快速）'模式不解析整个文件，而是使用元定位元素确定输入文件中所需元素的位置。99% 的情况下这就足够了。但如果碰到不含元定位元素或者元定位元素损坏的文件，用户可能得考虑 'full（完整）' 解析模式。完整扫描文件可能要花费几分钟，而快速扫描只需要几秒钟。

设置后续的 添加、设置 或 删除 操作所针对的 Matroska 文件区域（即剪辑信息或某个轨道的头部）。此选项可多次使用，以同时修改多个元素。

默认情况下，mkvpropedit(1) 将编辑剪辑信息区段。

关于完整的语法说明请参见关于 编辑选择器 的段落。

添加名为 名称、值为 数值 的属性。即使已存在这样的属性，也将执行添加属性操作。注意大多数属性是唯一的，不能出现多个。

设置所有名为 名称 的属性的数值为 数值。如果不存在这样的属性，则将添加该属性。

删除所有名为 名称 的属性。注意部分属性是必需的，不能删除。

用 文件名 中的标签添加或替换文件中的标签，或者如果 文件名 为空则移除标签。mkvpropedit(1) 读取的 XML 标签格式与 mkvmerge(1) 所读取的相同。

选择器 必须是 all、global 或 track 之一。对于all 选择器，mkvpropedit(1) 将替换或移除文件中的所有标签。对于 global 选择器，将只替换或移除全局标签。

对于 track 选择器，mkvpropedit(1) 将替换特定轨道的标签。读取自 文件名 的其他标签将分配给相同轨道。轨道与 编辑选择器 以相同格式指定 (参见下文)，如 --tags track:a1:新音频标签.xml。

计算文件所有轨道的统计信息，并为每个轨道新增一个统计信息标签。若文件中已经存在此类标签，则将更新这些标签。

从文件中删除现有的全部轨道统计标签。若文件不包括轨道统计标签，则不会被修改。

用 文件名 中的标签添加或替换文件中的章节，或者如果 文件名 为空则移除章节。mkvpropedit(1) 读取的 XML 及简单章节格式与 mkvmerge(1) 所读取的相同。

从 文件名 添加新附件。

若本选项之前使用了 --attachment-name 选项，则其值将用作新附件的名称。否则附件名称将从 文件名 得出。

若本选项之前使用了 --attachment-mime-type 选项，则其值将用作新附件的 MIME 类型。否则将根据 文件名 的内容自动侦测。

若本选项之前使用了 --attachment-description 选项，则其值将用作新附件的描述。否则将不设置描述信息。

若本选项之前使用了 --attachment-uid 选项，则其值将用作新附件的 UID。否则将自动生成随机的 UID。

用文件 文件名 替换与 选择器 相匹配的一或多个附件。如果有超过一个现有附件与 选择器 相匹配，则其所有内容均将被 文件名 的内容替代。

选择器 可以有四种格式。各格式说明位于下文 附件选择器 段落。

若本选项之前使用了 --attachment-name 选项，则其值将设为每个被修改的附件的新名称。否则不修改名称。

若本选项之前使用了 --attachment-mime-type 选项，则其值将设为每个被修改的附件的新 MIME 类型。否则不修改 MIME 类型。

若本选项之前使用了 --attachment-description 选项，则其值将设为每个被修改的附件的新描述。否则不修改描述。

若本选项之前使用了 --attachment-uid 选项，则其值将设为每个被修改的附件的新 UID。否则不修改 UID。

设置 选择器 所匹配的一或多个附件的属性。如果匹配 选择器 的现有附件超过一个，则每个附件的属性都将被更新。

选择器 可以有四种格式。各格式说明位于下文 附件选择器 段落。

若本选项之前使用了 --attachment-name 选项，则其值将设为每个被修改的附件的新名称。否则不修改名称。

若本选项之前使用了 --attachment-mime-type 选项，则其值将设为每个被修改的附件的新 MIME 类型。否则不修改 MIME 类型。

若本选项之前使用了 --attachment-description 选项，则其值将设为每个被修改的附件的新描述。否则不修改描述。

若本选项之前使用了 --attachment-uid 选项，则其值将设为每个被修改的附件的新 UID。否则不修改 UID。

删除与 选择器 相匹配的一或多个附件。

选择器 可以有四种格式。各格式说明位于下文 附件选择器 段落。

设置接下来 --add-attachment 或 --replace-attachment 操作要使用的名称。

设置接下来 --add-attachment 或 --replace-attachment 操作要使用的 MIME 类型。

设置接下来 --add-attachment 或 --replace-attachment 操作要使用的描述。

Normally when the user requests changes to the 'language' track header property, mkvpropedit(1) will apply the same change to the new LanguageIETF track header element in addition to the legacy Language element. If this option is used, the change is only applied to the legacy Language element.

This option does not affect changes requested via the 'language-ietf' track header property.

设定在命令行给出的字符串的字符集，用于转为其他字符集。默认为系统当前区域设置中所给定的字符集。

设置输出的字符串应被转换到何种字符集。默认为系统当前区域设置中所给定的字符集。

将所有信息写入文件 文件名 而不是输出到命令行。 尽管该操作可以用输出重定向轻松实现，但在某些情况下还需要靠它：如当终端在写入文件之前重新解释（覆盖输出）时。将优先使用通过 --output-charset 设定的字符集。

强制使用 语言代码 所对应的翻译 (例如 'de_DE' 表示德文翻译)。在 语言代码 处输入 'list' 可让程序输出可用翻译的列表。

让程序在出现警告时即中止。程序的退出代码将返回 1。

为特定功能开启调试。该选项仅对开发者有用。

开启实验性功能。可用功能列表可通过 mkvpropedit --engage list 得到。这些功能在正常情况下不应该使用。

打开 GUI 模式。该模式下，将输出特殊格式的行，告知目前受控的 GUI 的行为。这些消息遵从格式「#GUI#消息」。消息可能包括键值对，如「#GUI#消息#键1=值1#键2=值2...」。消息内容及键的内容不作翻译，总是以英语输出。

使输出信息更详尽，且每当读取到重要的 Matroska 元素时就将其显示。

显示用法信息并退出。

显示版本信息并退出。

从文件 选项文件 读取其他命令行参数。关于支持的选项文件格式的详细说明，请参见 mkvmerge(1) 手册的“选项文件”段落。

1.按附件 ID 选择。本格式的选择器仅仅是数字，mkvmerge(1) 的识别命令所输出的附件 ID。

2.按附件 UID (唯一 ID) 选择。本格式的选择器为等号 = 后接数字，mkvmerge(1) 的详尽识别命令所输出的附件的唯一 ID。

3.按附件名称选择。本格式的选择器为文字 name: 后接现有附件名称。若本选择器与 --replace-attachment 一同使用，则名称中的冒号必须用 \c 转义。

4.按 MIME 类型选择。本格式的选择器为文字 mime-type: 后接现有附件的 MIME 类型。若本选择器与 --replace-attachment 一同使用，则 MIME 类型中的冒号必须用 \c 转义。

$ mkvpropedit 影片.mkv --edit info --set "title=一部影片" --edit track:a1 --set language=fre --edit track:a2 --set language=ita

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

$ mkvpropedit 影片.mkv --tags track:s2:新字幕标签.xml

$ mkvpropedit 影片.mkv --tags all:

$ mkvpropedit 影片.mkv --chapters 新章节.xml

$ mkvpropedit 影片.mkv --chapters ''

$ mkvpropedit 影片.mkv --add-attachment Arial.ttf

$ mkvpropedit 影片.mkv --attachment-name Arial.ttf --attachment-description 'Arial 字体，TrueType 类型' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

$ mkvpropedit 影片.mkv --attachment-name Arial.ttf --attachment-description 'Arial 字体，TrueType 类型' --replace-attachment name:Comic.ttf:Arial.ttf

$ mkvpropedit 影片.mkv --delete-attachment 2

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

•0 -- 此退出代码说明已成功完成修改。

•1 -- 这种情况下 mkvpropedit(1) 至少输出了一条警告信息，但修改并未因之中止。 警告信息以文字 '警告:' 为前缀。根据问题的不同，生成的文件可能是好的，也可能不是。 强烈建议用户检查警告信息以及生成的文件。

•2 -- 此退出代码用于错误发生之后。 mkvpropedit(1) 在输出错误信息后即中断处理。错误信息可能是错误的命令行参数，也可能是损坏文件的读取/写入错误。

内容将被当作通过 --debug 选项传递的参数对待。

内容将被当作通过 --engage 选项传递的参数对待。

开发者

https://mkvtoolnix.download/