Provided by: mkvtoolnix_37.0.0-1build1_amd64 bug

名称

       mkvpropedit - 在不进行完整的重新混流的情况下修改现有 Matroska 文件的属性

概要

       mkvpropedit [选项] {输入文件名} {操作}

说明

       此程序可分析现有 Matroska
       文件,并修改其部分属性。然后它将将变更写入现有文件。可修改的属性包括剪辑信息元素(如标题)和轨道头部(如语言代码、'默认轨'
       标记或轨道名称)。

       选项:

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

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

       轨道、剪辑信息属性处理操作:

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

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

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

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

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

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

       标签及章节处理操作:

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

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

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

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

       --delete-track-statistics-tags
           从文件中删除现有的全部轨道统计标签。若文件不包括轨道统计标签,则不会被修改。

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

       附件处理操作:

       --add-attachment 文件名文件名 添加新附件。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

       附件操作选项:

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

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

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

       其他选项:

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

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

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

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

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

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

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

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

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

       -h, --help
           显示用法信息并退出。

       -V, --version
           显示版本信息并退出。

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

编辑选择器

       --edit 选项设置后续的 添加, 设置 或 删除 操作所影响的 Matroska
       文件区域(剪辑信息或者特定轨道的头部)。在出现另一个 --edit
       选项之前,此选项将一直有效。此选项的参数就叫做编辑选择器。

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

   剪辑信息
       可以通过这三个词中的任意一个选择剪辑信息: 'info'、'segment_info' 或
       'segmentinfo'。剪辑信息包含的属性包括剪辑标题、剪辑 UID 等。

   轨道头部
       可用于选择轨道头部的选择器稍显复杂:所有以 'track:'
       开头的变体。轨道头部属性包括如语言代码、'默认轨' 标记、轨道名称等属性。

       track:n
           如果参数 n 为数字,则将选择第 n 条轨道。轨道顺序与 mkvmerge(1) 的 --identify
           选项所输出的相同。

           编号从 1 开始。

       track:tn
           如果参数以字母 t 后接 n 开头,则将选择选定轨道类型中的第 n 条轨道。轨道类型参数 t
           必须为下述四个字母中的一个: 'a' 代表音频轨道,'b' 代表按钮轨道,'s' 代表字幕轨道,'v'
           代表视频轨道。轨道顺序与 mkvmerge(1) 的 --identify 选项所输出的相同。

           编号从 1 开始。

       track:=uid
           如果参数以 '=' 后接 uid 开头,则将选择轨道 UID 元素等于此 uid 的轨道。轨道 UID 可通过
           mkvinfo(1) 获取。

       track:@数字
           如果参数以 '@' 后接 数字 开头,则选择轨道号元素等于 数字 的轨道。轨道号可以通过
           mkvinfo(1) 获取。

   
       由于轨道编辑选择器的特性,一些选择器所匹配的轨道头部可能是相同的。在此情况下,这些编辑选择器的所有操作将被按照在命令行给出的顺序合并运行。

附件选择器

       附件选择器可与两项操作 --replace-attachment--delete-attachment
       一起使用。它可以有以下四种格式:

        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 转义。

示例

       下面的示例将编辑一个名为 '电影.mkv'
       的文件。示例中将设置剪辑标题并修改一条音频轨和一条字幕轨的语言代码。附注,本示例可以简写,即省去
       --edit 选项,因为在第一个 --edit 选项之前的所有选项默认编辑的就是剪辑信息元素。

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

       第二个示例,将 '默认轨标记' 从第一条字幕轨移除并设置到第二条字幕轨上。注意 mkvpropedit(1)
       与 mkvmerge(1) 不同,不会在将另一个轨道的 '默认轨标记'设为 '1'
       的时候自动将其他轨道的标记设为 '0'。

           $ 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 ''

       将字体文件 (Arial.ttf) 作为附件添加:

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

       将字体文件 (89719823.ttf) 作为附件添加,并提供信息,因为它真的就是 Arial:

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

       将已经附加的字体 (Comic.ttf) 替换为另一个 (Arial.ttf):

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

       删除附加的第二个文件,不论它是什么:

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

       按 MIME 类型删除所有附加字体:

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

退出代码

       mkvpropedit(1) 退出时会返回以下三个退出代码中的一个:

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

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

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

文本文件与字符集转换

       关于 MKVToolNix
       套件中所有工具如何处理字符集转换、输入/输出编码、命令行编码及控制台编码的深入讨论,请参见
       mkvmerge(1) 手册中相对应名称的段落。

环境变量

       mkvpropedit(1) 会使用决定系统区域设置的默认变量 (如 LANGLC_* 族)。其他变量包括:

       MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG 及其缩略形式 MTX_DEBUG
           内容将被当作通过 --debug 选项传递的参数对待。

       MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE 及其缩略形式 MTX_ENGAGE
           内容将被当作通过 --engage 选项传递的参数对待。

参阅

       mkvmerge(1), mkvinfo(1), mkvextract(1), mkvtoolnix-gui(1)

网络

       最新版本总可以在 MKVToolNix 主页[1] 找到。

作者

       Moritz Bunkus <moritz@bunkus.org>
           开发者

备注

        1. MKVToolNix 主页
           https://mkvtoolnix.download/