Winamp is the best, freeware media player that allows you to play most audio formats (including Internet Radio Stations) and video. Winamp works with portable media players, allows you to rip and burn CDs, has a built-in media library, graphic equalizer and visualizations. With the advanced plug-in mechanism, you have the possibility to increase its functionality. Thanks to skins Winamp can look and behave as you like...
Below is an extract of the Winamp supported ATF functionality. ATF determines how Winamp should display metadata in the Playlist window and Main window songticker.
The global ATF string can be manually edited via the Titles page in the Winamp Preferences. The default ATF string in Winamp is: [%artist%-]$if2(%title%,$filepart(%filename%)
This will be displayed as: Artist - Title if the Artist and Title metadata fields are populated in the file tags, otherwise it will just display the filename instead.
eg. ‘blah$blah%blah[]’ which will output all the string and ignore the special characters ($,%,[,])
Note: Fields are defined by various components within Winamp. Some are specific to the Media Library (%rating%, %playcount%), some are provided by Winamp (%filename%, %folder%). In most cases, however, the input plugin provides the fields. Some input plugins provide a greater variety of fields than others. For example, the Windows Media plugin (in_wm, Winamp 5.12+), will provide values for ANY field in the form %WM/*% (see the extended attributes section of View File Info on any wma/wmv/asf file for examples).
Returns the full path of the file. To display the filename only, use the $filepart function..
Returns the track rating as an integer from 1 to 5, if set. To display as stars or another character, use the $repeat function. [Winamp 5.2+ Only]
For the fields listed below, info is taken from ML only if the file is present in the ML database and if the following option is checkmarked:
Prefs (Ctrl+P) > Media Library > Local Media > ‘Use Library title information for Playlist Item Formatting’
In all other cases, the info is provided by the input plugin (if the respective input plugin supports the field).
Most of these are straightforward and are taken from the standard file tags, and therefore don't require any additional explanatory notes.
Returns the TrackNumber with no padding, eg. Track 1 will be displayed as 1.
To pad with zeros, eg. 01, 02...10, 11, use the $num or $lpad function.
Returns length of the track in miliseconds. For a formatted track length, use: $div(%length%,60000):$num($div($mod(%length%,60000),1000),2)
The fields listed below may not work for all file formats.
Returns the Track Artist field (equivalent to Artist), if different to Album Artist. [Winamp 5.3+ Only]
Returns the Encoded/Tool (software used to rip/encode track) field, eg. Winamp 5.34. [Winamp 5.3+ Only]
Returns the filetype's Family, eg. M4A returns: MPEG-4 Audio File Format [Winamp 5.5+ Only]
Returns the ReplayGain Track Gain value (eg. -3.16 dB), if it exists. [Winamp 5.3+ Only]
Notes: Be careful about spaces after commas.
$if(%title%, Has A Title, Has No Title) will display “ Has A Title” (note leading space), not “Has A Title”.
The proper form should be $if(%title%,Has A Title,Has No Title).
If a contains at least one valid, non-empty field, then is evaluated and returned, otherwise the else parameter is. Note that $if(A,A,B) is equivalent to $if2(A,B)
If a contains a valid, non-empty field, a is evaluated and returned, otherwise the else parameter is.
If one of a1... aN contains a valid, non-empty field, the value is evaluated and returned, otherwise the else parameter is used.
cN or else. A switch/case function, which determines which bN parameter is equal to a and returns the corresponding cN parameter. If none are matched, it returns the final parameter else.
Winamp 5.2+ Only
Compares the integer numbers x1 and x2, if x1 is greater than x2, then is evaluated and its value returned. Otherwise the else part is evaluated and its value returned.
Winamp 5.2+ Only
Compares whether the length of string a1 is longer than x1 characters, if a1 is longer, the then part is evaluated and its value returned. Otherwise the else part is evaluated and its value returned.
Winamp 5.2+ Only
If A = B do then else do else
Winamp 5.2+ Only
remainder of a division of x1 by x2
Winamp 5.2+ Only
x1 / x2. Result of a division of x1 by x2
Winamp 5.2+ Only
x1 * x2 * ... * xn. The supplied numbers multiplied
Winamp 5.2+ Only
x1 * x2 / 3. x1 multiplied by x2, divided by x3. Result is rounded to nearest integer.
Winamp 5.2+ Only
x1 - x2 - ... - xn. The result of x2...xn subtracted from x1.
Winamp 5.2+ Only
x1 + x2 +...+ xn. The addition of all the numbers supplied
Winamp 5.2+ Only
1 if x1 is greater than x2, otherwise nothing. Similar in use to $ifgreater()
Winamp 5.2+ Only
The largest number in the arguments supplied
Winamp 5.2+ Only
a1 with all occurences of a2 replaced by a3
Winamp 5.2+ Only
the first x1 characters of a1
Winamp 5.2+ Only
the last x1 characters of a1
Winamp 5.2+ Only
the number of characters of a1
Winamp 5.2+ Only
index of first occurence of string a2 in a1
Winamp 5.2+ Only
index of last occurence of character a2 in a1
Winamp 5.2+ Only
index of first occurence of character a2 in a1
Winamp 5.2+ Only
index of first occurence of character a2 in a1
Winamp 5.2+ Only
a1 or a2 based on which has the shorter length.
a1 or a2 based on which has the greater length.
a1 abbreviated.
a1 padded with spaces or cut off, resulting in a string of x2 characters
a1, cut off after the x2th character
string padded to at least num chars, with spaces by default, or specify a character (or repeating string) as padstr.
string padded to at least num chars on the left, with spaces by default, or specify a character (or repeating string) as padstr.
Winamp 5.2+ Only
a1 without any leading or trailing spaces
Winamp 5.2+ Only
a1 repeated x1 times.
lower case of a1, with first letter of each word in upper case
a1, with first letter of each word in upper case
filename of a1 (i.e. without the leading path)
filename of a1 (i.e. without the leading path)
directory name of a1, after going up by x1 levels
Winamp 5.2+ Only
Splitting of disc and/or track strings, eg. to show "1" instead of "1/11"
Winamp 5.5+ Only
x1 formatted as hexidecimal to x2 number of digits, padded to the left with zeros.
Winamp 5.2+ Only
x1 zero padded to the left to form a x2 digit number.
Winamp 5.2+ Only
x1 zero padded to the left to form a x2 digit number.
Winamp 5.2+ Only
Nothing
Winamp 5.2+ Only
The first x1 levels of a1
Winamp 5.3+ Only
The last x1 levels of a1
Winamp 5.3+ Only
a1 minus the first x1 levels of a1
Winamp 5.3+ Only
a1 minus the last x1 levels of a1
Winamp 5.3+ Only
Stores value to the named variable name. It may be later retrieved using $get(name). Use $put() to store a value and also return the value with the one function.
Winamp 5.2+ Only
value. Stores value to the named variable name. It may be later retrieved using $get(name). Use $puts() to store a value without returning it.
Winamp 5.2+ Only
value of name variable previously set by a $put() or $puts() function
Winamp 5.2+ Only
TODO: a1
Winamp 5.2+ Only
TODO: a1
Winamp 5.2+ Only
TODO: a1
Winamp 5.2+ Only
TODO: a1
Winamp 5.2+ Only
TODO: a1
Winamp 5.2+ Only
[ .... ] - displays contents of brackets only if at least one of the fields referenced inside has been found.
Example: [%artist%-] will show: "artist-" only if the %artist% tag is populated, otherwise it will not show anything at all (including the hyphen and spaces).
Syntax: [%artist% - ][%album% - ][$num(%track%,2) - ]$if2(%title%,$filepart(%filename%))
Example: Pink Floyd - Animals - 02 - Dogs
Syntax:
$if2(%albumartist%,%artist%)-][%album%-][$num(%track%,2)-]
$IfStrNotEqual(%artist%,$if2(%albumartist%,%artist%),[%artist%-])
[$if2(%title%,$filepart(%filename%))][$if($fileext(%filename%),' [ ',)]
[%year% | ][$fileext(%filename%) ][$if(%bitrate%, '|' ,)][%bitrate% 'kbps' ]
[$if($fileext(%filename%),']',)][ $repeat(*,%rating%) ]
Returns: AlbumArtist -Album-##-Artist -Title [ Year | Ext | Bitrate ] StarRating
if AlbumArtist is different to TrackArtist, otherwise shows Standard format.
Example: Various - Arcana - 01 - Tripswitch - Calabi Yau [ 2006 | mp3 | 205 kb/s ] *****