Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Foobar2000

2007-02-21T00:24:45Z

FofR: /* External Guides */ added link

{{notitle}}<div style="position: relative; top: -45px; z-index: 100;">
{|cellspacing="0" style="border-collapse: collapse;"|
|style="border: 1px solid #777777; padding: 10px; border-bottom: 0px;" colspan="2"|
<div style="font-size: 24px; border: 0px; font-weight: normal; padding-left: 5px; margin: 0px;">[[Image:foobar2000 Logo.png]] the foobar2000 wiki</div>
|-
|style="border: 1px solid #777777; padding: 10px; border-right: 0px;"|
'''foobar2000''' is a freeware audio player, and more. Apart from audio playback, it also supports media libraries, file conversion, CD ripping, and many more powerful features.
<div style="border: 1px solid #CCCCCC; padding: 5px 10px;">
'''The latest stable version is:''' [http://www.foobar2000.org/foobar2000_0.9.4.2.exe v0.9.4.2]<br />
'''The latest beta version is:''' None
</div>
==Features==

* Open component architecture allowing third-party developers to extend functionality of the player
* Full Unicode support
* [[Replaygain]] support
* Low memory footprint, efficient handling of really large playlists
* Advanced file info processing capabilities (generic file info box and masstagger)
* Highly customizable playlist display
* Customizable keyboard shortcuts
* Gapless playback
* Multiple playlists
* Music library
* Streaming Support
* Freeware

==Supported Audio Formats==

Native Support ("out-of-the-box"):
* [[MP1]], [[MP2]], [[MP3]], [[MP4]], [[Musepack]], [[AAC]], [[Ogg Vorbis]], [[FLAC]] / Ogg FLAC, [[Speex]], [[WavPack]], [[WAV]], [[AIFF]], [[AU]], [[SND]], [[CDDA]], [[WMA]].

Supported through plug-ins:
* [[TTA]], [[Monkey's Audio]], [[ALAC]], [[MOD]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[AC3]], [[DTS]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]], [[MMS]], [[RSTP]], etc.

In addition, foobar2000 can also play music directly from compressed RAR, ZIP, [http://kode54.foobar2000.org/foo_unpack_jma.zip JMA] & [http://kode54.foobar2000.org/foo_unpack_lha.zip LHA] archives without requiring the user to extract the files prior to playing.

Foobar2000 has been coded exclusively for the Windows platform with an English interface. The author does not intend to provide alternate language versions nor alternate platform versions. However, several people have had success [http://www.hydrogenaudio.org/forums/index.php?act=ST&f=24&t=6349&hl=wine running foobar2000 on x86 Linux systems] by using [http://www.winehq.org/ Wine], although the Columns UI plugin is known to be problematic.

==Using foobar2000==
* [[foobar2000:components 0.9|foobar2000 0.9.x Components]]
* [[foobar2000:Directories|foobar2000 Directories]]
* [[foobar2000:Encouraged Tag Standards|foobar2000 Encouraged Tag Standards]]
* [[foobar2000:FAQ|foobar2000 FAQ]]
* [http://wiki.hydrogenaudio.org/index.php?title=Category:Foobar2000_Guides foobar2000 Guides (category)]
* [http://wiki.hydrogenaudio.org/index.php?title=Category:Foobar2000_Preferences foobar2000 Preferences (category)]
* [[foobar2000:Tips & Tricks|foobar2000 Tips & Tricks]]

===Technical Information===
* [[Foobar2000:ID3 Tag Mapping|ID3 Tag Mapping]]

===General Guides===
''Note'' All '''general''' guides were written for 0.8.3 version and could contain outdated information. For 0.9 version, check out the External Guides below.
* [[foobar2000:Newbie User Guide|Newbie User Guide]]
* [[foobar2000:Intermediate User Guide|Intermediate User Guide]]

===Specific Guides===

'''0.9.x'''

* [[foobar2000:Preferences|Preferences Dialog]]
* [[foobar2000:Titleformat Introduction|Introduction to titleformat scripts]]
* [[foobar2000:Titleformat Reference|Titleformat Reference]] - Quick-Reference for fields and functions
* [[foobar2000:Masstaggers User Guide|Masstagger]]
* [[foobar2000:Commandline Guide|Commandline Usage]]
* [[foobar2000:Increasing Performance|Increasing Performance]] - Tips

'''0.8.x'''

The following articles contain outdated information that does not apply to Foobar2000 v0.9:
* [[foobar2000:Tagz|Tagz (Simple Syntax)]]
* [[foobar2000:Tagscript|Tagscript (Script-like Syntax)]]
* [[foobar2000:Autoplaylist|Autoplaylist]] Guide and Cookbook

===External Guides===

'''0.9.x'''
* [http://fooblog2000.com/ Fooblog2000] News blog with the latest configuration/component tips and guides.
* [http://eolindel.free.fr/foobar0.9/ Bachi-Bouzouk's English/French guide] Complete manual about foobar2000, Replaygain, the masstagger (with a tutorial) and common plugins. Two rather extensive FAQ for UI columns and overall use. Step by step guide to help new users.
* [http://foobar.s53.xrea.com/index.html fb2k Wiki Page] for Japanese users.
* [http://foobar2000.audiohq.de/ Frank Bicking's German-language guide].
* [http://www.bobulous.org.uk/misc/Replay-Gain.html Replay Gain] focusing on Foobar2000. (But the other articles on this site contain misleading information)

'''0.8.x'''

* [http://eolindel.free.fr/foobar/ Bachi-Bouzouk's guide]
* [http://www.dizwell.com/prod/node/44 Howard Rogers' Beginners' Configuration Guide]
* [http://shsc.info/foobar2000#titelanker2 SH/SC New user guide]
* [http://www.techspot.com/tweaks/foobar/ TechSpot's "complete guide to Foobar2000"]

==== Scripting Tutorials ====

'''0.9.x'''

* [http://eolindel.free.fr/foobar0.9/tutorial.php Bachi-Bouzouk's Scripting Tutorial] Color schemes detailed. Main functions explained, basic and complex code for your columns. Several .fcs explained, detailed FAQ.
* [http://tagz.brother-john.net/ Brother John's Foobar2000 Scripting Tutorial]

==Important Links==

===Official Site===

* [http://www.foobar2000.org foobar2000.org: Homepage]
* [http://www.foobar2000.org 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://foobar2000.fo.funpic.de/ German Support Forum]
* [http://www.foobar.prv.pl/ Polish-language forum]
* [http://www.foobar2000.tk Portuguese forum]
* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]
* [http://www.foobar2000.ru/forum/ Another Russian-language forum]

===Appearance===

* [http://www.hydrogenaudio.org/forums/index.php?showtopic=49783 Configuration Distribution Thread] Fast Way To Clone Another's Advanced Configuration {{foobar2000v09}}.
* [[Foobar2000:Preferences:Columns UI/Appearance|Appearance]] Guides to customizing the look of your Foobar2000
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43077 Foobar Gallery 0.9]: screenshot thread {{foobar2000v09}}
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery 0.8]: screenshot thread {{foobar2000v08}}
* [http://pelit.koillismaa.fi/fb2k/index.php Default UI formatting strings]: cut-n-paste ready
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=31027 Columns UI configs]: .fcs file format
|style="border: 1px solid #777777; padding: 10px;" valign="top"|
{{Software Infobox|
|name = foobar2000
|screenshot = [[Image:Foobar2000v0.9.png|250px]]
|caption = Screenshot of foobar2000 v0.9 using the default user interface
|maintainer = Peter Pawlowski
|stable_release = 0.9.4.2
|preview_release = None
|operating_system = Windows
|use = Media Player
|license = Proprietary, BSD
|website = [http://www.foobar2000.org/ www.foobar2000.org]
}}<br clear="both" />
<div style="margin-left: 17px;">__TOC__</div>
|}
[[Category:foobar2000]]
[[Category:Media Players|foobar2000]]

Foobar2000:0.9 CwBowron's Title formating (foo cwb hooks)

2006-09-11T15:00:44Z

FofR: added new variables

'''foo_cwb_hooks''' adds various functions and variables to global title formatting. The [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks author's component page] may contain more up-to-date information on the plugin.

'''Download:''' [http://foobar.bowron.us/foo_cwb_hooks.zip foo_cwb_hooks.zip]

=Description=

==Functions==
*$cwb_urldecode / $cwb_httpclean - decodes characters in URLs
*$cwb_removethe - removes The and A at the beginning of a string
*$cwb_ltrim - example: $cwb_ltrim(%artist%,The) $cwb_ltrim(%artist%,The ,A ,La )
*$cwb_datediff(d1,d2) - number of days between two dates in the format yyyy-mm-dd or yyyy-mm-dd hh:mm:ss

==Variables==
''Tagz updated September 11th 2006''

*%cwb_systemdate% - date in the formay yyyy-mm-dd
*%cwb_systemdatetime% - date and time in the format yyyy-mm-dd hh:mm:ss
*%cwb_activelist% - active playlist name
*%cwb_activelist_count% - number of items in the active list
*%cwb_playinglist% - playing playlist name
*%cwb_playinglist_count% - number of items in the playing list
*%cwb_queueindex% - queueindex if in the queue, false otherwise
*%cwb_queueindexes% - indices of the item in the queue, false otherwise
*%cwb_queuelength% - length of the queue
*%cwb_queue_end_playlist% - playlist of the last item in the queue
*%cwb_next_title% - title of the next song in the playlist of the playing item or the next item in the queue
*%cwb_next_artist% - artist of the next song in the playlist of the playing item or the next item in queue
*%cwb_playback_order% - e.g. Default, random, etc.

==Known Bugs==
*%cwb_playinglist% and %cwb_activelist% changes won't refresh in displays

==Feature Requests==
'''NOTE: These are NOT implemented.'''

* Add variables for the following:
**length of active playlist and playing list
**%_playbackorder%
**%_replaygain_mode% - not really possible
**%_database% - gives back if a file belongs to database or not
***not easily possibe because you cannot use SDK functions in the title formatting callback
***only way I could see to do it is to cache the library and test against that
**%_added% - timestamp when a file was added to database
***not really possible - timestamp is not stored when added when added to library
***could be possible with a plugin that stores the date added to the library
***library_callback implementing on_items_added() to store timestamps

==Useful Strings==

'Played Today', 'Played Yesterday', 'Played n days ago' or 'No last played info'

$if(%last_played%, $puts(diff,$cwb_datediff(%last_played%,%cwb_systemdate%)) Played $ifgreater(1,$get(diff),Today, $ifgreater(2,$get(diff),Yesterday, $get(diff) days ago)), No last played info)

=Link=
* [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43606&hl=foo_cwb_hooks Discussion thread]

[[Category:foobar2000 Other Components|cwb_hooks]]

File:Trackinfo-font-example.png

2006-09-06T15:22:25Z

FofR: Trackinfo Panel Mod Font Examples

Trackinfo Panel Mod Font Examples

File:Single column playlist-3.png

2006-08-31T15:29:44Z

FofR: Single Column Playlist

Single Column Playlist

File:Minifooim0.png

2006-08-31T15:28:00Z

FofR: Single Columns Playlist Component

Single Columns Playlist Component

Foobar2000:0.9 CwBowron's Title formating (foo cwb hooks)

2006-08-29T14:37:52Z

FofR: /* Feature Requests */

'''foo_cwb_hooks''' adds various functions and variables to global title formatting.<br>
'''Download:''' [http://foobar.bowron.us/foo_cwb_hooks.zip foo_cwb_hooks.zip]

=Description=

==Functions==
*$cwb_urldecode / $cwb_httpclean - decodes characters in URLs
*$cwb_removethe - removes The and A at the beginning of a string
*$cwb_ltrim - example: $cwb_ltrim(%artist%,The) $cwb_ltrim(%artist%,The ,A ,La )
*$cwb_datediff(d1,d2) - number of days between two dates in the format yyyy-mm-dd or yyyy-mm-dd hh:mm:ss

==Variables==
*%cwb_systemdate% - date in the formay yyyy-mm-dd
*%cwb_systemdatetime% - date and time in the format yyyy-mm-dd hh:mm:ss
*%cwb_activelist% - active playlist name
*%cwb_activelist_count% - number of items in the active list
*%cwb_playinglist% - playing playlist name
*%cwb_playinglist_count% - number of items in the playing list
*%cwb_queueindex% - queueindex if in the queue, false otherwise
*%cwb_queueindexes% - indices of the item in the queue, false otherwise
*%cwb_queuelength% - length of the queue
*%cwb_queue_end_playlist% - playlist of the last item in the queue

==Known Bugs==
*%cwb_playinglist% and %cwb_activelist% changes won't refresh in displays

==Feature Requests==
'''NOTE: These are NOT implemented.'''

* Add variables for the following:
**length of active playlist and playing list
**%_playbackorder%
**%_replaygain_mode% - not really possible
**%_database% - gives back if a file belongs to database or not
***not easily possibe because you cannot use SDK functions in the title formatting callback
***only way I could see to do it is to cache the library and test against that
**%_added% - timestamp when a file was added to database
***not really possible - timestamp is not stored when added when added to library
***could be possible with a plugin that stores the date added to the library
***library_callback implementing on_items_added() to store timestamps

==Useful Strings==

'Played Today', 'Played Yesterday', 'Played n days ago' or 'No last played info'

$if(%last_played%, $puts(diff,$cwb_datediff(%last_played%,%cwb_systemdate%)) Played $ifgreater(1,$get(diff),Today, $ifgreater(2,$get(diff),Yesterday, $get(diff) days ago)), No last played info)

=Link=
* [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43606&hl=foo_cwb_hooks Discussion thread]

[[Category: Other components]]
[[Category: Library tools]]

Foobar2000:Title Formatting Reference

2006-08-29T14:35:55Z

FofR: /* Component-specific fields and functions */ added CWB hooks link

This article contains information about built-in titleformatting functions and field references with special meaning. References to documentation about fields and function which can only be used in specific components or which are provided by specific components can be found at the end of this article.

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 commata, for example ''$abbr(%artist%)''. 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.

Please see [[Foobar2000:Titleformat_Introduction|Titleformat Introduction]] for a presentation of titleformat syntax in general.

= Field remappings =

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

== Metadata ==

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

=== %album% ===
Defined as ''$if3($meta(album),$meta(venue))''.

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

=== %disc% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %discnumber% remapping.

=== %discnumber% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %disc% remapping.

=== %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%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.

=== %track% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %tracknumber% remapping.

=== %tracknumber% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %track% remapping.

== Technical information ==

=== %bitrate% ===
Defined as ''$if2($info(bitrate_dynamic),$info(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 ''$info(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.

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

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is equal to ''n2'', the ''then'' part is evaluated and its value 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 2<sup>32</sup>-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.

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

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

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

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

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

=== %playback_time_remaining_seconds% ===
Returns remaining time in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== %length% ===
Returns the length of the track formatted as hours, minutes, and seconds.
Old version: <code>%_time_total%</code>

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

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

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

== Special fields ==

=== %isplaying% ===

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

The old version <code>%_isplaying%</code> still works.

=== %ispaused% ===

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

The old version <code>%_ispaused%</code> still works.

=== %list_index% ===

Returns a zero-padded playlist index of specified item. The first item is at index 1.

Also see [[Foobar2000:Titleformat Reference#%playlist_number%|%playlist_number%]].

The old version <code>%_playlist_number%</code> still works.

=== %list_total% ===

Returns number of items in the playlist.

The old version <code>%_playlist_total%</code> still works.

=== %playlist_name% ===

Returns the name of the playlist containing the specified item.

The old version <code>%_playlist_name%</code> still works.

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

=== $ascii(x) ===

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

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

=== $crc32(a) ===

Computes the CRC32 of the string ''a'' 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(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.

=== $rot13() ===

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

Example: ''$rot13('foobar2000')'' -> "sbbone2000".

=== $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 (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: ''$metasep(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

=== $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. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
==== %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.
==== %lastmodified% ====
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
==== %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.
==== $extra(foobar2000_version) ====
Returns a string representing the version of foobar2000.

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

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-provided fields and functions on tracks =

This section lists components that provide additional fields and functions that are useable in the context of any track.

== Playback statistics ==

* [http://www.foobar2000.org/beta/components.html Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

= Component-specific fields and functions =

This section lists components that provide additional fields and functions that are only useable in the context of the particular component.

== Album list ==

The official album list component supports creating multiple tree entries using special commands.

* [http://www.foobar2000.org/ Album list homepage]
* [[Foobar2000:Titleformat Album List|Album list titleformat reference]]

== Columns UI ==

* [http://music.morbo.org/wiki/columns_ui:manual Columns UI homepage]
* [http://music.morbo.org/wiki/columns_ui:config:global_variables Global variables reference]
* [http://music.morbo.org/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://music.morbo.org/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

== CwBowron's Title formating (foo cwb hooks) ==
foo_cwb_hooks adds various functions and variables to global title formatting:
* [[Foobar2000:0.9_CwBowron%27s_Title_formating_%28foo_cwb_hooks%29|cwb_hooks title formatting wiki page]]

= Additional Reading =

* [[Foobar2000:Titleformat_Introduction|Introduction to titleformat scripts]]
* '''titleformat_help.html''' in your Foobar2000 directory (ie C:\Program Files\foobar2000\titleformat_help.html) file:///C:/Program%20Files/foobar2000/titleformat_help.html

File:Ebatgh0.png

2006-08-29T13:55:06Z

FofR: Home stereo panel code

Home stereo panel code

Foobar2000:0.9 Quick Search (foo uie quicksearch)

2006-08-25T13:34:43Z

FofR: added links

Derived from ''foo_uie_search'' and ported to foobar2000 0.9, '''foo_uie_quicksearch''' provides the ability to include a search panel in your Columns UI layout, displaying results in a chosen playlist.

[[Image:QuickSearch3.png|Quick Search]]

==Changelog==

* Versions 2.8g & 1.5g (2006-08-16)
**Search pattern is now selected when the toolbar receives focus
** Fixed unproper toolbar colors after undock when autosearch is selected (1.5g only)
* Versions 2.8f & 1.5f (2006-06-20)
** Reorganized code and fixed a bug (wrong search results happening in extremely rare circumstances with "Exact" mode)
* Versions 2.8e & 1.5e (2006-06-19)
** Improved reactiveness and speed of inline playlist search
** Added "Search for same/Directory" to context menu
*Version 1.5 (2006-06-16)
** Ported from 2.8 for Foobar 0.8.3
*Version 2.8 (2006-06-15)
** Added configurable delay for autosearch
** Reorganized prefs & help pages
*Version 2.7 (beta) (2006-06-11)
** New: Autosearch feature ... (for people too lazy to hit the Enter Key)
** New: Added option to manage preferences (record of favorites search)
** Fixed weird bug (search not working with searchstrings of length 12 or 26)
** Changed "override keys" settings (Now: Alt+Enter=All Playlist, Shift+Enter=Playlist,Ctrl+Shift+enter=DB, Alt+Keydown=Menu)
** Reorganized menu
** Fixed auto selection of searchstring when not found. Added additional colors settings to manage unfound situations (See prefs colors)
** Various bugfix & improvements
*Quick updates to V1.4 & 2.6 (2006-06-07)
** Menu shortcut is now Alt+Down instead of Alt
** Added tooltip for reminding which options were chosen
** Added "Same genre" in context menus
*Version 1.4 (2006-06-04)
** Port of features from 2.0 to 2.6 in 1.4 (for foobar 0.8.3 users)
*Version 2.6 (2006-06-04)
** Added "Search as you type" option (for inline playlist search only)
** QuickFixed searchstring not reset properly after a successfull search (bug appeared in V2.5)
** QuickFixed tab key blocked from within control
** Prevented deletion of search results playlist when searching inline
** Fixed redrawing of frame style in prefs page
*Version 2.5 (2006-06-03)
** Added menu option, available through Alt Key
** Added options to override on the fly the "Search in ..." settings. Shift+Enter = Force search in playlist, Ctrl+Enter = Force search in all playlists, Ctrl+Shift+Enter=Force search in database.
*Version 2.4 (2006-06-03)
** Added an option to setfocus on the playlist window after a search (complete mouseless utilization is now possible)
** Implemented "Escape" key. Will set focus on the playlist window.
** New option to search "inline" when "playlist" is selected as the search domain (will highlight results in the current playlist, navigation is available through up and down arrow keys) .... mimics old playlistfind plugin
*Version 2.3 (2006-06-01)
** Hotfix : Search in "all playlist" was only searching in the last playlist
** Fixed text not scrolling when longer than the text box
** Prefs page now supports XP themes
** Fixed icon switch enabled/disabled spinbutton status
** Minor bugfix and improvement
*Version 2.2 (2006-05-28)
** Fixed text entry/display/overlapping selection problem
*Version 2.1 (2006-05-27)
** Fixed Tagz strings reset happening even when user cancels operation
** Better vertical sizing of search string area
** Changed Tagz string "Delete" button enabled/disabled state (only last remaining item can't be deleted)
*Version 2.0 (2006-05-27)
** Ported (from version 1.3) to Foobar 0.9 version
*Version 1.3 (2006-05-27)
** Added option to include %artist% in %album% search from context menu (fixes the "greatest hits" problem, requires a VA string to be entered)
** Added option to automaticall switch to extended search mode when a '%' char is entered in the searchstring (and back when none is present in the search string)
** Added option to override current settings with recall from history search
** Fixed toolbar disappearing under albumart
*Version 1.2 (2006-05-21)
** Context menu (and shortcuts) is now available through [context]Now Playing and Playlist entries
** New : Ability to load custom bitmaps (H=16, W= 20, .bmp only)
** New : Playlist_gen queries are now available (Credit to tbohrer for the search engine development)
** Fixed lowercased search strings when appended to playlist name
** New processing of history with memorization/recall of all variables
** Added customization of toolbar frame (None, Grey, Sunken)
** Restructured config. page & help, including playlist_gen syntax overview
* Version 1.1 (2006-05-16)
** Implemented hourglass
** Added repainting of icon during resizing
** Fixed possible vertical resizing (top right)
** Improved cursor management for resizing (top, bottom)
* Version 1.0 (2006-05-15)
** Implemented context menus to search for same Artist/Album/Title (search in database only and with "Exact" match ... will temporarily overide the current settings).
** Implemented toolbar resizing (horizontal only)
* Version 0.9.3 (2006-05-14)
** Fixed icons not displayed properly on Windows XP
** Centered vertically the test edit control
* Version 0.9 (2006-05-12)
** Added clickable search icon on the toolbar, customizable through the prefs; moved right click options (except undock) to icon standard click
** Added menu entry to access the preferences
** Minor bugfixes and improvements
** Increased max history size to 32
* Version 0.8 (2006-05-08)
** Added list of Tagz presets to choose from for searching
** Avoided duplicates in the history of search strings
** Reorganized prefs page
* Version 0.7 (2006-05-05)
** Added history of search strings with recall option (rightclick the toolbar)
** Fixed unwanted duplication of target playlist with different search strings
* Version 0.6 (2006-05-04)
** Added customized color scheme
** Fixed unwanted resizers appearing after undock
** Reorganized prefs page
* Version 0.5 (2006-05-01)
** New option to append the search string to the name of the target playlist
** Revisited the preferences dialog
** Changed the behavior when nothing is found (searchstring highlited, playlist selection unchanged)
** Added an option to reset the searchstring after a successfull search
* Version 0.4 (2006-05-01)
** Added ability to perform a search in all playlists (Search results playlist is excluded in this case)
** Undock function now fixed
** Added ability to search by prefix
** Code cleaned, reorg. and commented
* Version 0.3 (2006-04-27)
** Performance dramatically improved

==Links==
*[http://thx538.free.fr/Foobar/Quicksearch%20V2.x/foo_uie_quicksearch.zip Download v2.8g for foobar 0.9]
*[http://thx538.free.fr/Foobar/Quicksearch%20V1.x/foo_uie_quicksearch.zip Download v1.5g for foobar 0.8]
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=44012 Hydrogenaudio Thread]

Foobar2000:0.9 Quick Search (foo uie quicksearch)

2006-08-25T13:26:02Z

FofR: Added changelog

Derived from ''foo_uie_search''

[[Image:QuickSearch3.png|Quick Search]]

==Changelog==

* Versions 2.8g & 1.5g (2006-08-16)
**Search pattern is now selected when the toolbar receives focus
** Fixed unproper toolbar colors after undock when autosearch is selected (1.5g only)
* Versions 2.8f & 1.5f (2006-06-20)
** Reorganized code and fixed a bug (wrong search results happening in extremely rare circumstances with "Exact" mode)
* Versions 2.8e & 1.5e (2006-06-19)
** Improved reactiveness and speed of inline playlist search
** Added "Search for same/Directory" to context menu
*Version 1.5 (2006-06-16)
** Ported from 2.8 for Foobar 0.8.3
*Version 2.8 (2006-06-15)
** Added configurable delay for autosearch
** Reorganized prefs & help pages
*Version 2.7 (beta) (2006-06-11)
** New: Autosearch feature ... (for people too lazy to hit the Enter Key)
** New: Added option to manage preferences (record of favorites search)
** Fixed weird bug (search not working with searchstrings of length 12 or 26)
** Changed "override keys" settings (Now: Alt+Enter=All Playlist, Shift+Enter=Playlist,Ctrl+Shift+enter=DB, Alt+Keydown=Menu)
** Reorganized menu
** Fixed auto selection of searchstring when not found. Added additional colors settings to manage unfound situations (See prefs colors)
** Various bugfix & improvements
*Quick updates to V1.4 & 2.6 (2006-06-07)
** Menu shortcut is now Alt+Down instead of Alt
** Added tooltip for reminding which options were chosen
** Added "Same genre" in context menus
*Version 1.4 (2006-06-04)
** Port of features from 2.0 to 2.6 in 1.4 (for foobar 0.8.3 users)
*Version 2.6 (2006-06-04)
** Added "Search as you type" option (for inline playlist search only)
** QuickFixed searchstring not reset properly after a successfull search (bug appeared in V2.5)
** QuickFixed tab key blocked from within control
** Prevented deletion of search results playlist when searching inline
** Fixed redrawing of frame style in prefs page
*Version 2.5 (2006-06-03)
** Added menu option, available through Alt Key
** Added options to override on the fly the "Search in ..." settings. Shift+Enter = Force search in playlist, Ctrl+Enter = Force search in all playlists, Ctrl+Shift+Enter=Force search in database.
*Version 2.4 (2006-06-03)
** Added an option to setfocus on the playlist window after a search (complete mouseless utilization is now possible)
** Implemented "Escape" key. Will set focus on the playlist window.
** New option to search "inline" when "playlist" is selected as the search domain (will highlight results in the current playlist, navigation is available through up and down arrow keys) .... mimics old playlistfind plugin
*Version 2.3 (2006-06-01)
** Hotfix : Search in "all playlist" was only searching in the last playlist
** Fixed text not scrolling when longer than the text box
** Prefs page now supports XP themes
** Fixed icon switch enabled/disabled spinbutton status
** Minor bugfix and improvement
*Version 2.2 (2006-05-28)
** Fixed text entry/display/overlapping selection problem
*Version 2.1 (2006-05-27)
** Fixed Tagz strings reset happening even when user cancels operation
** Better vertical sizing of search string area
** Changed Tagz string "Delete" button enabled/disabled state (only last remaining item can't be deleted)
*Version 2.0 (2006-05-27)
** Ported (from version 1.3) to Foobar 0.9 version
*Version 1.3 (2006-05-27)
** Added option to include %artist% in %album% search from context menu (fixes the "greatest hits" problem, requires a VA string to be entered)
** Added option to automaticall switch to extended search mode when a '%' char is entered in the searchstring (and back when none is present in the search string)
** Added option to override current settings with recall from history search
** Fixed toolbar disappearing under albumart
*Version 1.2 (2006-05-21)
** Context menu (and shortcuts) is now available through [context]Now Playing and Playlist entries
** New : Ability to load custom bitmaps (H=16, W= 20, .bmp only)
** New : Playlist_gen queries are now available (Credit to tbohrer for the search engine development)
** Fixed lowercased search strings when appended to playlist name
** New processing of history with memorization/recall of all variables
** Added customization of toolbar frame (None, Grey, Sunken)
** Restructured config. page & help, including playlist_gen syntax overview
* Version 1.1 (2006-05-16)
** Implemented hourglass
** Added repainting of icon during resizing
** Fixed possible vertical resizing (top right)
** Improved cursor management for resizing (top, bottom)
* Version 1.0 (2006-05-15)
** Implemented context menus to search for same Artist/Album/Title (search in database only and with "Exact" match ... will temporarily overide the current settings).
** Implemented toolbar resizing (horizontal only)
* Version 0.9.3 (2006-05-14)
** Fixed icons not displayed properly on Windows XP
** Centered vertically the test edit control
* Version 0.9 (2006-05-12)
** Added clickable search icon on the toolbar, customizable through the prefs; moved right click options (except undock) to icon standard click
** Added menu entry to access the preferences
** Minor bugfixes and improvements
** Increased max history size to 32
* Version 0.8 (2006-05-08)
** Added list of Tagz presets to choose from for searching
** Avoided duplicates in the history of search strings
** Reorganized prefs page
* Version 0.7 (2006-05-05)
** Added history of search strings with recall option (rightclick the toolbar)
** Fixed unwanted duplication of target playlist with different search strings
* Version 0.6 (2006-05-04)
** Added customized color scheme
** Fixed unwanted resizers appearing after undock
** Reorganized prefs page
* Version 0.5 (2006-05-01)
** New option to append the search string to the name of the target playlist
** Revisited the preferences dialog
** Changed the behavior when nothing is found (searchstring highlited, playlist selection unchanged)
** Added an option to reset the searchstring after a successfull search
* Version 0.4 (2006-05-01)
** Added ability to perform a search in all playlists (Search results playlist is excluded in this case)
** Undock function now fixed
** Added ability to search by prefix
** Code cleaned, reorg. and commented
* Version 0.3 (2006-04-27)
** Performance dramatically improved

File:QuickSearch3.png

2006-08-25T13:17:46Z

FofR: Quick Search

Quick Search

Foobar2000:0.9 Quick Search (foo uie quicksearch)

2006-08-25T12:04:08Z

FofR: page created

Derived from ''foo_uie_search''

User:FofR

2006-08-25T11:59:17Z

FofR: Page created

Dedicated to making foobar information easier to find, I have wasted hours searching threads.

==Links==
[http://fofr.trivialbeing.net Blog]

Foobar2000:0.9 Winamp Spam (foo winamp spam)

2006-08-25T11:50:26Z

FofR: added description and download links

'''foo_winamp_spam''' emulates a Winamp 2.x window so existing plugins you have that use the '''Winamp API''' can continue to work with foobar2000 with minimal trouble.

=Description=
This component was primarily designed to be used in conjunction with an mIRC song reporting DLL, [http://www.r1ch.net/stuff/r1dll/ r1dll]. However it is known to work with several other software packages that use the Winamp API such as ''EvilLyrics''.

Foobar2000 0.9 support is currently in beta: [http://www.hydrogenaudio.org/forums/index.php?showtopic=42941 Hydrogenaduio Thread]

The component works primarily by creating a window with the Winamp 1.x classname and setting the current song title to it. This allows programs to find the Winamp window handle in order to send further messages. Currently a small subset of the full Winamp API is emulated, including play/pause/stop, add files, exit, repeat/shuffle, report song stats (kbps, khz, channels, duration, position) and a few other things.

The latest stable version is 0.74 and is designed to work on Windows 9x/ME/NT/2K/XP/2K3 through use of the utf8api.dll. Please note that this version requires foobar2000 version 0.7 or 0.8 to work. Previous versions used a foo_winamp_spam.cfg file - this has been obsoleted with the addition of a config page within fb2k itself. Please delete this file if you have it.

=Applications=

==Google Talk (Gtalk)==
The latest release of Gtalk (as of Aug 2006) includes the ability to display currently playing music and log this to your google account (if you want it to). The client natively supports Winamp, iTunes, WMP, etc. however lacks foobar2000 compatability. It is possible to use the '''foo_winamp_spam''' component to show songs foobar is playing: [http://www.hydrogenaudio.org/forums/index.php?showtopic=47155 Hydrogenaudio Discussion]

=Links=
*[http://www.r1ch.net/stuff/r1dll/ Homepage]
*[http://r-1.ch/foo_winamp_spam-0.9beta3.7z Download Foobar2000 0.9 Compatible Beta (7z compressed)]
*[http://www.r1ch.net/stuff/foobar/foo_winamp_spam-0.74.zip Download latest stable release (0.74) (9.33kb, released 29 January 2004) (Foobar 0.8)]

Foobar2000:0.9 Winamp Spam (foo winamp spam)

2006-08-25T11:34:48Z

FofR: Page created

==Links==
[http://www.r1ch.net/stuff/r1dll/ Homepage]

Foobar2000:Components/MSN Now Playing (alt) (foo msnalt)

2006-08-25T11:28:46Z

FofR: /* Description */

[[Image:Msnalt1.PNG|thumb]]
=Description=
'''MSN Now Playing''' (foo_msnalt) allows for showing the current song as your "Now Playing" personal status message in MSN Messenger version 7 or later and Windows Live Messenger.

=Link=
* [http://stephan.kochen.nl/proj/foobar2000.html#msn Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=31609&st=0 Discussion thread]
* [http://stephan.kochen.nl/proj/foo_msnalt/foo_msnalt.dll Download link]
* [http://stephan.kochen.nl/proj/foo_msnalt/foo_msnalt.cpp Source Code]

[[Category: Other components]]
[[Category: Notifier]]

Foobar2000:Components/MSN Now Playing (alt) (foo msnalt)

2006-08-25T11:27:29Z

FofR: /* Link */ added source code link

[[Image:Msnalt1.PNG|thumb]]
=Description=
* Allows for showing the current song as your "Now Playing" personal status message in MSN Messenger version 7 or later and Windows Live Messenger.

=Link=
* [http://stephan.kochen.nl/proj/foobar2000.html#msn Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=31609&st=0 Discussion thread]
* [http://stephan.kochen.nl/proj/foo_msnalt/foo_msnalt.dll Download link]
* [http://stephan.kochen.nl/proj/foo_msnalt/foo_msnalt.cpp Source Code]

[[Category: Other components]]
[[Category: Notifier]]

Foobar2000:Components/Album Art Panel (foo uie albumart)

2006-08-25T11:24:01Z

FofR: format

Album Art Panel is a component for foobar2000 and Columns UI that displays album art in a panel. When configured, it can display any image you would like to associate with a track.

[[Image:Albumartpannel.PNG|thumb]]

==Features==
*Configurable sources list allows cycling of multiple images for a single track
*Allows title-formatting and wildcards to specify image file location
*Minimum height setting to assist with layouts
*Configurable resizing of album art to fit panel size
*Fading transitions between album art
*Configurable actions when panel is left-clicked, double-clicked, and middle-clicked.
*Can display album art for either the currently playing track or the currently selected track
*Can automatically cycle through source list during playback

==Reading Embedded Album Art==

Album Art Panel does not support reading album art which has been embedded as a tag (for example, as an ID3v2 tag in an MP3).

=Sources List=
The sources list allows you to use [[Foobar2000:Titleformat_Reference|titleformatting scripts]] to specify exactly where Album Art Panel will look for image files. In order to learn how to use the sources list, let's look at an example:

$replace(%_path%,%_filename_ext%,)folder.jpg
-$replace(%_path%,%_filename_ext%,)*
--components\default.png
C:\Music\Arts\%artist% %album%*
--components\default.png

The sources list is organized into groups, based on which lines have a '-' in front of them. Each line that does not start with a '-' is the beginning of a new source group. A line which starts with '-' is part of the same source group as the line above it. In the example above, there are two source groups. The first source group consists of the first three lines and the second group consists of the last two lines.

The "Next Source" action (by default, left-clicking on the panel) will cycle forward through the source groups. Similarily, the "Previous Source" action will cycle backwards through the source groups.

The prefix "--" (two hypens) is used to indicate a "No Cover" image. A "No Cover" image is essentially a default image which will be shown if no other matches can be found. When automatic cycling is enabled, "No Cover" images will be skipped.

The wildcard '*' can be used in place of one or any number of characters and '?' can be used in place of any single character. For instance, the second line of the example above tells Album Art Panel to look for any file it can display in the same directory as the track. Album Art Panel will display the first image which matches the pattern. Characters in tags that are not allowed in filenames will be replaced with the '?' wildcard.

''(Note: The "match:" prefix is obsolete. Since version 0.160, the "match:" prefix is ignored, and "-match:" is treated like "-". The wildcards '*' and '?' can be used in any source string.)''

Album Art Panel will first look for an image at the location indicated in the first line of a source group. If the image indicated by the first line cannot be found, Album Art Panel will look at subsequent lines within the same source group and display the first image which can be found. If no image within a source group can be found, Album Art Panel will try to display the next source group instead. If none of the source groups can be found, the display will be blank.

=Link=
* [http://cherans.bol.ucla.edu/fooplugins.html Website and Download]
* [http://eolindel.free.fr/foobar0.9/albumart.shtml Unofficial User Manual]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=39924 Discussion Thread] [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=39924&view=findpost&p=404265 (Current version)]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=34341 No-Cover Image Thread]

[[Category: Columns UI]]

Foobar2000:0.9 CwBowron's Title formating (foo cwb hooks)

2006-08-24T14:52:09Z

FofR: /* Description */ Added latest functions

'''foo_cwb_hooks''' adds various functions and variables to global title formatting.<br>
'''Download:''' [http://foobar.bowron.us/foo_cwb_hooks.zip foo_cwb_hooks.zip]

=Description=

==Functions==
*$cwb_urldecode / $cwb_httpclean - decodes characters in URLs
*$cwb_removethe - removes The and A at the beginning of a string
*$cwb_ltrim - example: $cwb_ltrim(%artist%,The) $cwb_ltrim(%artist%,The ,A ,La )
*$cwb_datediff(d1,d2) - number of days between two dates in the format yyyy-mm-dd or yyyy-mm-dd hh:mm:ss

==Variables==
*%cwb_systemdate% - date in the formay yyyy-mm-dd
*%cwb_systemdatetime% - date and time in the format yyyy-mm-dd hh:mm:ss
*%cwb_activelist% - active playlist name
*%cwb_activelist_count% - number of items in the active list
*%cwb_playinglist% - playing playlist name
*%cwb_playinglist_count% - number of items in the playing list
*%cwb_queueindex% - queueindex if in the queue, false otherwise
*%cwb_queueindexes% - indices of the item in the queue, false otherwise
*%cwb_queuelength% - length of the queue
*%cwb_queue_end_playlist% - playlist of the last item in the queue

==Known Bugs==
*%cwb_playinglist% and %cwb_activelist% changes won't refresh in displays

==Feature Requests==

* Add variables for the following:
**length of active playlist and playing list
**%_playbackorder%
**%_replaygain_mode% - not really possible
**%_database% - gives back if a file belongs to database or not
***not easily possibe because you cannot use SDK functions in the title formatting callback
***only way I could see to do it is to cache the library and test against that
**%_added% - timestamp when a file was added to database
***not really possible - timestamp is not stored when added when added to library
***could be possible with a plugin that stores the date added to the library
***library_callback implementing on_items_added() to store timestamps

==Useful Strings==

'Played Today', 'Played Yesterday', 'Played n days ago' or 'No last played info'

$if(%last_played%, $puts(diff,$cwb_datediff(%last_played%,%cwb_systemdate%)) Played $ifgreater(1,$get(diff),Today, $ifgreater(2,$get(diff),Yesterday, $get(diff) days ago)), No last played info)

=Link=
* [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43606&hl=foo_cwb_hooks Discussion thread]

[[Category: Other components]]
[[Category: Library tools]]