winamp/Src/tagz/tagz.txt

23 lines
2.2 KiB
Plaintext
Raw Permalink Normal View History

2024-09-24 12:54:57 +00:00
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%]"