foobar 设置：标题格式化语法参考
2017-01-25 本文已影响0人
lumicinta
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% |
