Hydrogenaudio Knowledgebase - User contributions [en]

Monkey's Audio

2016-12-15T02:52:17Z

82.246.177.235: more precise category

=Introduction=
Monkey's Audio (APE) is a freeware [[lossless]] audio compression format with a highly competitive compression algorithm, and is used primarily by Windows users. Although software is available for Linux, Monkey's Audio is not as popular among this operating system's users. Monkey's Audio suffers from slow decompression speeds as compared to other lossless audio codecs.

Monkey's Audio uses a combination of traditional lossless compression tactics ([[linear prediction]] and [[channel coupling]]) and a simple [[Neural network]]. To store the output values of its prediction step it uses [[Range coding]], modified to work well with more or less continuous values.

Monkey's Audio's main competitor is [[FLAC]], which has more features than Monkey's Audio (streaming support, for example) and hardware support to its advantage, though its efficiency in compression is not as great.

Monkey's Audio is released under a "custom" license that allows you to do pretty much anything with the source code, on the provision that you ask the author for permission.

==Related Articles==
* [[Lossless_comparison|Lossless Codec Comparison]] by Rjamorim
* [[EAC_and_Monkeys_Audio | Configuring EAC and Monkey's Audio]]

==External links==
* [http://www.monkeysaudio.com/ Monkey's Audio: Homepage] Latest Version: 4.17 (June 8, 2016)
* <s> Monkey's Audio Package for BeOS </s>

[[Category:Lossless]]

Lossy

2016-12-15T02:48:21Z

82.246.177.235: sort at the top of :Category:Codecs

'''Lossy''' compression is a form of compression that significantly reduce multimedia file size by throwing away information imperceptible to humans.

Human audio perception is not perfect. Lossy compression takes advantage of this characteristic. By selective discarding, much unnecessary information is thrown away. The amount of information discarded is usually adjustable, giving a compromise between smaller size with less quality and larger size with higher quality.

The downside to this is that waveform reconstructed from compressed information will never exactly match the original waveform.

== Does Lossy Encoding Preserve Surround Information? ==
Depending on the encoder and settings, degradation of surround imaging may happen. Use higher [[bitrate]] to prevent this from happening. Mid/Side stereo of [[LAME]] or [[Advanced Audio Coding|AAC]] does not destroy surround information. Also [[Musepack|MPC]] preserves surround information with standard settings reasonably well. The lower the [[bitrate]], the worse you can expect the surround imaging become.

* [http://www.hydrogenaudio.org/forums/index.php?act=ST&f=15&t=4639 More discussion]

== List of common lossy formats ==
* [[Advanced Audio Coding]] (AAC, also improperly known as [[MP4]] or [[M4A]])
* [[AC3]]
* [[ATRAC3]]
* [[DTS]]
* [[MP2]]
* [[MP3]]
* [[Musepack]] (also known as MPC, formerly known as MPEGplus or MP+)
* [[Opus]]
* (Ogg) [[Vorbis]]
* [[QDesign]]
* [[Speex]] (speech only)
* [[VQF]]
* [[Windows Media Audio]] (WMA)

== See Also ==
* [[Choosing the best codec]]
* [[Lossless]]

[[Category:Codecs|*]]

Lossless

2016-12-15T02:48:14Z

82.246.177.235: sort at the top of :Category:Codecs

Compression is '''lossless''' when decoding the compressed data gives a result which is identical bit-by-bit to the uncompressed original.

Generic file compression formats, like ZIP or RAR, are lossless. However, trying to compress raw audio with those generally results in files which are only slightly- if at all- smaller than the originals. Lossless audio formats take advantage of knowledge about real-world audio data to provide compression ratios averaging around 50% on most music.

[[Lossy]] encoders only attempt to approximate the sound of the original waveform rather than preserving all the information present in it. Losslessly compressed audio will therefore unavoidably be larger than audio compressed with any reasonable [[lossy]] encoder. However, this disadvantage is offset by lossless files' ability to be [[transcoding|transcoded]] to other lossless formats without any quality degradation.

== Popular lossless formats ==
* [[Apple Lossless]] ([[ALAC]])
* [[Free Lossless Audio Codec]] (FLAC)
* [[Lossless Audio]] (LA)
* [[Lossless Predictive Audio Compression]] (LPAC)
* [[Meridian Lossless Packing]] (MLP)
* [[Monkey's Audio]] (APE)
* [[OptimFROG]]
* [[RK Audio]] (RKAU)
* [[Shorten]] (SHN)
* [[TAK]]
* [[TTA]]
* [[WavPack]]
* [[Windows Media Audio|WMA lossless]]

== Oddball Formats ==
There are several old lossless formats that aren't really deserving of having an article all for themselves. Reasons are: lack of widespread support, lack of features, bad efficiency and, most importantly, it seems no one is really interested in them.

Most of those would have disappeared by now, but they are being preserved for posterity at [[User:Rjamorim|rjamorim]]'s

* Advanced Digital Audio (ADA)
* Marian's a-Pac
* AudioZip
* Dakx WAV
* Entis Lab MIO
* LiteWave
* Pegasus SPS
* RKaudio
* Split2000
* Sonarc
* VocPack
* WavArc
* WaveZip/MUSICompress

Note that currently '''no single format can be considered best for all applications'''. Rather, the best format depends on the ''intended use'', as well as a number of other factors (such as licensing and file structure). For example, Shorten and FLAC are widely used for sharing live music because of their cross-platform support and speed. Monkey's Audio is popular among Windows users for its superior compression ratio.

== Comparisons ==
''Note the specific assumptions and limitations of each comparison; in particular, results are sensitive to the music selected'''

; [[Lossless comparison]] : A comparision focusing more on codec features and less on absolute encoding efficiency. Also features a table comparing most popular codecs based on their features.

* Lossless audio formats [http://www.bobulous.org.uk/misc/lossless_audio_2006.html here] - A comparison of the rip-and-encode speed and album file size of six different lossless formats: [[WAV|uncompressed Wave]], [[FLAC]], [[WavPack]], [[SHN|Shorten]], [[APE|Monkey's Audio]], and [[OptimFROG]]. First published on 22nd May 2006.

[[Category:Codecs|*]]

Template:Codec Infobox

2016-12-15T02:36:22Z

82.246.177.235: :Category:Lossless codecs and :Category:Lossy codecs have been removed

{| align="right" style="padding-left: 15px;"
|
{| cellspacing="5" style="width: 24em; font-size: 90%; text-align: left; border:1px solid; background: rgb(250,250,255);"
|+ style="font-size: 130%; font-weight: bold;" | {{{name}}}
|-
! colspan="2" style="text-align:center; font-size: 80%; font-weight: normal;" | {{{logo}}}
|-
! colspan="2" style="text-align:center; font-size: 80%; font-weight: normal;" | {{{purpose}}}
|- style="text-align:left; font-weight:bold;"
| Type: || [[{{{type}}}]]
|- style="text-align:left; font-weight:bold;"
| Developer: || {{{maintainer}}}
|- style="text-align:left; font-weight:bold;"
| Recommended encoder: || [[{{{recommended_encoder}}}|{{{recommended_text|{{{recommended_encoder}}}}}}]]
|- style="text-align:left; font-weight:bold;"
| Website: || {{{website}}}
|}
|}<noinclude>
== Usage ==
{| style="background: transparent;"
|<pre>{{Codec Infobox
| name =
| logo =
| type =
| purpose =
| maintainer =
| recommended_encoder =
| recommended_text =
| website =
}}
</pre>
|}

* '''website''' field: If the URL is too long, enclose it in the WikiLink syntax, i.e. '''<code><nowiki>[</nowiki><font style="color:#ccccff;"><nowiki>http://www.somewhere.net/</nowiki></font> Click Here]</code>'''.
* '''type''' field: Either "Lossy" or "Lossless"
* '''recommended_text''' field: optional, display name for recommended codec
</noinclude>

Vorbis Comment

2016-12-03T10:26:28Z

82.246.177.235: add "DATE" because this one is important to keep in mind, it has to be used instead of "YEAR"

{{stub}}

'''Vorbis Comment''' is a [[metadata]] format, similar to [[ID3]] and [[APE tags]], specified by Xiph.org for use with (Ogg) [[Vorbis]] and [[Free Lossless Audio Codec|FLAC]].

It is a relatively simple format that allows the user to specify arbitrary fieldname/value pairs, using '''UTF-8''' Unicode as the character encoding.

To avoid incompatibilities between tags some standard fieldnames are suggested by the Vorbis Comment specification (TITLE, VERSION, ALBUM, ARTIST, TRACKNUMBER, DATE, etc.). Every fieldname is allowed and there is no obligatory format for values. One Fieldnames can be used several times. In contrast to [[ID3]] it is a it's quite free of regulations.

Several unofficial efforts have been made as proposals and recommendations for Vorbis Comment specification. These documents are available on Web, first one is called [http://web.archive.org/web/20040401200215/reactor-core.org/ogg-tag-recommendations.html Ogg Vorbis Comment Field Recommendations] and second one is called:[http://web.archive.org/web/20101021085402/http://reallylongword.org/vorbiscomment/ Proposals for extending Ogg Vorbis comments].

== Used by ==
* (Ogg) [[Vorbis]]
* [[Free Lossless Audio Codec]] (FLAC)
* [[Speex]]

== External links ==
* [http://www.xiph.org/vorbis/doc/v-comment.html official specifications]

[[Category:Metadata]]

WavPack

2016-12-03T02:56:31Z

82.246.177.235: /* History */ "recently"

{{Software Infobox
| name = WavPack
| logo = [[Image:Wavpacklogo.png|280px|Official WavPack logo]]
| screenshot =
| caption = Hybrid Lossless Audio Compression
| maintainer = David Bryant
| stable_release = 4.80.0 (28. March 2016)
| preview_release = [https://hydrogenaud.io/index.php/topic,111822.0.html 5.0.0] (4. May 2016)
| operating_system = Windows, Mac OS/X, Linux/BSD/Unix
| use = Encoder/Decoder
| license = BSD license
| website = http://www.wavpack.com/
}}

'''WavPack''' is a royalty-free, open source and [[lossless]] or high-quality lossy (in "hybrid" mode) audio compression format developed by David Bryant.

== Description ==
WavPack (pronounced "wave-pack") allows users to compress (and restore) all [[PCM]] audio formats including 8, 16, and 24-bit ints; 32-bit floats; [[mono]], [[stereo]], and [[multichannel]]; [[sampling rate]]s from 6 to 192 kHz. Like other lossless compression schemes the data reduction varies with the source, but it is generally between 25 % and 50 % for typical popular music and somewhat better than that for classical music and other sources with greater dynamic range.

WavPack also incorporates a unique "hybrid" mode that provides all the advantages of lossless compression with an additional bonus. Instead of creating a single file, this mode creates both a relatively small, high-quality lossy file that can be used all by itself, and a "correction" file that (when combined with the lossy file) provides full lossless restoration. For some users this means never having to choose between lossless and lossy compression!

== Feature Summary ==
* Fast and efficient encoding and decoding
* [[Open source]], released under a BSDish license
* Multiplatform
* Hardware support
* Error robustness
* Streaming support
* Supports multichannel audio and high resolutions
* Hybrid/lossy mode
* Tagging support ([[ID3v1]], [[APE tags]])
* Supports [[RIFF]] chunks
* Supports embedded CUE sheets
* Includes MD5 hashes for quick integrity checking
* Ability to create self extracting files for Win32 platform
* [[ReplayGain]] compatible

== History ==
David Bryant started development on WavPack in mid-1998, with the release of version 1.0. This first version compressed and decompressed audio losslessly, nothing else, but by then it already featured one of the best efficiency versus speed ratio among lossless encoders.

Very soon after the release of version 1.0, Bryant released v. 2.0, which featured lossy encoding (using only quantization for data reduction – no psychoacoustic process was applied to the stream).

In 1999, the developer released version 3.0, which featured novelties such as a fast mode (with reduced compression ratio), compression of RAW files and error detection using CRC checksums.

WavPack development is still going on, and a major feature added in late 3.x versions is the hybrid mode, where the encoder generates a lossy file + a correction file, so that both can be decompressed back to the original PCM stream.

WavPack 4 has been released in 2004. It included important changes, such as fast seeking, multichannel support, high resolution audio support, etc. turning it into one of the most full featured and modern lossless audio compressors.

== Software support ==
=== Players ===
* NullSoft [[Winamp]] (plugin with ReplayGain & Media Library support) and Winamp-compatible players
* [[foobar2000]] Advanced Audio Player (official encoding/decoding addon, with ReplayGain & Cuesheets support)
* [http://www.vuplayer.com/vuplayer.php VUPlayer] (official plugin, supports encoding)
* [[Windows Media Player]] and other directshow-based players (MPC, TCMP, RadLight) (with [http://www.hydrogenaudio.org/forums/index.php?showtopic=103693 CoreWavPack] directshow filter)
* [http://www.un4seen.com/xmplay.html XMplay] (official plugin)
* [http://cogosx.sourceforge.net/ Cog] Audio player for MacOS X.
* [[XMMS]] (with Kuniklo's plugin)
* [http://fondriest.frederic.free.fr/realisations/lamip/ LAMIP] (official plugin)
* [http://mpxplay.sourceforge.net/ MPXplay] for DOS!
* [http://aqualung.sourceforge.net/ Aqualung] for GNU/Linux
* [http://www.videolan.org/vlc/download-windows.html VLC Player]
* Cowon [http://www.jetaudio.com/ JetAudio Player]

=== Frontends ===
* Custom Windows [http://www.wavpack.com/WavPack_frontend.zip WavPack frontend] (by Speekenbrink)

=== Converters ===
'''Note:''' ''Several players, like Cowon JetAudio, foobar2000 and VUplayer, can also convert from other formats to WavPack!''

* [http://www.dbpoweramp.com/ dBpowerAMP] Music Converter / Audio Player / CD Writer (official addon)
* [http://www.easeaudioconverter.com/wavpack.htm Ease Audio Converter] (Shareware / NOT Freeware)
* [http://media.io/ Online Audio Converter]

=== Editors ===
* [[Adobe Audition]] and Cool Edit (filter with 32-bit floats & extra info save support)

=== CD writers/rippers ===
* [http://www.nero.com/eng/ Nero]
* [[Exact Audio Copy]] CD Ripper
* [http://cdexos.sourceforge.net CDex] CD ripper
* Cowon [http://www.jetaudio.com/ JetAudio Player]

=== Taggers ===
* [http://www.mp3tag.de/en/index.html Mp3tag] Universal Tag Editor
* [http://www.jtclipper.eu/thegodfather/ The GodFather] Tagger / Music manager
* [[Tag.exe|Case's Tag]] command line tagger

=== Other tools ===
* [http://mr-questionman.en.uptodown.com/windows Mr. QuestionMan]
* [http://www.bunkus.org/videotools/mkvtoolnix/ mkvtoolnix] – tool to multiplex WavPack streams inside the Matroska container
''It's worth mentioning the [[Matroska]] guys decided to concentrate on WavPack as the lossless compressor of choice for their container. Quite an honor... :-)''

->[http://www.wavpack.com/#Software WavPack Software Section]

== Hardware Support ==
* iRiver iHP-120/iHP-140 with the open source [http://www.rockbox.org Rockbox firmware]
* Roku PhotoBridge HD (with [http://www.wavpack.com/downloads.html#binaries plugin])
->[http://www.wavpack.com/index.html#Hardware WavPack Hardware Section]

== Technology description ==
To ensure high-speed operation, WavPack uses a very simple predictor that is implemented entirely in integer math. In its "fast" mode the prediction is simply the arithmetic extrapolation of the previous two samples. For example, if the previous two samples were -10 and 20, then the prediction would be 50. For the default mode a simple adaptive factor is added to weigh the influence of the earlier sample on the prediction. In our example the resulting prediction could then vary between 20 for no influence to 50 for full influence. This weight factor is constantly updated based on the audio data's changing spectral characteristics, which is why it is called "adaptive".

The prediction generated is then subtracted from the actual sample to be encoded to generate the error value. In mono mode this value is sent directly to the coder. However, stereo signals tend to have some correlation between the two channels that can be further exploited. Therefore, two error values are calculated that represent the difference and average of the left and right error values. In the "fast" mode of operation these two new values are simply sent to the coder instead of the left and right values. In the default mode, the difference value is always sent to the coder along with one of the other three values (average, left, or right). An adaptive algorithm continuously determines the most efficient of the three to send based on the changing balance of the channels.

The developer has developed a unique data encoder for WavPack that he believes is better than Rice coding in two different areas. It is impossible to encode more efficiently than Rice coding because it represents the optimal bit coding (sometimes known as the Huffman code) for this type of data. WavPack's encoder is slightly less efficient than this, but only by about 0.15 bits/sample (or less than 1% for 16-bit data). The first advantage of WavPack's coder is that it does not require the data to be buffered ahead of encoding, instead it converts each sample directly to bitcodes. This is more computationally efficient and it is better in some applications where coding delay is critical. The second advantage is that it is easily adaptable to lossy encoding because all significant bits (except the implied "one" MSB) are transmitted directly. In this way it is possible to only transmit, for example, the 3 most significant bits (with sign) of each sample. In fact, it is possible to transmit only the sign and implied MSB for each sample with an average of only 3.65 bits/sample.

This coding scheme is used to implement the "lossy" mode of WavPack. In the "fast" mode the output of the non-adaptive decorrelator is simply rounded to the nearest codable value for the specified number of bits. In the default mode the adaptive decorrelator is used (which reduces the average noise about 1 dB) and also both the current and the next sample are considered in choosing the better of the two available codes (which reduces noise another 1 dB).

The developer has decided to not use any floating-point arithmetic in WavPack's data path because he believes that integer operations are less susceptible to subtle chip to chip variations that could corrupt the lossless nature of the compression, the Pentium floating point bug being a blatant example of this. It is possible that a lossless compressor that used floating-point math could generate different output when running on that faulty Pentium. Even disregarding actual bugs, floating-point math is complicated enough that there could be subtle differences between "correct" implementations that could cause trouble for this type of application. To further ensure confidence in the integrity of WavPack's compression, the encoder includes a 32-bit error detection code to the generated streams.

WavPack source code is very portable. It has been compiled on several Unices (Linux, Mac OS X, Solaris, FreeBSD, OpenBSD, NetBSD, Compaq Tru64, HP-UX...) as well as Windows, DOS and OpenVMS. It works on architectures such as x86, ARM, PowerPC, SPARC, DEC Alpha, PA-RISC, MIPS, Motorola 68k...

== External links ==
* [http://www.wavpack.com/ Official website]
* [http://www.rarewares.org/lossless.html Unofficial multiplatform versions] at RareWares
* [[Lossless_comparison|Lossless Codec Comparison]]
* [[EAC_and_WavPack | Configuring EAC and WavPack]]

[[Category:Codecs]]
[[Category:Lossless]]

Foobar2000:Title Formatting Reference

2016-09-29T20:27:09Z

82.246.177.235: /* String functions */ fix sorting of $substr()

{{fb2k}}
This article contains information about built-in title formatting functions and field references, plus additional documentation about fields and functions which can only be used in specific components or which are provided by specific components.

Please see [[Foobar2000:Title Formatting Introduction|Title Formatting Introduction]] for a general overview of title format syntax and its basic rules. The article [[foobar2000:Titleformat Examples|Titleformat Examples]] offers user-submitted examples of code for specific purposes; feel free to add your own if you think it can be of use to others.

For details of the query syntax, which uses some of these fields to find files for playlists, etc., see the [[Foobar2000:Query_syntax|Query Syntax]] article.

== Syntax ==

A title formatting script consists of any combination of literal text, field references, function calls, comments, and line break characters. The script always outputs a text string (which can be empty).

A '''comment''' is a line starting with two slashes, e.g. ''// this is a comment''.

A '''field reference''' is a field name enclosed in percent signs, for example ''%artist%''.

A '''function call''' starts with a dollar sign, followed by the function name and the parameter list. A parameter list can either be empty—denoted as ''()''—or contain one or more parameters separated by commas, for example ''$abbr(%artist%)''. A parameter can be literal text, a field reference, or another function call. Note that there must be no whitespace between the dollar sign and the function name, or the function name and the opening parenthesis of the parameter list.

Any other text is '''literal text'''. In literal text, the character ''%'', ''$'', ''['', '']'', or ''''' (apostrophe/single quote) must be escaped by enclosing it in ''''' (apostrophe/single quote) characters. For example, '''[''' (a left bracket in single quotes) results in a literal ''['' (left bracket). As a special case, '''''' (two single quotes in a row) results in one single quote. In the playlist, ''<'' and ''>'' are also special; see [[#Dimmed and highlighted text]].

When the script is evaluated, the output string is assembled by evaluating the function parameters, function calls, and field references. Comments and line break characters (CR and LF/newline) are ignored; to output a line break, use ''$crlf()''. Each field reference becomes the field's value, as a string. Each function becomes a string or number, and/or a truth value (not output) which can be used by another function.

'''Note: the interface for entering custom columns and grouping schemes for the Default UI playlist does not support line breaks; scripts must be written all on one line, without comments.'''

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string that can be interpreted as number. Leading whitespace is ignored. Decimal points are not supported. Examples:
* ''c3po'' → 0
* ''4.8'' → 4
* ''-12'' → -12
* ''- 12'' → 0

=== $add(a,b, ...) ===

Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.

=== $div(a,b) ===

Divides ''a'' by ''b'' and rounds down to an integer. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.

=== $greater(a,b) ===

Returns true, if ''a'' is greater than ''b'', otherwise false.

=== $max(a,b) ===

Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.

=== $min(a,b) ===

Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.

=== $mod(a,b) ===

Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.

=== $mul(a,b) ===

Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.

=== $muldiv(a,b,c) ===

Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.

=== $rand() ===

Generates a random number in the range from 0 to 2<sup>32</sup>-1. Available only in sort-related contexts, such as the ''Edit → Sort → Sort by ...'' menu command.

=== $sub(a,b) ===

Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.

== Boolean functions ==

The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.

=== $and(...) ===

Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.

=== $or(...) ===

Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.

=== $not(x) ===

Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.

=== $xor(...) ===

Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.

== Control flow functions ==

The functions in this section can be used to conditionally execute statements.

=== [...] (conditional section) ===

Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''artist'' would return "?".

=== $if(cond,then) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.

=== $if(cond,then,else) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.

=== $if2(expr,else) ===

Like ''$if(expr,expr,else)'' except that ''expr'' is only evaluated once. In other words, if expression ''expr'' is true, ''expr'' is returned, otherwise the ''else'' part is evaluated and its value returned.

=== $if3(a1,a2,...,aN,else) ===

Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifequal(int1,int2,then,else) ===

Compares the integer numbers ''int1'' and ''int2'', if ''int1'' is equal to ''int2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifgreater(int1,int2,then,else) ===

Compares the integer numbers ''int1'' and ''int2'', if ''int1'' is greater than ''int2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $iflonger(str,n,then,else) ===

Compares the length of the string ''str'' to the number ''n'', if ''str'' is longer than ''n'' characters, the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $select(n,a1,...,aN) ===

If the value of ''n'' is between 1 and N, ''aN'' is evaluated and its value returned. Otherwise ''false'' is returned.

== String functions ==

The functions in this section can be used to manipulate character strings.

=== $abbr(str) ===

Returns abbreviation of string ''str''. Words which begin with an alphanumeric character are shortened to the first character. Spaces and parentheses are stripped. Example:
* $abbr('This is a Long Title (12-inch version) [needs tags]') → TiaLT1v[needst

=== $abbr(x,len) ===

Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.

=== $ansi(str) ===

Converts string ''str'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.

=== $ascii(str) ===

Converts string ''str'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.

=== $caps(str) ===

Converts first letter in every word of string ''str'' to uppercase, and all other letters to lowercase.

=== $caps2(str) ===

Converts first letter in every word of string ''str'' to uppercase, and leaves all other letters as they are.

=== $char(x) ===

Returns Unicode character of ''x''. You can search for characters and find the matching decimal number on this [http://www.fileformat.info/info/unicode/char/search.htm site].

=== $crc32(str) ===

Computes the CRC32 of the string ''str'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)

=== $crlf() ===

Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.

=== $cut(str,len) ===

Returns first ''len'' characters from the left of the string ''str''. This function is the same as $left(a,len). Negative numbers produce the entire string. Examples:
* ''$cut('abc123',3)'' → abc
* ''$cut('abc123',0)'' → (nothing)
* ''$cut('abc123',-1)'' → abc123

=== $directory(path) ===

Extracts directory name from the file ''path''.

=== $directory(path,n) ===

Extracts directory name from the file ''path''; goes up by ''n'' levels.

=== $directory_path(path) ===

Extracts directory path from the file ''path''.

=== $ext(path) ===

Extracts file extension from string ''path''; a file name or full path.

=== $filename(path) ===

Extracts file name from full ''path''.

=== $fix_eol(str) ===

If ''str'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''str'' is returned unaltered.

=== $fix_eol(str,indicator) ===

If ''str'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''str'' is returned unaltered.

=== $hex(int) ===

Formats the integer number ''int'' in hexadecimal notation.

=== $hex(int,len) ===

Formats the integer number ''int'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $insert(str,insert,n) ===

Inserts ''insert'' into ''str'' after ''n'' characters.

=== $left(str,len) ===

Returns first ''len'' characters from the left of the string ''str''. This function is the same as $cut(str,len). Negative numbers produce the entire string. Examples:
* ''$left('abc123',3)'' → abc
* ''$left('abc123',0)'' → (nothing)
* ''$left('abc123',-1)'' → abc123

=== $len(str) ===

Returns length of string ''str'' in characters.

=== $len2(str) ===

Returns length of string ''str'' in characters, respecting double-width character rules (double-width characters will be counted as two).

=== $longer(str1,str2) ===

Returns ''true'', if string ''str1'' is longer than string ''str2'', false otherwise.

=== $lower(str) ===

Converts string ''str'' to lowercase.

=== $longest(arg,...) ===

Returns the longest of its arguments. Can be used with an arbitrary number of strings.

=== $num(int,len) ===

Formats the integer number ''int'' in decimal notation with ''len'' characters. Pads with zeros from the left if necessary. ''len'' includes the dash when the number is negative. If ''n'' is not numeric, it is treated as zero. Examples:

* ''$num(123,5)'' → 00123
* ''$num(-123,5)'' → -0123
* ''$num(4.8,5)'' → 00004
* ''$num(A1,5)'' → 00000

=== $pad(str,len) ===

Creates a left-aligned version of the string ''str''. If ''x'' is shorter than ''len'' characters, the function adds spaces to the right of ''str'' to make the result ''len'' characters long. Otherwise the function returns ''str'' unchanged.

=== $pad_right(str,len) ===

Creates a right-aligned version of the string ''str''. If ''str'' is shorter than ''len'' characters, the function adds spaces to the left of ''str'' to make the result ''len'' characters long. Otherwise the function returns ''str'' unchanged.

=== $pad(str,len,char) ===

Creates a left-aligned version of the string ''str''. If ''str'' is shorter than ''len'' characters, the function adds ''char'' to the right of ''str'' to make the result ''len'' characters long. Otherwise the function returns ''str'' unchanged.

=== $pad_right(str,len,char) ===

Creates a right-aligned version of the string ''str''. If ''str'' is shorter than ''len'' characters, the function adds ''char'' to the left of ''str'' to make the result ''len'' characters long. Otherwise the function returns ''str'' unchanged.

=== $padcut(str,len) ===

Returns first ''len'' characters from the left of ''str'', if ''str'' is longer than ''len'' characters. Otherwise adds spaces to the right of ''str'' to make the result ''len'' characters long.

=== $padcut_right(str,len) ===

Returns first ''len'' characters from the left of ''str'', if ''str'' is longer than ''len'' characters. Otherwise adds spaces to the left of ''str'' to make the result ''len'' characters long.

=== $progress(pos,range,len,char1,char2) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''char1'' and ''char2'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.

=== $progress2(pos,range,len,char1,char2) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''char1'' and ''char2'' are characters to build progress bar with. Produces different appearance than ''$progress''.

=== $repeat(expr,count) ===

Returns ''count'' copies of ''expr''. Note that ''expr'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.

=== $replace(str,search,replace) ===

Replaces all occurrences of string ''search'' in string ''str'' with string ''replace''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(str,search1,replace1,search2,replace2)'' is generally not the same as ''$replace($replace(srt,search1,replace1),search2,replace2)''.

Example: ''$replace(ab,a,b,b,c)'' → "bc", ''$replace($replace(ab,a,b),b,c)'' → "cc"

=== $right(str,len) ===

Returns the first ''len'' characters from the right of string ''str''.

=== $roman(int) ===

Formats the integer number ''int'' in roman notation.

=== $rot13() ===

Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' → "sbbone2000".

=== $shortest(str,...strN) ===

Returns the first shortest element of its arguments. Can be used with an arbitrary number of strings.

=== $strchr(str,char) ===

Finds first occurence of character ''char'' in string ''str''.

Example: ''$strchr(abca,a)'' → 1

=== $strrchr(str,char) ===

Finds last occurence of character ''char'' in string ''str''.

Example: ''$strrchr(abca,a)'' → 4

=== $strstr(str1,str2) ===

Finds first occurence of string ''str2'' in string ''srt1''.

=== $strcmp(str1,str2) ===

Performs a case-sensitive comparison of the strings ''str1'' and ''srt2''.

=== $stricmp(str1,str2) ===

Performs a case-insensitive comparison of the strings ''str1'' and ''str2''.

=== $stripprefix(str) ===

Removes ''A'' and ''The'' prefixes from string ''str''.

=== $stripprefix(str,prefix1,prefix2,...) ===

Removes the specified prefixes from string ''str''.

=== $substr(str,from,to) ===

Returns substring of string ''str'', starting from ''FROM''-th character and ending at ''TO''-th character.

=== $swapprefix(str) ===

Moves ''A'' and ''The'' prefixes to the end of string ''str''.

=== $swapprefix(str,prefix1,prefix2,...) ===

Moves the specified prefixes to the end of string ''str''.

=== $trim(str) ===

Removes leading and trailing spaces from string ''str''.

=== $tab() ===

Inserts one tabulator character.

=== $tab(count) ===

Inserts ''count'' tabulator characters.

=== $upper(str) ===

Converts string ''str'' to uppercase.

== Track info fields and functions ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata fields and functions ===

Generally, metadata from the files (whether in tags or a cue sheet) is mapped directly to a field which can be referenced case-insensitively. For example, the first tag named ''URL'' can be referenced as ''%url%'', and the first standard comment tag can be referenced as ''%comment%''.

The following functions are also available for accessing metadata:

==== $meta(name) ====
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' → "He, She, It"

==== $meta(name,n) ====
Returns value of ''n''-th (0,1,2 and so on) tag called ''name''.

Example: ''$meta(artist,1)'' → "She"

==== $meta_sep(name,sep) ====
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' → "He + She + It"

==== $meta_sep(name,sep,lastsep) ====
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$meta_sep(artist,', ',', and ')'' → "He, She, and It"

==== $meta_test(...) ====
Returns ''1'', if all given tags exist, ''undefined'' otherwise.

Example: ''$meta_test(artist,title)'' → true

==== $meta_num(name) ====
Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' → 3

=== 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: <code>%_filesize%</code>

==== %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: <code>%_time_total%</code>

==== %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: <code>%_time_total_seconds%</code>

==== %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.

{| border="0" cellspacing="0" cellpadding="2"
! field name
! Description
|-
| colspan="2" style="background-color:#CCF"|'''General'''
|-
|codec
| style="background-color:#EEF"|'''Codec''' (''e.g.'' MP3)
|-
|codec_profile
| style="background-color:#EEF"|'''Codec Profile''' (''e.g.'' CBR)
|-
|samplerate
| style="background-color:#EEF"|'''Sample Rate''', in hertz (''e.g.'' 44100)
|-
|bitrate
| style="background-color:#EEF"|'''Bitrate''', in kilobits per second (''e.g.'' 320)
|-
|tool
| style="background-color:#EEF"|'''Tool''' used to produce the file, possibly guessed (''e.g.'' LAME3.97)
|-
|encoding
| style="background-color:#EEF"|'''Encoding''' lossiness (''e.g.'' lossy)
|-
|channels
| style="background-color:#EEF"|'''Channels''' count (''e.g.'' 2 <nowiki>[for stereo]</nowiki>)
|-
|channel_mode
| style="background-color:#EEF"|'''Channel Mode''', description of channels (''e.g.'' 3 front, 2 rear surround channels + LFE)
|-
|__bitspersample
| style="background-color:#EEF"|'''Bits Per Sample''' (''e.g.'' 16)
|-
|tagtype
| style="background-color:#EEF"|'''Tag Type''', comma-separated list of tag formats (''e.g.'' id3v2|apev2)
|-
|cue_embedded
| style="background-color:#EEF"|'''Embedded Cuesheet''' presence (''e.g.'' no <nowiki>[may be empty!]</nowiki>)
|-
|md5
| style="background-color:#EEF"|'''Audio MD5''' hash, if container defines it (''e.g.'' 1E24A910D91EF09A8CF403C9B6963961)
|-
| colspan="2" style="background-color:#CCF"|'''Other'''
|-
|ENC_DELAY
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_delay''' value for gapless playback (''e.g.'' 576)
|-
|ENC_PADDING
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_padding''' value for gapless playback (''e.g.'' 1536)
|-
|MP3_ACCURATE_LENGTH
| style="background-color:#EEF"|MP3 duration (%length% etc.) takes into account LAME or iTunes gapless playback info (''e.g.'' yes)*
|-
|MP3_STEREO_MODE
| style="background-color:#EEF"|Stereo mode used in MP3 file (''e.g.'' mono, stereo, joint stereo, etc.)
|-
|VERSION
| style="background-color:#EEF"|'''Version''' of tool (''e.g.'' 3.99)
|-
|FLAGS
| style="background-color:#EEF"|'''Flags''' of tool (''e.g.'' 22)
|}

<div style="font-size: 90%"><nowiki>*</nowiki> ''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.''</div>

==== $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_track_gain% ====
The ReplayGain track gain value.

==== %replaygain_track_peak% ====
The ReplayGain track peak value.

=== 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.

==== %_foobar2000_version% ====
A string representing the version of foobar2000.

== Time and date functions ==

These functions are used to manipulate time/date strings, notably (but not limited to), [[Foobar2000:Titleformat_Playback_Statistics|those gathered]] by the [[Foobar2000:Components/Playback Statistics v3.x (foo playcount)|Playback Statistics component]].

=== $year(time) ===
Retrieves the year part (formatted as four digits) from a time/date string.

=== $month(time) ===
Retrieves the month part (formatted as two digits) from a time/date string.

=== $day_of_month(time) ===
Retrieves the day of month part (formatted as two digits) from a time/date string.

=== $date(time) ===
Retrieves the date part (formatted as YYYY-MM-DD) from a time/date string.

=== $time(time) ===
Retrieves the time part (formatted as HH:MM:SS or HH:MM) from a date/time string.

== Variable operations ==

Variables can be used to store strings and numbers. They cannot store truth values. They are best used to store intermediate results that you need multiple times. Variable names are not case-sensitive.

For example:
{| border="0" cellspacing="0" cellpadding="2"
! code
! output
|-
|<pre>$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)</pre>
| style="background-color:#EEF" |<pre>bar
bar
bar

2000</pre>
|}

=== $get(name) ===
Returns the value that was last stored in the variable ''name'', if the variable was not defined (yet), it returns nothing. The truth value returned by ''$get'' indicates if the variable ''name'' was defined.

=== $put(name,value) ===
Stores ''value'' in the variable ''name'' and returns ''value'' unaltered.

=== $puts(name,value) ===
Stores ''value'' in the variable ''name'' and returns nothing.

== Component-specific fields and functions ==

This section lists fields and functions which are specific to certain components. Unless otherwise stated, the fields and functions are only usable in the context of those components.

=== Now playing info ===

The following fields related to the currently playing item are only usable in certain locations outside of the playlist, e.g. in the status bar, the main window title and the copy command script.

==== %playback_time% ====
The elapsed time formatted as [HH:]MM:SS.

==== %playback_time_seconds% ====
The elapsed time in seconds.
Old version: <code>%_time_elapsed%</code>

==== %playback_time_remaining% ====
The time remaining until the track ends, formatted as [HH:]MM:SS.
Old version: <code>%_time_remaining%</code>

==== %playback_time_remaining_seconds% ====
The time remaining until the track ends, in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== Playlist-only fields ===

The following fields are only usable in playlist display formatting (i.e., the column title formatting patterns).

==== %isplaying% ====
"1" if file is currently playing, empty string otherwise.

==== %ispaused% ====
"1" if playback is paused, empty string otherwise.

==== %list_index% ====
A zero-padded playlist index of specified item. The first item is at index 1.

==== %list_total% ====
The number of items in the playlist.

==== %queue_index% ====
Index of the specified item in the playback queue. If the item has been queued multiple times, %queue_index% evaluates to the first index.

==== %queue_indexes% ====
List of indexes of the specified item in the playback queue. Same as %queue_index% unless the item has been queued more than once.

==== %queue_total% ====
Total amount of tracks in playback queue. Available only for queued tracks, for technical reasons.

=== Playlist text color ===

==== Dimmed and highlighted text ====

In the Default UI playlist, text color can be adjusted by enclosing it in angle-brackets. The only options are to make the text dimmer (mixing the default color with black) or brighter (mixing the default color with the highlight color):

* ''<text>'' – dim ''text''
* ''<<text>>'' – dimmer ''text''
* ''<<<text>>>'' – dimmest ''text''
* ''>text<'' – bright ''text''
* ''>>text<<'' – brighter ''text''
* ''>>>text<<<'' – brightest ''text''

==== Historical and Columns UI color functions ====

Prior to version 1.0, the default UI playlist supported the following color functions, which are still available in the Columns UI playlist:

===== $blend(color1,color2,part,total) =====
Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.

===== $hsl() =====
Resets the text color to the default color.

===== $hsl(h,s,l) =====
Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.

===== $hsl(h1,s1,l1,h2,s2,l2) =====
Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.

===== $rgb() =====
Resets the text color to the default color.

===== $rgb(r,g,b) =====
Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.

===== $rgb(r1,g1,b1,r2,g2,b2) =====
Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.

===== $transition(string,color1,color2) =====
Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.

=== Album List ===

* [[Foobar2000:Titleformat_Album_List|Album List Title Formatting]]
* [[Foobar2000:Preferences:Album List|Preferences: Album List]]

=== Playback Statistics ===

The foo_playcount component adds a number of fields for playback statistics and ratings. The fields can be used anywhere track info can be displayed. See the documentation for details:
* [http://www.foobar2000.org/components/view/foo_playcount Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

=== Playlist Organizer ===

This component adds a number of fields to control the display of a list of playlists. See the documentation for details:
* [[Foobar2000:Components/Playlist Organizer (foo_plorg)#Nodes|Playlist Organizer: Nodes Title Formatting]]

=== Columns UI ===

This component replaces the Default UI framework, including the playlist. See the documentation for details:
* [http://yuo.be/columns.php Columns UI homepage]
* [http://yuo.be/wiki/columns_ui:config:global_variables Global variables reference]
* [http://yuo.be/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://yuo.be/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

== Additional Reading ==

* [[Foobar2000:Title Formatting Introduction|Introduction to titleformat scripts]]
* The file '''titleformat_help.html''' in your Foobar2000 directory, e.g. file:///C:/Program%20Files%20(x86)/foobar2000/titleformat_help.html

[[Category:foobar2000 Guides|Titleformat Reference]]