winamp/Src/tagz/tagz.txt

23 lines
2.2 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Syntax Reference:
* %tagname% - inserts field named <tagname>, eg. "%artist%"
* $abbr(x) - inserts abbreviation of x, eg. "$abbr(%album%)" - will convert album name of "Final Fantasy VI" to "FFVI"
* $abbr(x,y) - inserts abbreviation of x if x is longer than y characters; otherwise inserts full value of x, eg. "$abbr(%album%,10)"
* $lower(x), $upper(x) - converts x to lower/uppercase, eg. "$upper(%title%)"
* $num(x,y) - displays x number and pads with zeros up to y characters (useful for track numbers), eg. $num(%tracknumber%,2)
* $filepart(x) - if passed a filename, gives the filename without directory or extension
* $fileext(x) - if passed a filename, gives the file extension
* $caps(x) - converts first letter in every word of x to uppercase, and all other letters to lowercase, eg. "blah BLAH" -> "Blah Blah"
* $caps2(x) - similar to $caps, but leaves uppercase letters as they are, eg. "blah BLAH" -> "Blah BLAH"
* $if(A,B,C) - if A contains at least one valid tag, displays B, otherwise displays C; eg. "$if(%artist%,%artist%,unknown artist)" will display artist name if present; otherwise will display "unknown artist"; note that "$if(A,A,)" is equivalent to "[A]" (see below)
* $if2(A,B) - if A is valid, uses A, otherwise, uses B
* $longest(A,B,C,....) - compares lengths of output strings produced by A,B,C... and displays the longest one, eg. "$longest(%title%,%comment%)" will display either title if it's longer than comment; otherwise it will display comment
* $pad(x,y) - pads x with spaces up to y characters
* $cut(x,y) - truncates x to y characters
* $padcut(x,y) - pads x to y characters and truncates to y if longer
* $repeat(x,y) - creates a string consisting of x repeating y times; e.g. $repeat(*, 7) becomes *******
* [ .... ] - displays contents of brackets only if at least one of fields referenced inside has been found, eg. "%artist% - [%album% / ]%title%" will hide [] block if album field is not present
* ' (single quotation mark) - outputs raw text without parsing, eg, 'blah$blah%blah[][]' will output the contained string and ignore all reserved characters (%,$,[,]) in it; you can use this feature to insert square brackets for an example.
eg. "[%artist% - ][$abbr(%album%,10)[ %tracknumber%] / ]%title%[ %streamtitle%]"