| Item index | $num(%list_index%,1) |
| Artist | %artist% |
| Album | %album% |
| Artist/album | %album artist% - %album% |
| Track no | [%discnumber%.][%tracknumber%] |
| Title | %title% |
| Title / track artist | %title%[ '//' %track artist%] |
| Date | %date% |
| Duration | %length% |
| Codec | %codec%[ / %codec_profile%] |
| Bitrate | [%bitrate% ]kbps |
| Playing | $if(%ispaused%,⏸,$if(%isplaying%,▶,)) |
| File name | %filename% |
| File extension | $ext(%path%) |
| File path | %path% |
| File size | %filesize_natural% |
Remapped metadata fields
The following fields have special remapped values to make writing title format scripts more convenient:%album artist%
Name of the artist of the album specified track belongs to. Checks following metadata fields, in this order: "album artist", "artist", "composer", "performer". The difference between this and %artist% is that %album artist% is intended for use where consistent value across entire album is needed even when per-track artists values vary.%album%
Name of the album specified track belongs to. Checks following metadata fields, in this order: "album", "venue".%artist%
Name of the artist of the track. Checks following metadata fields, in this order: "artist", "album artist", "composer", "performer". For a SHOUTcast stream which contains metadata, it is the StreamTitle up to the first "-" character.%discnumber%
Index of disc specified track belongs to, within the album. Available only when "discnumber"/"disc" field is present in track’s metadata.%totaldiscs%
Index of total discs specified tracks belong to, within the album. Available only when "discnumber"/"disc" field is present in track’s metadata.%track artist%
Name of the artist of the track; present only if %album artist% is different than %artist% for specific track. Intended for use together with %album artist%, to indicate track-specific artist info, e.g. "%album artist% - %title%[ '//' %track artist%]". In this case, the last part will be displayed only when track-specific artist info is present.%title%
Title of the track. If "title" metadata field is missing, file name is used instead. For a SHOUTcast stream which contains metadata, it is the StreamTitle after the first "-" character.%tracknumber%
Two-digit index of specified track within the album. Available only when "tracknumber" field is present in track’s metadata. An extra '0' is placed in front of single digit track numbers (5 becomes 05).%track number%
Similar to %tracknumber%, however single digit track numbers are not reformatted to have an extra 0.Technical information fields
%bitrate%
Bitrate of the track in kilobits per second. VBR files will show a dynamic display for currently played track (outside of the playlist).%channels%
Number of channels in the track, as text; either "mono", "stereo" for 1 or 2 channels, respectively, otherwise a number followed by "ch", e.g. "6ch".%codec%
Name of codec used to encode the track, e.g. PCM, FLAC, MP3, or AAC. If exact codec name is not available, file extension is used. The Default UI's standard Codec column displays the same info, but sometimes adds details, e.g. "MP3 / VBR V2" or "AAC / LC".%filesize%
The exact file size in bytes. Old version: %_filesize%%filesize_natural%
The approximate file size, automatically formatted in appropriate units such as megabytes or kilobytes, e.g. "8.49 MB"%length%
The length of the track formatted as hours, minutes, and seconds, rounded to the nearest second. Old version: %_time_total%%length_ex%
The length of the track formatted as hours, minutes, seconds, and milliseconds, rounded to the nearest millisecond.%length_seconds%
The length of the track in seconds, rounded to the nearest second. Old version: %_time_total_seconds%%length_seconds_fp%
The length of the track in seconds as a floating point number.%length_samples%
The length of the track in samples.%samplerate%
Sample rate of the track, in Hz.Technical information functions
$info(name)
Returns value of technical information field called name.For convenience, the %__name% alias is also available.
Example: $info(channels) → 2
Here is an informative list of recognized fields. Some of these depend on the media file type being queried.
field nameDescription
| General | |
| codec | Codec (e.g. MP3) |
| codec_profile | Codec Profile (e.g. CBR) |
| samplerate | Sample Rate, in hertz (e.g. 44100) |
| bitrate | Bitrate, in kilobits per second (e.g. 320) |
| tool | Tool used to produce the file, possibly guessed (e.g. LAME3.97) |
| encoding | Encoding lossiness (e.g. lossy) |
| channels | Channels count (e.g. 2 [for stereo]) |
| channel_mode | Channel Mode, description of channels (e.g. 3 front, 2 rear surround channels + LFE) |
| bitspersample | Bits Per Sample (e.g. 16) |
| tagtype | Tag Type, comma-separated list of tag formats (e.g. id3v2|apev2) |
| cue_embedded | Embedded Cuesheet presence (e.g. no [may be empty!]) |
| md5 | Audio MD5 hash, if container defines it (e.g. 1E24A910D91EF09A8CF403C9B6963961) |
| Other | |
| ENC_DELAY | LAME proprietary MP3 enc_delay value for gapless playback (e.g. 576) |
| ENC_PADDING | LAME proprietary MP3 enc_padding value for gapless playback (e.g. 1536) |
| MP3_ACCURATE_LENGTH | MP3 duration (%length% etc.) takes into account LAME or iTunes gapless playback info (e.g. yes)* |
| MP3_STEREO_MODE | Stereo mode used in MP3 file (e.g. mono, stereo, joint stereo, etc.) |
| VERSION | Version of tool (e.g. 3.99) |
| FLAGS | Flags of tool (e.g. 22) |
* MP3_ACCURATE_LENGTH won't exist if gapless playback info isn't present or the file is not an MP3. The info can be in a LAME tag in the VBR header, or in an iTunSMPB ID3v2 comment tag. Gapless playback info is taken into account in .m4a files, but there's no special field to say so.
$channels()
The number of channels in text format.Example: $channels() → "stereo"
%replaygain_album_gain%
The ReplayGain album gain value.%replaygain_album_peak%
The ReplayGain album peak value.%replaygain_album_peak_db%
The ReplayGain album peak value in decibels.%replaygain_track_gain%
The ReplayGain track gain value.%replaygain_track_peak%
The ReplayGain track peak value.%replaygain_track_peak_db%
The ReplayGain track peak value in decibels.Special fields
%filename%
The filename without directory and extension.%filename_ext%
The filename with extension, but without the directory.%directoryname%
The name of the parent directory only, not the complete path.%last_modified%
The date and time the file was last modified. Eg: 2005-12-22 00:04:10%path%
The complete path, including the filename and extension.%_path_raw%
The path as URL including the protocol scheme.%subsong%
The subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
Tags
지식