Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Components/Columns UI (foo ui columns)

2024-09-15T20:12:55Z

Musicmusic: Remove out-of-date information about libpng and zlib

{{Foobar Component Infobox
| name = Columns UI
| screenshot = [[Image:Foobar2000-ColumnsUI.png|250px]]
| caption = Columns User Interface
| module_name = foo_ui_columns
| developer = Reupen Shah (musicmusic)
| repository = [https://github.com/reupen/columns_ui GitHub]
| released = {{start date and age|2004|01|21}}
| released_ref =
| stable_release = 2.1.0
| stable_release_date = 2023-09-30
| preview_release =
| preview_release_date =
| foobar2000_minimum = 1.6
| foobar2000_ui_module =
| use = UI
| license = LGPLv3<ref>[https://github.com/reupen/columns_ui/blob/master/README.md columns_ui/README.md at master · reupen/columns_ui], accessed 2015-06-28</ref>
}}
'''Columns UI''' is a interface style important to [[foobar2000]]. It has its own plugin system and these plugins extend the user interface, used to customize the layout of foobar with few limitations.

It includes the following features:

* Columns in the default view of the playlist.
* Built-in volume control toolbar.
* Interchangeable elements through the use of panel and toolbar components.

==Layout==
The definite most important aspect of Columns UI! Each item that is added is hereforth refered to as an '''object'''.

===Presets===
'''Presets''' are used to change into a different type of layout. For example, a user might have one layout to choose songs from a playlist, one to change the actual playlist, and another to watch the lyrics. Maybe I will upload an image later.

===Objects===
====Layout====
The only existing layout option is Tabbed Panel Stack Mod, used for foo_uie_tabs. Tabs in this case function the same way they do in Firefox, and each tab corresponds to a different layout. In order to set that layout, '''each child object is a new tab'''.

====Panels====
Panels are the most important thing you will use. Think blocks, you can stack them, place them next to each other, and set them up however you like.

The best examples are Album Art Panel and Track Info.

====Playlist Views====
*Default Playlist
*Columns Playlist

====Splitters====
'''Splitters''' are used to place more than one object inside any given place.

|- Horizontal Splitter
|--- Panel A
|--- Panel B

Makes A to the left of B

|- Vertical Splitter
|--- Panel A
|--- Panel B

Makes A on top of B

Playlist Tabs places whatever child object contained inside a group of tabs. Those tabs are always the loaded playlists used by the player.

====Toolbars====
=====Buttons=====
WARNING: If images disappear when you use new button layouts from the forum, you are missing two dependencies: zlib1.dll and libpng13.dll. They have to be copied into the main foobar2000 directory, not into the components directory!
You can download them from the official homepage at [http://yuo.be/download/libpng128-zlib123.7z]

=====Menu=====
=====Playback Order=====
=====Seekbar=====
=====Volume=====

====Visualizations====
Spectrum Analyzer is the only one that I have. Well, if a visualization is next to a toolbar, it will fit inside of the toolbar. If it's inside of a splitter or next to panels, then it will act as a panel.

===Example Layout===

==Playlist Switcher==

Switch playlist, not very featureful.

==Columns Playlist==

This Playlist View (like Single Column Playlist or Default) displays different variables in columns.

===Columns===

===NG Playlist===
Allows playlist to be sorted in groups

===Playlist filters===
* Playlist filters allow one to hide on playlists/show only on playlists/show on all playlists according to the playlist filter specified.
* Separate multiple playlists by a semi-colon and you can use wildcards and ?s.

===Global===
Use this panel to configure the whole section of Columns Playlist.

====Variables====
Variables are used for...something....

====Style====
Style refers to each unconfigured style of column.

==See also==
* [[:Category:Foobar2000 Columns UI components|foobar2000 Columns UI components]] (category page)

==References==
<references />

==External links==
* {{ha|https://hydrogenaud.io/index.php/topic,28647.0.html}}
* [https://yuo.be/columns_ui Official Columns UI website]
* [https://wiki.yuo.be/columns_ui:start Official Columns UI wiki]

Foobar2000:Title Formatting Reference

2005-05-24T14:22:34Z

Musicmusic: formatting fixes pt 2

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %artist% ===
Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.

=== %album artist% ===
Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.

=== %disc% ===
Defined as ''$num($meta(disc),1)''. Returns the discnumber without extra leading zeroes.

=== %track artist% ===
Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.

=== %title% ===
Defined as ''$if2($meta(title),%_filename_ext%)''. Returns the ''title'' tag if available, otherwise it returns the filename including the extension.

=== %tracknumber% ===
Defined as ''$num($meta(tracknumber),2)''. Returns the tracknumber padded to two digits from the left with zeroes.

== Technical information ==

=== %bitrate% ===
Defined as ''$if2(%_%%_%%bitrate_dynamic%,%bitrate%)''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.

=== %channels% ===
Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %samplerate% ===
Defined as ''%_%%_%%samplerate%''. Returns the samplerate in Hz.

=== %codec% ===
Defined as ''$codec()''.

== Special fields ==

=== %playlist_number% ===
Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns the position of the track as index into the playlist. The first track has index 1. The index is padded from the left with zeroes to the same number of digits as the last track.

= Control flow =

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(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

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

=== $ifgreater(n1,n2,then,else) ===

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

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', 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.

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

Example: "c3po" -> 0, " -12" -> -12, but "- 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'' through ''b''. 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 232-1.

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

= Color functions =

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

=== $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 for the color of 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. Not 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''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %_time_elapsed% ===
Returns elapsed time.

=== %_time_remaining% ===
Returns remaining time until track ends.

=== %_time_total% ===
Returns total length of track.

=== %_time_elapsed_seconds% ===
Returns elapsed time in seconds.

=== %_time_remaining_seconds% ===
Returns remaining time in seconds.

=== %_time_total_seconds% ===
Returns total track length in seconds.

=== %_ispaused% ===
Returns "1" if playback is paused and empty string otherwise.

= Playlist info =
The following functions and fields are usable for playlist scripts.

== Special fields ==

=== %_isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

=== %_ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

=== %_playlist_number% ===

Returns playlist index of specified item. The first item is at index 1.

=== %_playlist_total% ===

Returns number of items in the playlist.

=== %_playlist_name% ===

Returns the name of the playlist containing the specified item.

= String functions =

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

=== $abbr(x) ===

Returns abbreviation of ''x''.

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

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

=== $ansi(x) ===

Converts ''x'' 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.

=== $caps(x) ===

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

=== $caps2(x) ===

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

=== $char(x) ===

Inserts Unicode character with code ''x''.

=== $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(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

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

=== $directory(x,n) ===

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

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' 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 ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' 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 ''x'' is returned unaltered.

=== $hex(n) ===

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

=== $hex(n,len) ===

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

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

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

=== $len2(a) ===

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

=== $longer(a,b) ===

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

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

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

=== $num(n,len) ===

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

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

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

Pads ''x'' from the left with ''char'' to ''len'' characters.

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

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' 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,a,b) ===

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

=== $repeat(a,n) ===

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

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

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

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

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

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

=== $shortest ===

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

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $trim(s) ===

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

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

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

== 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 tag called ''name''.

Example: ''$meta(artist,2)'' -> "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: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"

=== $meta_test(...) ===
Returns ''true'', if all given tags exist.

Example: ''$meta_test(artist,title)'' -> true

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

Example: ''$meta_num(artist)'' -> 3

=== $tracknumber() ===
Returns the tracknumber padded to 2 digits with zeroes.

=== $tracknumber(n) ===
Returns the tracknumber padded to ''n'' digits with zeros.

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2

=== $codec() ===
Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"

=== %__replaygain_album_gain% ===
Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.

=== %__replaygain_album_peak% ===
Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.

=== %__replaygain_track_gain% ===
Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.

=== %__replaygain_track_peak% ===
Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.

== Special fields ==

=== $extra(name) ===
Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. The following field names can be used:
==== filename ====
Returns the filename without directory and extension.
==== filename_ext ====
Returns the filename with extension, but without the directory.
==== directoryname ====
Returns the name of the parent directory only, not the complete path.
==== path ====
Returns the path.
==== path_raw ====
Returns the path as URL including the protocol scheme.
==== subsong ====
Returns 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 ====
Returns a string representing the version of foobar2000.
==== length ====
Returns the length of the track formatted as hours, minutes, and seconds.
==== length_ex ====
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.
==== length_seconds ====
Returns the length of the track in seconds.
==== length_seconds_fp ====
Returns the length of the track in seconds as floating point number.
==== length_samples ====
Returns the length of the track in samples.

= Variable operations =

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

=== $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 only the truth value of ''value''.

Foobar2000:Title Formatting Reference

2005-05-24T14:16:04Z

Musicmusic: formatting fixes

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %artist% ===
Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.

=== %album artist% ===
Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.

=== %disc% ===
Defined as ''$num($meta(disc),1)''. Returns the discnumber without extra leading zeroes.

=== %track artist% ===
Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.

=== %title% ===
Defined as ''$if2($meta(title),%_filename_ext%)''. Returns the ''title'' tag if available, otherwise it returns the filename including the extension.

=== %tracknumber% ===
Defined as ''$num($meta(tracknumber),2)''. Returns the tracknumber padded to two digits from the left with zeroes.

== Technical information ==

=== %bitrate% ===
Defined as ''$if2(%_%%_%%bitrate_dynamic%,%bitrate%)''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.

=== %channels% ===
Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %samplerate% ===
Defined as ''%_%%_%%samplerate%''. Returns the samplerate in Hz.

=== %codec% ===
Defined as ''$codec()''.

== Special fields ==

=== %playlist_number% ===
Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns the position of the track as index into the playlist. The first track has index 1. The index is padded from the left with zeroes to the same number of digits as the last track.

= Control flow =

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(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

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

=== $ifgreater(n1,n2,then,else) ===

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

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', 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.

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

Example: "c3po" -> 0, " -12" -> -12, but "- 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'' through ''b''. 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 232-1.

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

= Color functions =

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

=== $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 for the color of 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. Not 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''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %_time_elapsed% ===
Returns elapsed time.

=== %_time_remaining% ===
Returns remaining time until track ends.

=== %_time_total% ===
Returns total length of track.

=== %_time_elapsed_seconds% ===
Returns elapsed time in seconds.

=== %_time_remaining_seconds% ===
Returns remaining time in seconds.

=== %_time_total_seconds% ===
Returns total track length in seconds.

=== %_ispaused% ===
Returns "1" if playback is paused and empty string otherwise.

= Playlist info =
The following functions and fields are usable for playlist scripts.

== Special fields ==

=== %_isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

=== %_ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

=== %_playlist_number% ===

Returns playlist index of specified item. The first item is at index 1.

=== %_playlist_total% ===

Returns number of items in the playlist.

=== %_playlist_name% ===

Returns the name of the playlist containing the specified item.

= String functions =

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

=== $abbr(x) ===

Returns abbreviation of ''x''.

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

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

=== $ansi(x) ===

Converts ''x'' 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.

=== $caps(x) ===

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

=== $caps2(x) ===

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

=== $char(x) ===

Inserts Unicode character with code ''x''.

=== $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(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

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

=== $directory(x,n) ===

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

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' 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 ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' 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 ''x'' is returned unaltered.

=== $hex(n) ===

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

=== $hex(n,len) ===

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

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

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

=== $len2(a) ===

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

=== $longer(a,b) ===

Returns //true//, if string ''a'' is longer than string ''b'', false otherwise.

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

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

=== $num(n,len) ===

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

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

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

Pads ''x'' from the left with ''char'' to ''len'' characters.

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

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' 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,a,b) ===

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

=== $repeat(a,n) ===

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

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

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

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

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

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

=== $shortest ===

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

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $trim(s) ===

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

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

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

== 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 tag called ''name''.

Example: ''$meta(artist,2)'' -> "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: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"

=== $meta_test(...) ===
Returns true, if all given tags exist.

Example: ''$meta_test(artist,title)'' -> true

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

Example: ''$meta_num(artist)'' -> 3

=== $tracknumber() ===
Returns the tracknumber padded to 2 digits with zeroes.

=== $tracknumber(n) ===
Returns the tracknumber padded to ''n'' digits with zeros.

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2

=== $codec() ===
Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"

=== %__replaygain_album_gain% ===
Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.

=== %__replaygain_album_peak% ===
Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.

=== %__replaygain_track_gain% ===
Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.

=== %__replaygain_track_peak% ===
Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.

== Special fields ==

=== $extra(name) ===
Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. The following field names can be used:
==== filename ====
Returns the filename without directory and extension.
==== filename_ext ====
Returns the filename with extension, but without the directory.
==== directoryname ====
Returns the name of the parent directory only, not the complete path.
==== path ====
Returns the path.
==== path_raw ====
Returns the path as URL including the protocol scheme.
==== subsong ====
Returns 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 ====
Returns a string representing the version of foobar2000.
==== length ====
Returns the length of the track formatted as hours, minutes, and seconds.
==== length_ex ====
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.
==== length_seconds ====
Returns the length of the track in seconds.
==== length_seconds_fp ====
Returns the length of the track in seconds as floating point number.
==== length_samples ====
Returns the length of the track in samples.

= Variable operations =

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

=== $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 only the truth value of ''value''.

Foobar2000 Talk:Foobar2000

2005-04-04T22:10:01Z

Musicmusic:

I'm using Mozilla and it displays correctly unless I try to select it. I think it's best to have the correct code in there though, even at the expense of this bizarre behavior. I avoided writing it like that because of that problem. Thanks. :) --[[User:Topdownjimmy|Topdownjimmy]] 23:07, 14 Feb 2005 (CST)
----
I just put the code in the 'Basic Color Codes' section into code blocks for ease of reading, but found I had to use IE to do the editing since firefox couldn't handle the block chars in the edit panel. Firefox seems to display them fine though. Is this going to be a problem? Thought I should ask before I tried to do the same for the rest of the page. - krazy

----

Thanks, krazy, for the link to picmixer's masstagger guide. :) I moved it to the end of the masstagger section because I think it makes more sense there.--[[User:Topdownjimmy|Topdownjimmy]] 22:45, 13 Feb 2005 (CST)

----

Reversed order of discussion posts (newer at top). Thanks, krazy, for pointing out foo_looks was problematic.

--[[User:Topdownjimmy|Topdownjimmy]] 15:07, 13 Feb 2005 (CST)

----

Removed references to foo_looks and replaced with foo_ui_gfx. It's just that I don't think a [http://www.hydrogenaudio.org/forums/index.php?showtopic=17872 potential troublemaker] should be on the wiki page. Other than that, looking good!

----
Krazy, I moved your "Commonly Used Panel Extensions" down into the Columns UI section of the Beginner's Guide, I hope you don't mind.
-topdownjimmy
----

Why use the underscore in the LAST_PLAYED tag? A space works just as well, is completely compliant, and is much easier to type.
-Canar

apparently firefox doesnt like the colour code markers in the slightest, they seem to have got a bit messed up in my edit, sorry. also maybe someone wants to take notice/work on this:
WARNING: This page is 35 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections. --[[User:Musicmusic|musicmusic]] 17:10, 4 Apr 2005 (CDT)

Foobar2000:Foobar2000

2005-04-04T22:07:20Z

Musicmusic: fixed some links

[http://www.foobar2000.org/ '''foobar2000'''] is a free music player for Windows. It features multiple playlists, a music database, streaming, [[ReplayGain]] support, extensive plug-ins support and more.

=== A note to potential editors ===

The Newbie Guide is intended to provide no more than a very basic competence in fb2k. Therefore, it should be relatively broad, readable in one sitting, and contain only the most essential information for getting started. Any documentation beyond this purpose belongs in the Intermediate or Advanced Use sections. Similarly, small issues that demand a significant amount of detail are better suited for the FAQ section.

Remember that if any reader feels that the Newbie Guide is beneath them, they may always move beyond it, but a Newbie Guide that is bogged down by too much information will be no less intimidating than the looming behemoth we call our forum.

----

=== Supported... ===

==== Playback Formats ====

* [[MP3]], [[Ogg Vorbis]], [[MP2]], [[AAC]], [[WAV]], [[AIFF]], [[Musepack]], [[VOC]], [[SND]]

Supported through plug-ins:

* [[TTA]], [[FLAC]], [[Monkey's Audio]], [[WavPack]], [[Speex]], [[Mod]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[WMA]], [[AC3]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]]

In addition, foobar2000 can also play music directly from compressed RAR, ZIP and 7-ZIP archives without requiring the user to extract the files prior to playing.

==== Languages ====

* English

==== Platforms ====

* Windows

No known plans exists to port it to other platforms, but attempts have been made, with varying degrees of success, to run foobar2000 on x86 Linux systems by using Wine.

----

=== User Interface ===

====Standard====

By default foobar2000 uses the standard interface, foo_ui_standard. This interface is based around a tabbed list of playlists. Playlists are then formatted according to the title formatting strings entered by the user. These allow access to tag data, as well as information about the state of the program in the playlist display.

====Columns UI====

[http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 foo_ui_columns] is an extension of the ideas used in the standard interface. It takes the open area of the playlist and divides it into one or more columns that have individual formatting strings. Recent versions of Columns UI have also added support for UI Extension panels which appear in Columns UI's sidebar or in the toolbar.

Because of the useful extensions to the Standard UI, Columns UI is rapidly becoming popular and continues to be under rapid development.

----

=== Newbie Guide ===

==== Introduction ====

Always remember that the best way to become comfortable with foobar is to read [http://www.hydrogenaudio.org/forums/index.php?showforum=28 the forums] regularly and to play around with foobar itself. 90% of what you learn will come from the forums and experimentation.

The heart of foobar lies in its components, which supplement foobar's functionality. If you are having trouble with a component, the first step is to consult that component's documentation, preferences, and forum thread. Any question you have as a beginner has probably already been asked and answered in the forums a half dozen times. Please search the forums thoroughly for an answer before posting your question. If you must post a question, try to avoid creating a new topic. An appropriate topic most likely already exists, so post your question as a reply in that topic.

==== Using Columns UI ====

It is best for reasonably computer-literate users to start with [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI] as their user interface; the TAGZ formatting needed is very basic and the panel extensions will make foobar much more user-friendly, resembling mp3 players you're more accustomed to.

Bookmark these sites before using Columns UI:

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI thread]: ''very'' large, but the first post contains links to important related sites and panel extensions

*[http://music.morbo.org/wiki/columns_ui:faqs Columns UI FAQ]: a short FAQ, including installation instructions

[[Image:Columnsui.png|thumb|The Columns UI interface]]

*[http://music.morbo.org/wiki/columns_ui:columns_ui Columns UI documentation]: it is ''crucial'' that you familiarize yourself with this over time

The Columns UI interface consists of:
* ''Playlist View'': The Playlist View is the large area that displays the songs in your current playlist. Other playlists appear as tabs at the top of the Playlist View. Each row in the Playlist View is divided into one or more columns that may be individually formatted using TAGZ strings.
* ''Toolbar'': The Toolbar is the area above the Playlist View and can display playback buttons, the menu, playlist search, and other toolbar components.
* ''Sidebar'': The Sidebar resides to the left of the Playlist View and can display panel extensions as well as toolbar components. The Sidebar is enabled by checking both "Enable Sidebar" and "Show Sidebar" in the "Columns UI" subgroup of the "Components" menu.

===== Panel Extensions =====

Panel extensions add album art, track info, and other useful components to the Columns UI Sidebar. Installing panels to Columns UI is simple; just copy the .dll into your foobar2000\components folder and restart foobar. To display an installed panel or toolbar in the Sidebar, right-click on any gray area of the Sidebar for a list of items you can add.

[[Image:Sidebaradd.png|thumb|Adding panels to the sidebar]]

Links to supported panels are given in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI thread] of the [http://www.hydrogenaudio.org/forums/index.php?showforum=28 foobar2000 forums].

Some popular panels include (in no particular order):

*[http://music.everywebhost.com/download/foo_uie_albumlist.7z foo_uie_albumlist] ''Albumlist Panel'' Sorts music into a hierarchical tree, allowing you to easily browse and select different branches of your collection.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=28869 foo_uie_tabs] ''Tabbed Panel Stack'' Allows multiple panels to be stacked in a tabbed interface.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=29383 foo_uie_albumart] ''Album Art Panel'' Displays album art from images in a specified folder.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 foo_uie_trackinfo] ''Track Info Panel'' Displays information about the currently playing or selected track. Can be customised using TAGZ strings.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=28665 foo_uie_volume] ''Volume Control Toolbar'' Volume control extension for Columns UI. Provides a slider to control volume.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=26475 foo_playlistfind] ''Playlist Find Panel'' Finds tracks in current playlist matching input text.

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=8609 foo_history] ''History Plugin/Panel'' Displays and provides browser-style navigation through recently played songs.

To see what some people have done with Columns UI and panel extensions, check out the [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery]. If you see something you like, try to do it yourself. If you get stumped, you might find an answer in the [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000&action=submit#Tips_.26_Tricks Tips & Tricks] section below.

==== Basic TAGZ ====

TAGZ is the language used to define how information about a track is displayed. Although you can do some very complex things using TAGZ, you should have a basic understanding of it now because you'll be encountering it a lot whether you want to or not. The text displayed in each column of the playlist in Columns UI is defined by a string of TAGZ code, located in "Foobar 2000 > Preferences > Display > Columns UI > (Columns tab)." TAGZ strings and functions are thoroughly documented in the titleformat_help.html file located in your foobar2000 directory. Bookmark this file and familiarize yourself with it as much as possible. It might look very strange at first, but once you see some TAGZ strings "in action" it will begin to make sense, and you will refer to it constantly.

[[Image:Columnstagz.png|thumb|Columns UI preferences]]

Looking in the Columns UI preferences, you will see that the TAGZ code used for the "Artist" column is:

[%artist%]

%artist% retrieves the contents of the ARTIST field stored in the file's tag. The brackets [ ] around %artist% mean that the ARTIST field should only be shown if it exists. If there is no ARTIST field, nothing will be displayed; without the brackets, a question mark would be displayed.

Not to be confused with TAGZ, a file's "tag" contains what is known as "metadata." Information about the file, such as artist, album, tracknumber, etc., are stored within the file in the form of tag fields. Much of the foobar environment is ''vitally'' dependent on accurate tags, so keep yours in order.

Some common tag fields are:

[[Image:fileinfo.png|thumb|The File Info window]]

*ARTIST
*ALBUM ARTIST (for "Various Artists," etc.)
*ALBUM
*TRACKNUMBER
*TITLE (track title)
*DATE
*GENRE
*COMMENT

To view and edit the tag fields contained within a particular file, right-click on that file in the playlist and click "Properties."

Data in the "Technical info" pane on the right can be retrieved using a double underscore: %__bitrate%.

Looking again in Columns UI preferences, the TAGZ string used for the "Title" column is:

$if2(%title%,%_filename%)

$if2(x,y) is a TAGZ ''function'' that takes two parameters and produces one result. Using titleformat_help.html, try to figure out what this TAGZ string will produce, and why it was written this way. You might also want to try creating columns that contain your own TAGZ strings. As always, titleformat_help.html is your best friend.

[[Image:Trackinfo.png|thumb|Track Info's real-time display]]

The [http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 trackinfo] panel can be VERY helpful in teaching you how TAGZ strings behave. This panel updates in real-time as you edit its TAGZ-based configuration. It is recommended that you install and display this panel, using it as a "scratch pad" to help you become familiar with TAGZ.

As you become more proficient, you might want to download some [http://foobar.nub4life.net/columns/ ready-made Columns UI configs] to see some more complex TAGZ strings in action. Import the .fcs file from the "Other" tab in the Columns UI preferences (be sure to export your current config first to back it up in case you're not happy with the one you import). Study how these strings do what they do and change them around to see how the display is affected.

==== Masstagger ====

The Masstagger component is very handy when you need to perform relatively complex tag operations on a group of files.

To perform tag operations on a group of files using Masstagger, highlight those files in the playlist, right-click on them, and choose "Masstagger > Edit tags." The "Actions to perform" pane in the Masstagger window displays the actions that will be performed on the list of "Files to process" when the "Run" button is clicked. To add an action to perform, click the "Add" button.

[[Image:Masstagger.png|thumb|The Masstagger window]]

A simple action to perform is to set some field to a given value. For example, to set the GENRE field for all selected files to "Rock," choose "Set value..." from the "Select action type" window. In the "Field name" drop down list, choose "GENRE," and in the "Field value" box, type "Rock" (without quotes). When you click "OK," the action will be listed in the "Actions to perform" pane. Click "Run" to perform these actions on the selected files.

Before clicking "OK," you may choose to save this group of actions (this "script") for easy retrieval later. Just type in a name for the script in the "Scripts" section below (in this case, something like "Set GENRE to 'Rock'"), and click "Save." Later, to retrieve the saved script, select it from the drop-down menu and click "Load."

Realistically, this would be more easily achieved by selecting the files to be processed in the playlist, right-clicking them and choosing "Properties," then editing the GENRE field in the "File Info" window. There are many more tag actions you can perform with Masstager, including guessing tags from filenames, and formatting tag fields based on other tag fields. These operations depend on an understanding of the TAGZ language. For a more in-depth explanation of some of the possibilities of the Masstagger, see picmixer's '[http://www.hydrogenaudio.org/forums/index.php?showtopic=12302 FB2K's Masstagger, an unofficial Beginners Guide]'.

==== The Database ====

[[Image:Albumlist.png|thumb|The Album list window]]

The Database keeps track of all the info for all the files you play in foobar. The Database is crucial for such things as the albumlist panel (included with Columns UI), the [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000&action=submit#Extended_Playlist_Generator Extended Playlist Generator] (included in the special installer), and other components. The Database uses information from your files' tags, so ''make sure your tags are in order''.

To enable the Database, check the "Database enabled" box in the "Database" section of Preferences. If you would like to add an entire directory of music to the Database, enter the directory in the "Restrict directories to:" box. ****QUIT OUT OF FB2K***, start it back up, go back to the "Database" section, THEN click the "scan" button. Keeping this directory in the box will prevent files in other directories from being added in the future, however, so uncheck it if you will be adding files from other locations as well. Files are added to the Database whenever they are added to a playlist.

You can view the contents of the Database using the Album list component. Click "Components > Album list."

==== Extended Playlist Generator ====

The Extended Playlist Generator can automatically create playlists from the contents of a playlist or [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000&action=submit#The_Database the Database] based on criteria that you specify. To access the EPG, click "Components > Extended Playlist Generator > Configure Playlist Query..."

[[Image:Epg.png|thumb|The Extended Playlist Generator]]

For starters, try entering the name of an artist you know is in your database in the "Query:" box. Click "Run." The results will appear below. To create a playlist with these results, enter a name for the playlist in the "Playlist Name:" box and click the "Create Playlist" button. To save a query, click the "Save" button. It will be saved in the presets under the "Playlist Name" you specified. Once saved, a query can be recalled and its playlist regenerated by clicking "Components > Extended Playlist Generator > Generate Playlist..." in the menu toolbar.

Click the "Help" button in the EPG for help formatting queries. EPG uses both the TAGZ language and its own query language of conditionals such as GREATER and HAS. Try this simple query:

%date% GREATER 1979

This query will return all songs whose DATE tag is greater than 1979. Save this query as "The '80s, '90s, and today!" Queries that use tag fields like this require that the tag fields exist in the first place. Another reason to keep your tags ship-shape!

==== Third-Party Components ====

There is a slew of third-party components that can fill many of your foobar needs. Installing these and using them is as simple as installing and using Columns UI's panel extensions: just download the .dll, copy it into your foobar2000\components folder, and restart foobar.

Check out the [http://www.hydrogenaudio.org/forums/index.php?showtopic=21105 Most Sought-After Plugins] forum thread and [http://pelit.koillismaa.fi/plugins/ the official third-party components site] for a list of available components.

==== Things to remember... ====

Look around. Play with stuff. Experiment. Right-click on something you've never right-clicked on before. Browse the preferences window. Read the forums. Study titleformat_help.html. Have fun. Don't forget to listen to music.

----

=== Intermediate Use ===

==== Basic Color Codes ====

Click on the "Colour" tab within the "Columns" tab of the Columns UI preferences. It is empty. If you want to customize the colors used in a column, you would put the color codes here and check the "Use custom colour spec" box above.

Beneath the text box you will see a six-character hex code with a block character on either side of it:

�0080FF�

This is what a color code looks like. To get a color code for a specific color, click on the "..." button, which will pop-up a palette and return the color you choose in the same gray box, ready to be copied and pasted.

The way you format colors is given by clicking the "Tools" button, then by clicking "String help." Concentrate on the first four items, which are required in every color code string:

text|selected text|background|selected background

For example, if I wanted my "Artist" column to display red text on white background when not selected, and yellow text on blue background when selected, I would use this format:

(red color code)|(yellow color code)|(white color code)|(blue color code)

The proper color code would then be:

�0000FF�|�00FFFF�|�FFFFFF�|�FF0000�

[[Image:Color.png|Custom color sample]]

Note that unlike most other applications, Foobar uses a hexadecimal '''BGR''' color scheme, which means that if you use any alternate color pickers you will need to switch the first and last two characters. (Example: FF0080 (magenta) in Photoshop should be changed to 8000FF in Foobar)

The block character may instead be represented by $char(3), as in:

$char(3)0000FF$char(3)

You may also represent color codes as RGB values using this format:

$rgb(255,128,0)

These alternate codes are useful when the block character is unavailable or becomes problematic (as it does in Firefox).

==== Advanced TAGZ ====

==== Album List & Album List Panel ====

The '''Album List''' extension (foo_albumlist) comes as a part of the default Foobar package. This extension allows you to sort your music a variety of ways, each displaying it in a hierarchical tree format. While Album List comes by default and can be used without the '''Columns UI''', the '''Album List Panel''' extension (foo_uie_albumlist) improves on it in many ways.

===== Usage of Album List =====

The Album list sorts music through a variety of sort strings. To get the music to display, you must enable the database by going to '''preferences/database.''' By default, Albumlist comes with a handful of "views," which when selected show different layouts of your collection. All of these views are fully customizable with TAGZ, and additional views can be added or removed in the preferences. When making a new view using TAGZ, keep in mind that each branch is represented by a single pipe ("|") character. It is important to note that the TAGZ string will be split up by these pipes, meaning that '''each section must be valid TAGZ code by itself.''' For example:

$if(%album artist%,%album%|$num(%tracknumber%,2) - %title%,%artist%|%album%|$num(%tracknumber%,2) -
%title%)

'''This is not valid code.''' As far as Albumlist is concerned, this string would be interpreted as such:

$if(%album artist%,%album%
$num(%tracknumber%,2) - %title%,%artist%
%album%
$num(%tracknumber%,2) - %title%)

Assuming that the intended behavior was for %album artist% to have a different string than the regular artist, you will have to put an $if() statement in every section:

$if(%album artist%,%album%,%artist%)|$if(%album artist%,$num(%tracknumber%,2) -
%title%,%album%)|$if($not(%album artist%),$num(%tracknumber%,2) - %title%)

'''This is valid code.'''

==== ReplayGain ====

Replaygain calculates the average volume of either a track (track gain) or an album (album gain) and uses this information to properly adjust the volume of tracks, that are mastered at different volume levels, during playback. This will make sure that you will have a similar volume levels on all of your tracks or albums without loosing any dynamic range of your music. In the case of Album Gain, it will even make sure that more quiet tracks of an album will sound more quiet and tracks that where meant to be louder, louder. As you can probably already tell, Album Gain would probably be the best way to make use of Replaygain. For more details, check the [[Replaygain]] wiki page.

Setting it up is realtively easy. Simply select all the tracks you want to Replaygain in your playlist and you will be presented with several options:

* ''Scan per file track gain'' This will scan the selection and will add Replaygain values file by file, meaning that the difference in loudness of files coming from the same album is not preserved. This would be the recommended way of scanning tracks of wich you don't own the entire Album. (If you only have a few files of an Album, but they come from the same source (rip), I would also recommend using Album gain.

* ''Scan selection as album'' Not that hard to guess, using this option, you will have to select all the tracks that belong to one album and scan them. The difference in loudness between quiet and loud tracks will be left intact.

* ''Scan selection as multiple albums using album field'' In case all your files are properly tagged this would probably be the easiest way to initially set up Replaygain. It will scan all selected files and properly gain them album by album using the album info found in the file tag.

Replaygaining your files will not alter them in any way. It stores all the information it needs into the file tags or Foobars database and the actual file is not changed what so ever. The whole process is obviously fully reversible by simply removing the Replaygain info from the file. (Or simply disabling Replaygain during playback). Check your playback preferences, for all playback options considering Replaygain

Replaygain can also be used when creating mix cd's with Foobars diskwriter. Simply enable it in the diskwriter preferences to make sure you get nicely balanced compilations without annoyingly large differences in volume levels.

Note that Replaygain will in a lot of cases also prevent your files from clipping, since it usually lowers the playback volume of very loudly mastered tracks. Whereas this is not the main intention of Replaygain ( volume levelling is), this comes as a nice side effect to some people. You even have the option to scale down tracks that still clip after applying Replaygain using the peak info (again, check your preferences for this option).

Last but not least, I will mention the two preamps in the Playback preferences. Except if you know exactly what you are doing, it is not recommended to raise the output of the preamps above the default 0.0dB in any way. However you can use these to slightly compensate for the difference between replaygained and unreplaigained Tracks. Simply estimate your average Replaygain level and lower the preamp for files without Replaygain info by that value. I found -8dB to work quite well for me. This obviously should not be used to compensate for not properly Replaygaining your tracks, but definetaly will protect your ears and your equipment when coming across tracks that miss Replaygain info.

[http://www.hydrogenaudio.org/forums/index.php?showtopic=31140 An interesting discussion] of Replaygain, mastering, clipping etc.

==== Diskwriter ====

==== The Database & Tag Writing ====

The database identifies files by path, filename, modification date and filesize. If any of these properties are changed by a program other than foobar itself, foobar will reload the metadata from the file the next time it is played.

==== Default UI Strings ====

----

=== Advanced Use ===

----

=== Tips & Tricks ===

==== Volume Slider in Sidebar/Toolbar ====

[http://www.hydrogenaudio.org/forums/index.php?showtopic=28665 foo_uie_volume]

==== Placing Panels Above the Playlist ====

To place panels above the playlist, check "List all toolbars" in the "Other" tab of the Columns UI preferences. When checked, right-clicking on the toolbar will give you the option of placing panels on the toolbar. If a panel appears "squashed," it is because it needs to have a minimum height set in its preferences. If the panel extension has no minimum height setting, you may place it in a [http://www.hydrogenaudio.org/forums/index.php?showtopic=28869 panel stack], and set a minimum height via the panel stack options.

==== Two Tabbed Panel Stacks in One Sidebar/Toolbar ====

''While holding shift'': Right-click on sidebar/toolbar, click "Layout > Tabbed Panel Stack"

==== Handy Strings ====

===== Standardize my PLAY_DATE and PLAY_TIME fields =====

LAST_PLAYED has been developed as a standard to replace the widely variable PLAY_DATE and PLAY_TIME usages. Use these Masstagger scripts to convert your specific format to this new standard. More info about LAST_PLAYED available [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000_Encouraged_Tag_Standards#LAST_PLAYED here].

'''''!!!NOTE!!!''''': Be '''''VERY CAREFUL''''' when applying any of the scripts below. Be sure to test the script on one file before running it on your whole library.

If your current time/datestamp is in the format...

* PLAY_DATE = DDMMYY, PLAY_TIME = HHMMSS (24hr) (this is foo_playcount's default format) ...download scripts from [http://www.hydrogenaudio.org/forums/index.php?showtopic=31592&view=findpost&p=274326 this thread post].

* PLAY_DATE = YYYYMMDD, PLAY_TIME = HHMMSS (24hr) ...download script from [http://www.hydrogenaudio.org/forums/index.php?showtopic=31592&view=findpost&p=274343 this thread post].

* PLAY_DATE = DD~MM~YY, PLAY_TIME = HH~MM~SS (where ~ is any one single-character separator) ...download script from [http://www.hydrogenaudio.org/forums/index.php?showtopic=31592&view=findpost&p=275872 this thread post].

===== "The Band" becomes "Band, The" =====

$if($strcmp($left(%artist%,4),The ),$right(%artist%,$sub($len(%artist%),4))', 'The,%artist%)

===== Pad tracknumber with leading zeros ("1" becomes "01") =====

$num(%tracknumber%,2)

===== Alternating Stripes in the playlist (Like iTunes) =====

Go to Preferences/Display/Columns UI/Globals/Colour Tab, enter this under the background section of your color string (text|selected text|'''background'''|selected background|...)

$ifgreater($mod(%_playlist_number%,2),0,�F2E8DF�,�FFFFFF�)

Replace the last two colors with your own.

===== Indicate Replaygain tags =====

This is if you want to show which kind of Replaygain you have. This string will show an "A" if album gain has been applied, a "T" if Track gain is applied, and a red "X" if there is no replaygain data in the file.

$if(%__replaygain_album_gain%,A,$if(%__replaygain_track_gain%,T,�0000FF|000�X))

===== Indicate Audioscrobbler submission =====

[http://www.audioscrobbler.com/ Audioscrobbler] is a service that, using the [http://pelit.koillismaa.fi/plugins/general.php#39 foo_scrobbler] component, keeps a record of the songs you listen to and provides various statistical reports. A track is submitted when either 50% or 4 minutes have elapsed, and this is what the string tests for. Actual submission to Audioscrobbler can only be verified by foobar's console.

$if(%_isplaying%,
$ifgreater(%_time_elapsed_seconds%,240,'*',
$ifgreater(%_time_elapsed_seconds%,$div(%_time_total_seconds%,2),'*',)))

=== Components ===

==== Track Info Panel (foo_uie_trackinfo) ====

Post your custom [http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 Track Info] strings here. Please include a screenshot.

===== beto's trackinfo string =====

supports tech info from:
*mp3 (lame profiles and versions). you need cz's modified input std component
*vorbis (aotuv and xiph.org releases)
*FLAC
*Monkey's
*Wavpack
*Last Played tag (external database only)

you may modify it at will...

screenshot here -> http://www.hydrogenaudio.org/forums/index.php?showtopic=30988&view=findpost&p=283458

// Tagname color
$puts(color1,�9C6B4C�)

// Section name color
$puts(color2,�000000�)
// Tag color
$puts(color3,�000080�)

// Last played
$puts(last_played_year,$substr(%__last_played%,1,4))
$puts(last_played_month,$substr(%__last_played%,6,7))
$puts(last_played_day,$substr(%__last_played%,9,10))
$puts(last_played_hour,$substr(%__last_played%,12,13))
$puts(last_played_min,$substr(%__last_played%,15,16))
$puts(last_played_sec,$substr(%__last_played%,18,19))

// Core code
//$get(color1)Mode: $get(color3)%_trackinfo_mode%$char(10)$char(10)
// Song info
$get(color2)Song Info$char(10)
$if(%artist%,$get(color1)Artist: $iflonger(%artist%,22,$get(color3)$cut(%artist%,22)'...'$char(10),$get(color3)%artist%$char(10)))
$if(%album%,$get(color1)Album: $iflonger(%album%,21,$get(color3)$cut(%album%,21)'...'$char(10),$get(color3)%album%$char(10)))
$if(%album_subtitle%,$get(color1)Album subtitle: $iflonger(%album_subtitle%,14,$get(color3)$cut(%album_subtitle%,14)'...'$char(10),$get(color3)%album_subtitle%$char(10)))
$if(%subalbum%,$get(color1)Subalbum: $iflonger(%subalbum%,20,$get(color3)$cut(%subalbum%,20)'...'$char(10),$get(color3)%subalbum%$char(10)))
$if(%title%,$get(color1)Title: $iflonger(%title%,23,$get(color3)$cut(%title%,23)'...'$char(10),$get(color3)%title%$char(10)))
$if(%subtitle%,$get(color1)Subtitle: $iflonger(%subtitle%,20,$get(color3)$cut(%subtitle%,22)'...'$char(10),$get(color3)%subtitle%$char(10)))
$char(10)
//Last played
$get(color2)Last Played$char(10)
$get(color1)$if(%__last_played%,Date: $get(color3)$get(last_played_day)/$get(last_played_month)/$get(last_played_year)
$char(10)$get(color1)Time: $get(color3)$get(last_played_hour):$get(last_played_min)$char(10)
$get(color3)$ifgreater(%__play_counter%,1,$get(color1)Played: $get(color3)%__play_counter% times$char(10),$get(color1)Played: $get(color3)%__play_counter% time$char(10)),
$get(color3)This song was never played$char(10))
$char(10)
//Tech information
$get(color2)Tech Info$char(10)
$get(color1)Codec: $get(color3)%__codec%$char(10)
$if($stricmp($codec(),FLAC),$get(color1)Vendor: $get(color3)$cut(%__FLAC_vendor%,23)$char(10))
$if($stricmp($codec(),Monkey''s Audio),$get(color1)v/c: $get(color3)%__version%/%__compression%$char(10))
$if($stricmp($codec(),WavPack),$get(color1)v/c: $get(color3)%__version%/%__compression%$char(10))
$if($and($stricmp($codec(),MP3),%__lame_version%),$get(color1)Version: $get(color3)%__lame_version%$char(10))
$if($and($stricmp($codec(),MP3),%__lame_profile%),$get(color1)Profile: $get(color3)$upper(%__lame_profile%)$char(10))
$if($stricmp($codec(),Vorbis),$if($stricmp($left(%__vorbis_vendor%,2),AO),$get(color1)Vendor: $get(color3)$cut(%__vorbis_vendor%,12)$char(10),
$if($stricmp($left(%__vorbis_vendor%,4),Xiph),$get(color1)Vendor: $get(color3)$cut(%__vorbis_vendor%,20)$char(10),$get(color1)Vendor: $get(color3)%__vorbis_vendor%$char(10))))
$get(color1)Bitrate: $get(color3)%__bitrate%Kbps$char(10)
$get(color1)Compression level: $get(color3)$muldiv(%__bitrate%,100,1411)'%'$char(10)
$get(color1)Samplerate: $get(color3)%__samplerate% Hz$char(10)
$if($strcmp(%__channels%,2),$if(%__mp3_stereo_mode%,$get(color1)Stereo mode: $get(color3)%__mp3_stereo_mode%$char(10),$get(color1)Stereo mode: $get(color3)stereo$char(10)),$get(color1)Stereo mode: $get(color3)mono$char(10))
$if(%__replaygain_track_gain%,$get(color1)Track Gain: $get(color3)%__replaygain_track_gain%$char(10),$get(color1)Track Gain: $get(color3)No track gain$char(10))
$if(%__replaygain_album_gain%,$get(color1)Album Gain: $get(color3)%__replaygain_album_gain%$char(10),$get(color1)Album Gain: $get(color3)No album gain$char(10))
//$get(color1)Path: $get(color3)%_path%$char(10)
//$if(%rippedby%,$get(color1)Ripper: $iflonger(%rippedby%,20,$get(color3)$cut(%rippedby%,20)'...'$char(10),$get(color3)%rippedby%$char(10)))
//$if(%encodedby%,$get(color1)Encoder: $iflonger(%encodedby%,20,$get(color3)$cut(%encodedby%,20)'...'$char(10),$get(color3)%encodedby%$char(10)))
$if(%comment%,$get(color1)Comment: $iflonger(%comment%,21,$get(color3)$cut(%comment%,21)'...'$char(10),$get(color3)%comment%$char(10)))
----

=== FAQ ===

A rather extensive FAQ is available at the [http://shsc.info/foobar2000 SH/SC Wiki].

'''Q: Album list shows dead entries after a restart, even though I used "Remove dead entries" before. Why is that?'''

A: The files are probably still contained in one of your playlists or in the history (only if you are using an older version of foo_history). Use "Playlist/Remove dead entries" from the main menu on all your playlists, or remove the dead entries manually. As long as the files are on a playlist, they will be in the database and thus will show up in album list.

=== Encouraged Tag Standards ===

FIELD_NAME [format] (component)

* ALBUM ARTIST [e.g., Various Artists, The Foobar Collective] (none) ''Notes'': Field name is ALBUM ARTIST, with ''no underscore''. Tag should exist if and only if an album is by multiple artists, and be contained in every track. Track-specific artists should be entered in the ARTIST tag, never in the TITLE tag. [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000_Encouraged_Tag_Standards#ALBUM_ARTIST (more about this standard)]
* LAST_PLAYED [2005-03-22 19:00:00...] ([http://www.hydrogenaudio.org/forums/index.php?showtopic=20719 foo_playcount]) ''Notes'': Any amount or type of data may be placed after the time. Compliant TAGZ code shall use $substr() instead of $right() when extracting substrings from this field. ''See also'': [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000#Standardize_my_PLAY_DATE_and_PLAY_TIME_fields Standardize my PLAY_DATE and PLAY_TIME fields] [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000_Encouraged_Tag_Standards#LAST_PLAYED (more about this standard)]
----

=== Important Links ===

==== Official Site ====

* [http://www.foobar2000.org foobar2000.org: Homepage]

* [http://www.foobar2000.org/download.html foobar2000.org: Download]

* [http://www.foobar2000.org/requirements.html foobar2000.org: Requirements]

==== Community ====

* [http://www.hydrogenaudio.org/forums/index.php?showforum=28 Official foobar2000 forum]

* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]

* [http://www.foobar.prv.pl/ Polish-language forum]

==== Guides ====

* [http://foobar2000.net/ French-language guide]

==== Appearance ====

* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery]: screenshot thread

* [http://pelit.koillismaa.fi/fb2k/index.php Default UI formatting strings]: cut-n-paste ready

* [http://foobar.nub4life.net/columns/ Columns UI configs]: .fcs file format

* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30281 foo_ui_gfx (alpha)]: skin support for foobar

==== Components / Plugins ====

===== General =====

* [http://www.hydrogenaudio.org/forums/index.php?showtopic=21105 Most Sought-After Plugins] (forum thread)

* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]

* [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI thread]: first post contains links to many Columns UI panel extensions

* [http://foobar2000.free.fr/ A comprehensive guide to foobar2000 components] (French)

===== Specific Components =====

* [http://www.saunalahti.fi/cse/html/foobar.html case's Page]: special installer, diskwriter components, etc.

* [http://www.saunalahti.fi/cse/kode54/index.php kode's Page]: file-formats, archive-support, OSD, shuffle (temporary mirror since the primary host is down)

* [http://www.stud.uni-karlsruhe.de/~uzbs/fb2k/html/ foosion's Page]: dbsearch, cut n' paste, history, etc.

* [http://members.chello.pl/d.sieradzki/foobar/ Messer's page]: freedb-masstagger, streaming with save-function, etc.

* [http://music.morbo.org/ musicmusic's Page]: textwriter, quicktag, custom sort, ui_columns, panels

=== Thanks ===

picmixer: ReplayGain tutorial