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%