foobar 设置:标题格式化语法参考
foobar 设置:标题格式化语法参考
标签(空格分隔): foobar
一般字段
语法 |
解释 |
%title% |
音轨标题。若元数据 “title” 不存在则使用文件名代替。 |
%artist% |
艺术家名。依次检查下列元数据字段: “artist”, “album artist”, “composer”, “performer”。 |
%album artist% |
专辑艺术家名。依次检查下列元数据字段: “album artist”, “artist”, “composer”, “performer”。与 %artist% 不同的是 %album artist% 用于在整张专辑有不同艺术家的情况。 |
%track artist% |
音轨艺术家名。仅在 %album artist% 与 %artist% 不同的时候有效。用于与 %album artist% 共同使用以指定专辑中的不同艺术家,例如: ”%album artist% - %title%[ '//' %track artist%]” ;在这种情况下,最后一部分内容仅会在有根据音轨指定的艺术家存在时才会显示。 |
%album% |
专辑名。依次检查下列元数据字段: “album”, “venue”. |
%date% |
年代。使用元数据 “date” 字段。 |
%genre% |
流派,使用元数据 “genre” 字段。 |
%tracknumber% |
音轨号。仅在存在元数据 “tracknumber” 字段时有效。 |
%totaltracks% |
合计音轨。仅在存在元数据 “totaltracks” 字段时有效。 |
%discnumber% |
光盘编号。仅在存在元数据 “discnumber” 或 “disc” 字段时有效。 |
%totaldiscs% |
合计光盘。仅在存在元数据 “totaldiscs” 字段时有效。 |
%codec% |
编码格式名。若无法有效取得准确的编码格式,使用文件后缀。 |
%codec_profile% |
关于编码设置的附加信息,并不总是有效。 |
%filename% |
文件名,不包括后缀名和目录 |
%filename_ext% |
文件名,包括后缀名但不包括目录。 |
%directoryname% |
文件所处目录名。 |
%path% |
文件路径,注意排序时应使用 %path_sort% 而非 %path%。 |
%subsong% |
文件内的音轨编号,用于单文件支持多音轨的文件格式(例如章节和CUE)。 |
%path_sort% |
结合了音轨号的文件路径,用于排序;返回值不确定,因此不应依赖其返回值。 |
%length% |
长度,格式为 [HH:]MM:SS。 |
%length_seconds% |
长度,单位为秒,格式是整数。 |
%bitrate% |
比特率,单位为千比特每秒(kbps);支持动态 VBR 比特率。 |
%channels% |
声道数(mono/stereo/etc)。 |
%samplerate% |
采样率,单位为 Hz。 |
%replaygain_track_gain%, %replaygain_album_gain%, %replaygain_track_peak%, %replaygain_album_peak% |
播放增益相关信息。 |
%filesize% |
文件大小,单位为字节。 |
%filesize_natural% |
文件大小,将根据实际情况返回如MB或KB的形式。 |
%last_modified% |
返回文件最后更改时间,格式为 YYYY-MM-DD HH:MM:SS。 |
以上列表内容没有完成,还有一些不太重要的字段如 %field%、元数据和 %__field%、技术信息映射,它们用于保持向后兼容性。
上下文字段
语法 |
解释 |
%list_index% |
指定项目所在的列表编号。应用于:播放列表,由 masstagger/massrenamer 处理过的项目的列表,等等。在结果前补足0以适应列表中最大数的位数。 |
%list_total% |
指定项目所在列表的总项目数。应用于:播放列表,由 masstagger/massrenamer 处理过的列表,等等。 |
%isplaying% |
若当前项目正在播放则有效,例如: 一个播放列表项正在播放。用于 $if() 中的条件。 |
%ispaused% |
若当前项目正在播放并处于暂停状态则有效,例如: 一个播放列表项已暂停。用于 $if() 中的条件。 |
%playback_time% |
当前播放时间,格式为 [HH:]MM:SS。仅在某些使用播放上下文信息的地方有效,例如状态栏。 |
%playback_time_seconds% |
当前播放时间,单位为秒。格式为整数。仅在某些使用播放上下文信息的地方有效,例如状态栏。 |
%playback_time_remaining% |
剩余播放时间,格式为 [HH:]MM:SS。仅在某些会使用播放上下文信息的地方有效,例如状态栏。若当前播放音轨无持续时间信息则无效。 |
%playback_time_remaining_seconds% |
剩余播放时间,单位为秒。格式为整数。仅在某些使用播放上下文信息的地方有效,例如状态栏。若当前播放音轨无持续时间信息则无效。 |
%queue_index% |
指定项目所处队列的编号,仅对播放列表有效。 |
%queue_indexes% |
指定项目所处队列的编号列表,仅对播放列表有效。当指定项目仅在队列中出现一次则与 %queue_index% 等价。 |
%queue_total% |
队列的项目总数。由于技术上的原因该字段仅对属于队列中音轨有效。 |
其它
语法 |
解释 |
示例 |
[ …. ] |
若字段不存在引用则丢弃方括号中的所有内容。主要用于创建部分仅在相关字段有效时的格式化脚本。 |
%artist% - [%album% / ]%title% |
' (单引号) |
插入指定文本忽略语法处理;允许有特殊字符比如"%"、"$"、"["和"]"。若需要在文本中插入单引号,可以使用 '' (两个单引号)。 |
// |
注释,仅能用于行首;注释后的文本从行首到行尾不会被解析。 |
EOL字符 |
忽略; 你可以使你的脚本拆分为多行以增加可读性,而不会影响结果。 |
Tab(制表符) |
用于对特定上下文文本进行对齐,例如状态栏。 |
参见: $tab() %title%$tab()%length% |
本文标题:foobar 设置:标题格式化语法参考
本文链接:https://www.haomeiwen.com/subject/lnhxittx.html
网友评论