Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Components/ABX Comparator (foo abx)

2014-01-26T21:36:31Z

Neptune: Undo revision 25596 by 178.26.97.174 (talk)

{{stub}}

== Description ==
Allows users to perform a double-blind listening test between two tracks.

== Usage ==
# [[Foobar2000:How_to_install_a_component|Install]] the component
# Select two files in the playlist
# Right click - Utilities - ABX Two Tracks...

== Links ==
[http://en.wikipedia.org/wiki/ABX_test ABX test - Wikipedia]

Foobar2000:Foobar2000

2013-02-12T19:29:43Z

Neptune: /* External Guides */

{{title|foobar2000}}

{{Software Infobox|
|name = foobar2000
|logo = [[Image:foobar2000 Logo.png|48px]]
|screenshot = [[Image:Foobar2000-1.0-default-ui.png|250px]]
|caption = Screenshot of foobar2000 v1.0 using the default user interface
|maintainer = Peter Pawlowski
|stable_release = v1.2.2
|preview_release = v1.2.3 beta 3
|operating_system = Windows
|use = Media Player
|license = Proprietary, BSD
|website = [http://www.foobar2000.org/ www.foobar2000.org]
}}

'''foobar2000''' is an advanced freeware audio player for the Windows platform. Some of the basic features include full unicode support, ReplayGain support and native support for several popular audio formats.

'''The latest stable version is:''' [http://www.foobar2000.org/download v1.2.2]

'''The latest preview version is:''' [http://www.foobar2000.org/download v1.2.3 beta 3] (2013-02-09)

== Platforms ==

foobar2000 has been written specifically for the Windows platform, and there are no plans to port it to any others. However, although not officially supported, it is known to run on [http://www.hydrogenaudio.org/forums/index.php?showtopic=54933 Linux] and [http://www.hydrogenaudio.org/forums/index.php?showtopic=77261 Mac OS X] through Wine and WineBottler, respectively.

== Features ==
* Powerful open component architecture allowing third-party developers to extend functionality of the player, including the ability to fully replace the user interface.
* Full Unicode support: File names, user interface, tagging, etc.
* [[ReplayGain]] support: Both playback and writing ReplayGain information to file tags.
* [[Gapless playback]].
* Advanced [[tagging]] capabilities - through built-in [[foobar2000:Properties|Properties dialog]] and various optional tagging-related components.
* Built-in [[foobar2000:Preferences:Media Library|Media Library]] functionality.
** Intuitive [[foobar2000:Query syntax|query syntax]] for searching the Media Library.
** [[foobar2000:Autoplaylist|Autoplaylist]] support: Generate dynamically updating playlists based on queries.
* [[foobar2000:Preferences:General:Keyboard Shortcuts|Customizable keyboard shortcuts]].
* Support for transcoding all supported audio formats using the [[Foobar2000:Converter|Converter component]] (requires external command-line encoder executables for different output formats).
* [[Secure_ripping|Secure]] [[foobar2000:Ripping CDs|CD ripping]].
* Streaming support.
* Efficient handling of large playlists.
* [[foobar2000:Components/Default_user_interface_%28foo_ui_std%29|User interface]] with simple configuration to create even complex layouts quickly and easily.
* Highly customizable display of track information using [[foobar2000:Titleformat_Introduction|title formatting scripts]].

==Supported audio formats==
Natively supported ("out-of-the-box"):
* [[MP1]], [[MP2]], [[MP3]], [[MP4]], [[Musepack]], [[AAC]], [[Ogg Vorbis]], [[FLAC]] / Ogg FLAC, [[Speex]], [[WavPack]], [[WAV]], [[AIFF]], [[AU|AU/SND]], [[CDDA]], [[WMA]], [[Matroska]], [[ALAC]], [[MMS]], [[RSTP]], [[Opus]].
Supported through optional components:
* [[TTA]], [[Monkey's Audio]], [[MOD]], [[SPC]], [[Shorten]], [[OptimFROG]], [[AC3]], [[DTS]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[TAK]], [[AMR]], ''etc.''

In addition, foobar2000 can also play audio files within ZIP and RAR archives (typically compressed) directly, ''i.e.'' without requiring the user to extract the files first. More archive formats are supported ''via'' additional components: [http://www.foobar2000.org/components/view/foo_unpack_lha LHA/LZH], [http://www.foobar2000.org/components/view/foo_unpack_7z 7-Zip], [http://kode54.foobar2000.org/ JMA]

== Using foobar2000 ==

=== Important pages ===
* [http://www.foobar2000.org/FAQ foobar2000 FAQ]
* [[foobar2000:components|foobar2000 Components]]
* [[foobar2000:Encouraged Tag Standards|foobar2000 Encouraged Tag Standards]]
* [[foobar2000:FAQ|foobar2000 FAQ (unofficial)]]
* [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)]

=== Specific guides ===

'''Preferences'''
* [[foobar2000:Preferences|Preferences dialog]]

'''Metadata'''
* [[foobar2000:Properties|Tag editing: the Properties dialog]]
* [[foobar2000:Query syntax|Query Syntax]]: details of Syntax for querying metadata.

'''Title formatting'''
* [[foobar2000:Title Formatting Introduction|Introduction to titleformat scripts]]
* [[foobar2000:Title Formatting Reference|Titleformat Reference]]: reference guide to all fields and functions
* [[foobar2000:Titleformat Examples|Titleformat Examples]]: user-submitted code for various purposes; submit your own!

'''Others'''
* [[foobar2000:File operations|File operations dialog]]: move, copy, rename, and delete files from within foobar2000
* [[foobar2000:Commandline Guide|Commandline usage]]

=== External Guides ===
* [http://www.audiohq.de/viewforum.php?id=27 German-language guides]
* [http://foobar2000.xrea.jp/ fb2k Wiki Page] for Japanese users.
* [http://winamp2foobar.blogspot.com Winamp To Foobar Guide] with information relevant for general users also.

=== Technical information ===
* [[foobar2000:ID3 Tag Mapping|ID3 Tag Mapping]]
* [[foobar2000:Metadata Compatibility|Metadata Compatibility]]: information about compatibility with metadata written by other applications

== Important Links ==
=== Official Site ===
* [http://www.foobar2000.org foobar2000.org: Homepage]
* [http://www.foobar2000.org/download foobar2000.org: Download]
* [http://www.foobar2000.org/components foobar2000.org: Components]

=== Community ===
* Official IRC Channel: #foobar2000 on [http://freenode.net/ freenode]
* [http://forums.foobar2000.org/ Official foobar2000 forum]
* [http://foobar-users.de/ German Support Forum]
* [http://foobar2000.pl/ Polish Support 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=61333 Default UI .fth Thread] Fast way to clone another's DUI Configuration.
* [[foobar2000:Preferences:Columns UI/Appearance|Columns UI appearance customization guides]]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=31027 Columns UI configurations]

[[Category:foobar2000]]
[[Category:Media Players|foobar2000]]
[[Category:CD Rippers]]
[[Category:Software]]
[[Category:Tag editors]]

File:Foobar2000-SimPlaylist-Groups-v3.png

2011-09-04T18:29:45Z

Neptune: uploaded a new version of "File:Foobar2000-SimPlaylist-Groups-v3.png"

File:Foobar2000-SimPlaylist-Groups-v2.png

2011-09-04T18:29:39Z

Neptune: uploaded a new version of "File:Foobar2000-SimPlaylist-Groups-v2.png"

File:Foobar2000-SimPlaylist-Groups-v1.png

2011-09-04T18:28:57Z

Neptune: uploaded a new version of "File:Foobar2000-SimPlaylist-Groups-v1.png"

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:05:40Z

Neptune: /* Search */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|Playlist search]]
SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:05:31Z

Neptune: /* Usage */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

|[[Image:Foobar2000-SimPlaylist-Search.png|thumb|Playlist search]]
SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:05:20Z

Neptune: /* Screenshots */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:04:52Z

Neptune: /* Screenshots */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|[[Image:Foobar2000-SimPlaylist-Search.png|thumb|none|Playlist search]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:04:40Z

Neptune: /* Search */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T18:03:55Z

Neptune: /* Manual integration */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Layout===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T17:49:52Z

Neptune: /* Usage */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T17:46:39Z

Neptune: /* Screenshots */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-09-04T17:46:19Z

Neptune:

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Screenshots==

{| border="0" cellpadding="0" cellspacing="0"
|[[Image:Foobar2000-SimPlaylist-Groups-v1.png|thumb|none|Artist - album / cover]]
|[[Image:Foobar2000-SimPlaylist-Groups-v2.png|thumb|none|Artist / cover + album info]]
|[[Image:Foobar2000-SimPlaylist-Groups-v3.png|thumb|none|Artist / cover / album]]
|}

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

File:Foobar2000-SimPlaylist-Groups-v3.png

2011-09-04T17:42:21Z

Neptune:

File:Foobar2000-SimPlaylist-Groups-v2.png

2011-09-04T17:42:14Z

Neptune:

File:Foobar2000-SimPlaylist-Groups-v1.png

2011-09-04T17:41:58Z

Neptune:

Foobar2000:Default User Interface:List of UI Elements

2011-08-27T06:20:39Z

Neptune: /* Third-party UI Elements */

This page lists available UI Elements for use with foobar2000's [[Foobar2000:Components_0.9/Default_user_interface_%28foo_ui_std%29|Default User Interface]].

== Bundled UI Elements ==
The following UI elements are bundled with official installer and they are always available unless noted.

=== Containers ===
* '''Splitter (left/right or top/bottom)'''
A simple container which divides its area to two panes horizontally or vertically. The child elements can be resized by dragging the border between them. Moreover, size of each side can be locked, so that it will stay the same when the whole window is resized - this feature is available in splitter's popup menu.
* '''Tabs'''
This container uses the well-established concept of a tabbed document. It can have any number of pages, each page containing another child element(s). The popup menu have commands to add, remove, rename and reorder the individual tabs.
* '''Playlist Tabs'''
A tabbed container automatically populated with tabs corresponding to available playlists. Note that the child area is the same regardless of the active tab (playlist). Commonly used to host a "Playlist view" element.
* '''Toolbar Header'''
Shows a toolbar which can be filled with various buttons and controls, configurable in its popup menu. Additional options include whether to be shown at the top or bottom of assigned area, or if the toolbar should be locked to avoid rearranging the items. It can contain only one static child element.

=== Media Library Viewers ===
* '''Album List''' ''(available if selected during installation)''
UI element version of the Album List viewer, as available in the "Main menu > Library > Album List".
* '''Media Library Search'''
UI element version of the Media Library search, as available in the "Main menu > Library > Search".

=== Playback Visualisation ===
* '''Oscilloscope'''
* '''Peak Meter'''
* '''Spectrogram'''
* '''Spectrum'''
* '''VU Meter'''
Various visualisations providing some graphical feedback. Most of them have their additional style, color or quality settings available in their popup menu.

=== Playlist Renderers ===
* '''Playlist View'''
Shows items of currently active playlist. Note that any number of "Playlist View" elements will all show the same content. Format of displayed columns and item grouping can be customized.

=== Selection Information ===
* '''Album Art Viewer'''
Shows album (cover) art image for the selected or currently playing track. Looks both for embedded images in the file itself and in its folder.
* '''Selection Properties'''
An element capable of displaying various information about the selected track(s). Popup menu allows customization of what kind of information to show.

=== Utility ===
* '''Console'''
UI element version of the Console window, as available in the "Main menu > View > Console".
* '''Equalizer'''
UI element version of the Equalizer window, as available in the "Main menu > View > Equalizer".
* '''Playlist Manager'''
UI element version of the Playlist Manager window, as available in the "Main menu > View > Playlist Manager".

== Third-party UI Elements ==
The components providing these UI elements must be installed separately before use. See their respective article for more information.

* [[Foobar2000:Components_0.9/Facets_%28foo_facets%29|Facets (foo_facets)]] – Flexible media library viewer based on linked lists.
* [[Foobar2000:Components_0.9/Infospect_%28foo_infospect%29|Infospect (foo_infospect)]] – Displays low level playback information.
* [[Foobar2000:Components/Playlist_Organizer_(foo_plorg)|Playlist Organizer (foo_plorg)]] – Advanced playlist manager to organize playlists in a treeview.
* [[Foobar2000:Components/Podcatcher_(foo_podcatcher)|Podcatcher (foo_podcatcher)]] – A component for subscribing to, downloading, and playing RSS and Atom podcast feeds in foobar2000.
* [[Foobar2000:Components/Queue_Contents_Editor_(foo_queuecontents)|Queue Contents Editor (foo_queuecontents)]] – Enables the user to edit and view playback queue contents.
* [[Foobar2000:Components/Quicksearch_UI_Element_(foo_quicksearch)|Quicksearch UI Element (foo_quicksearch)]] – Basic search toolbar that will send results of the search to a playlist of your choice.
* [[Foobar2000:Components_0.9/Screen_Saver_Host_%28foo_vis_screensaver%29|Screen Saver Host (foo_vis_screensaver)]] – Displays a screen saver inside foobar2000 main window.
* [[Foobar2000:Components_0.9/Shpeck_%28foo_vis_shpeck%29|Shpeck (foo_vis_shpeck)]] – Allows running Winamp visualisations embedded into the player's window.
* [[Foobar2000:Components/SimPlaylist (foo_simplaylist)|SimPlaylist (foo_simplaylist)]] Playlist view with album art.
* [[Foobar2000:Components/SimPlaylist Manager (foo_simplaylist_manager)|SimPlaylist Manager (foo_simplaylist_manager)]] Playlist manager replacement with additional columns.
* [[Foobar2000:Components_0.9/Text_Display_%28foo_textdisplay%29|Text Display (foo_textdisplay)]] – Displays information about the playing or selected track.
* [[Foobar2000:Components/UPnP/DLNA_Renderer,_Server,_Control_Point_(foo_upnp)|UPnP/DLNA Renderer, Server, Control Point (foo_upnp)]] – Browser and controller elements for working with UPnP/DLNA devices.
* [[Foobar2000:Components/Waveform_Seekbar_(foo_wave_seekbar)|Waveform Seekbar (foo_wave_seekbar)]] – Provides seekbar functionality on top of a pretty image of a waveform of the currently playing song.

Foobar2000:Components/Facets (foo facets)

2011-08-18T17:26:18Z

Neptune: /* Panes */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one. The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements.

Panes can be arranged next or below each other. To toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple predefined filters. Once a filter has been selected, the button can be clicked to quickly disable or re-enable it. Some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] (e.g. Ctrl+F) to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. By default, to prevent selection changes from interrupting playback, this playlist is preserved if the playing track is no longer selected, and the selection is sent to a new playlist instead.
Note: Settings at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] are ignored.

===Double-click action===
The double-click action is automatically locked if the library selection playlist is used. It is only configurable when the selection action is set to "None".

===Middle-click action===
By default, middle-clicking is used for scrolling, but can be assigned to other actions.

===Creating autoplaylists===
To create an autoplaylist, right-click on a list selection, or, if available, open the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option, unless the filter or search query includes a SORT BY or SORT DESCENDING BY statement.

===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar has to be activated. When closing the window, a dialog asks if the changes should be saved.

===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Selection and focus changes are applied to the current playlist.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-18T17:25:34Z

Neptune: /* Panes */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one. The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements.

Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple predefined filters. Once a filter has been selected, the button can be clicked to quickly disable or re-enable it. Some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] (e.g. Ctrl+F) to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. By default, to prevent selection changes from interrupting playback, this playlist is preserved if the playing track is no longer selected, and the selection is sent to a new playlist instead.
Note: Settings at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] are ignored.

===Double-click action===
The double-click action is automatically locked if the library selection playlist is used. It is only configurable when the selection action is set to "None".

===Middle-click action===
By default, middle-clicking is used for scrolling, but can be assigned to other actions.

===Creating autoplaylists===
To create an autoplaylist, right-click on a list selection, or, if available, open the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option, unless the filter or search query includes a SORT BY or SORT DESCENDING BY statement.

===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar has to be activated. When closing the window, a dialog asks if the changes should be saved.

===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Selection and focus changes are applied to the current playlist.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:56:52Z

Neptune:

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple predefined filters. Once a filter has been selected, the button can be clicked to quickly disable or re-enable it. Some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] (e.g. Ctrl+F) to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. By default, to prevent selection changes from interrupting playback, this playlist is preserved if the playing track is no longer selected, and the selection is sent to a new playlist instead.
Note: Settings at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] are ignored.

===Double-click action===
The double-click action is automatically locked if the library selection playlist is used. It is only configurable when the selection action is set to "None".

===Middle-click action===
By default, middle-clicking is used for scrolling, but can be assigned to other actions.

===Creating autoplaylists===
To create an autoplaylist, right-click on a list selection, or, if available, open the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option, unless the filter or search query includes a SORT BY or SORT DESCENDING BY statement.

===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar has to be activated. When closing the window, a dialog asks if the changes should be saved.

===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Selection and focus changes are applied to the current playlist.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:43:31Z

Neptune: /* Playlist interaction */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple predefined filters. Once a filter has been selected, the button can be clicked to quickly disable or re-enable it. Some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] (e.g. Ctrl+F) to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. By default, to prevent selection changes from interrupting playback, this playlist is preserved if the playing track is no longer selected, and the selection is sent to a new playlist instead.
Note: Settings at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] are ignored.

===Double-click action===
The double-click action is automatically locked if the library selection playlist is used. It is only configurable when the selection action is set to "None".

===Middle-click action===
By default, middle-clicking is used for scrolling, but can be assigned to other actions.

===Creating autoplaylists===
To create an autoplaylist, right-click on a list selection, or, if available, open the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option, unless the filter or search query includes a SORT BY or SORT DESCENDING BY statement.

===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar has to be activated. When closing the window, a dialog asks if the changes should be saved.

===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Selection and focus changes are applied to the current playlist.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:31:15Z

Neptune: /* Toolbar */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple predefined filters. Once a filter has been selected, the button can be clicked to quickly disable or re-enable it. Some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] (e.g. Ctrl+F) to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:26:35Z

Neptune: /* Layout */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

{| class="wikitable"
|-
!width="125"|Toolbar
!Remarks
|-
|Source
|Toggles between browsing the media library and the current playlist. Can be set to "automatic" to display the playlist by default, and to switch to the library if the library selection playlist is active.
|-
|Filter
|Filters panes according to one or multiple selected criteria. Once a filter has been selected, the button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
|-
|Search
|Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.
|-
|Search results
|Displays a menu for filter or search results. When browsing the library, clicking the button has the same effect as the double-click action defined at Preferences, Media Library, Facets. For playlists, it plays the first track in the search results.
|-
|Search help
|Opens query syntax reference in the browser.
|-
|Layout editing mode
|Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
|}

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:12:35Z

Neptune:

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Facets 1.0 release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]
* [[Foobar2000:Components/Facets (foo_facets)/Release notes|Release notes]]
* [[Foobar2000:Components/Facets (foo_facets)/Change log|Change log]]

Foobar2000:Components/Facets (foo facets)/Change log

2011-08-17T22:11:14Z

Neptune: Created page with "{{fb2k}} Facets (foo facets) ==Change log== ===1.0=== User interface: * New Album art display modes * Themed selection style with de…"

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

Foobar2000:Components/Facets (foo facets)/Release notes

2011-08-17T22:09:26Z

Neptune: Created page with "{{fb2k}} Facets (foo facets) ==Facets 1.0 release notes== ===Upgrading from older versions=== All settings should be carried over to…"

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

Foobar2000:Components/Facets (foo facets)

2011-08-17T22:03:28Z

Neptune: /* Playback statistics */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added.
|-
|First played
|First time a track has been played.
|-
|Last added
|Last time a track has been added.
|-
|Last played
|Last time a track has been played.
|-
|Played
|Number of times a track has been played.
|-
|Played duration
|Sum over products of duration and play count. Note that while playback statistics counts tracks as played after one minute, this counts tracks as fully played each time, even if playback was stopped before the track finished playing.
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:58:01Z

Neptune: /* Panes */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another; to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:51:27Z

Neptune: /* Panes */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be inserted before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:50:23Z

Neptune: /* Panes */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Panes layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:26:14Z

Neptune: /* Toolbar */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:25:48Z

Neptune: /* Toolbar */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T21:25:24Z

Neptune:

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Columns preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T21:24:00Z

Neptune: /* Custom columns */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|Custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T21:23:46Z

Neptune: /* Custom columns */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist custom columns]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T21:05:59Z

Neptune:

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

===Search===

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist columns preferences]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T21:03:13Z

Neptune: /* Search */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist columns preferences]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Search==

[[Image:Foobar2000-SimPlaylist-Search.png|thumb|SimPlaylist search]]

SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

File:Foobar2000-SimPlaylist-Search.png

2011-08-17T21:02:14Z

Neptune:

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T21:01:06Z

Neptune: /* Groups */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist columns preferences]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==

[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v1.png|thumb|Artist - album / cover]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v2.png|thumb|Artist / cover + album info]]
[[Image:Foobar2000-SimPlaylist-Preferences-Groups-v3.png|thumb|Artist / cover / album]]

Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Search==
SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

File:Foobar2000-SimPlaylist-Preferences-Groups-v3.png

2011-08-17T20:59:52Z

Neptune:

File:Foobar2000-SimPlaylist-Preferences-Groups-v2.png

2011-08-17T20:59:43Z

Neptune:

File:Foobar2000-SimPlaylist-Preferences-Groups-v1.png

2011-08-17T20:59:30Z

Neptune:

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T20:55:16Z

Neptune: /* Default columns */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist columns preferences]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==
Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Search==
SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

Foobar2000:Components/SimPlaylist (foo simplaylist)

2011-08-17T20:54:07Z

Neptune: /* Custom columns */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

==Usage==
===Save the current playlist configuration===
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.


===Manual integration===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] to manually add SimPlaylist as a UI element. For example, right-click on the current playlist view, choose Replace UI Element, and select SimPlaylist from the list of elements.

==Columns==
===Default columns===
Several columns are included by default, some of which do not have a corresponding title formatting pattern:
{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Album
|%album%
|-
|Artist
|%artist%
|-
|Codec
|[%codec%]
|-
|Date
|[%date%]
|-
|Duration
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time. Pattern: [%playback_time%]$if($and(%playback_time%,%length%), / )[%length%]
|-
|Playing
|Displays playback status icon.
|-
|Rating
|Displays clickable metadata rating.
|-
|Title
|%title%
|-
|Title / track artist
|%title%[ '('%track artist%')']
|-
|Track
|[%tracknumber%]
|}

===Playback statistics columns===
The following columns require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="120"|Name
! Pattern / remarks
|-
|Played
|[%play_count%]
|-
|Rating (database)
|Displays clickable rating from playback statistics database.
|}

===Custom columns===
[[Image:Foobar2000-SimPlaylist-Preferences-Columns.png|thumb|SimPlaylist columns preferences]]

Custom columns based on [[Foobar2000:Title_Formatting_Introduction|title formatting]] can be added at Preferences, Display, SimPlaylist.

====Column colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Automatic column resizing===
Columns are automatically resized to use the full width. To avoid frequent readjustments, columns named *album*, *artist*, or *title* are resized if present, while others keep their current size.

==Groups==
Playlist tracks are grouped by comparing each track with the next one according to a [[Foobar2000:Title_Formatting_Introduction|title formatting]] pattern. If the results differ, a group is inserted into the playlist. Groups are not displayed if the pattern returns an empty result, unless tracks need to be separated from a previous group on the same level. Groups do not change the order of playlist items.

===Presets===
* Group presets include group headers, a group column, and subgroups.
* Presets can be edited from the context menu (i.e. right-click in the presets list).
* Checked presets appear in the Groups context menu.

===Group headers===
* Headers display text and a separating line, with an optional image at the left.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.

===Group column===
* Displays album art, text, or both in separate columns at the left side.
* New lines can be inserted with the | character.
* Image sizes change with the column width.
* Only one column pattern can be added for each group preset.

====Sorting pattern====
This pattern is used to sort the playlist when clicking on a group column.

===Subgroups===
* Subgroups are listed within the tracks next to group columns.
* The default [Disc %discnumber%] subgroups are only displayed for albums with discnumbers.
* The image size is the same as for headers.

===Group statistics===
The following title formatting fields can be used in the group patterns to display statistics for all tracks contained in a group. Their results are ignored when comparing tracks to determine groups.

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%bitrate%
|Average bitrate.
|-
|%filesize%
|Total size in bytes.
|-
|%filesize_natural%
|Total size, automatically formatted in appropriate units such as MB or GB.
|-
|%first_release%
|First date or release date from metadata.
|-
|%items%
|Number of group tracks.
|-
|%last_modified%
|Last time a track has been modified.
|-
|%last_release%
|Last date or release date from metadata.
|-
|%length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%length_seconds%
|Total length in seconds.
|-
|%lossless_ratio%
|Number of lossless tracks, in percent without %.
|-
|%rating%
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|-
|%replaygain_track_peak%
|Highest peak of ReplayGain-scanned tracks.
|}

===Group playback statistics===
The following fields require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

{| class="wikitable"
|-
!width="175"|Field
! Description
|-
|%first_added%
|First time a track has been added.
|-
|%first_played%
|First time a track has been played.
|-
|%last_added%
|Last time a track has been added.
|-
|%last_played%
|Last time a track has been played.
|-
|%play_count%
|Total play count.
|-
|%played_length%
|Total played length, formatted as [hh:]mm:ss.
|-
|%played_length_seconds%
|Total played length in seconds.
|-
|%rating%
|Average rating from database or metadata, as number from 1 to 5.
|-
|%rating_stars%
|Same as above, formatted as up to five stars, e.g. ★★★
|-
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|}

===Group colors===
Groups use the [[Foobar2000:Preferences:Default_User_Interface:Colors_and_Fonts|default highlight color]]. < and > characters can be used to dim individual parts, similar to [[#Column_colors|column colors]].

===Album art===
To display album art in group headers, columns, or subgroups:
# Open Preferences, Display, SimPlaylist, Groups.
# Select a grouping preset.
# Click into the display column of a header, column, or subgroup.
# Make sure Image/Text is selected.
# Select one of artist, front, back, or disc image types.
# Press Apply or OK to save the changes.

* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Header and subgroup images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* Column images can be resized by changing the column width.

==Search==
SimPlaylist includes a second UI element that acts as a playlist search. It can be opened via Edit, Search (F3) or embedded into the user interface.

==Links==
* [http://www.foobar2000.org/components/view/foo_simplaylist Official website]

File:Foobar2000-SimPlaylist-Preferences-Columns.png

2011-08-17T20:53:52Z

Neptune:

Foobar2000:Components/Facets (foo facets)

2011-08-17T20:32:45Z

Neptune: /* Search help */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Facets toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Facets filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Facets preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

Foobar2000:Components/Facets (foo facets)

2011-08-17T20:30:53Z

Neptune: /* Toolbar */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar-Layout.png|thumb|Facets toolbar layout editing]]
[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Facets filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens the query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Facets preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]

File:Foobar2000-Facets-Toolbar-Layout.png

2011-08-17T20:29:53Z

Neptune:

Foobar2000:Components/Facets (foo facets)

2011-08-17T20:20:28Z

Neptune: /* Search */

{{fb2k}}
[[Category:Foobar2000 3rd-Party Components|Facets (foo facets)]]

Media library viewer with multiple columns, album art, statistics, and search functions.

* [[#Facets_1.0_release_notes|Facets 1.0 release notes]]
* [[#Change_log|Facets 1.0 change log]]

==Usage==

===Integrate into the user interface===
Enable the [[Foobar2000:Layout Editing Mode|layout editing mode]] at "View", "Layout" to manually add Facets as a UI element.

===Popup window===
Choose "Facets" from the "Library" menu to open it in a new window.
If a Facets UI element has already been integrated into the user interface, this will focus the existing instance. Hold Shift when selecting the menu item to force open a new window. Note that in order to edit the layout, Facets' own layout editing mode toolbar will have to be enabled.

==Layout==
===Panes===

[[Image:Foobar2000-Facets-Panes-Layout.png|thumb|Facets layout editing]]

By default, Facets is split into three panes. By enabling the [[Foobar2000:Layout Editing Mode|layout editing mode]] and right-clicking on one of them, panes can be removed, and new panes can be insert before or appended after the selected one.

The cut, copy, and paste commands can be used to reorder panes, or to transfer them between different Facets UI elements. Panes can be arranged next or below to another, to toggle the orientation, right-click on one of the splitters between two panes while in layout editing mode, and select "horizontal" or "vertical".

===Toolbar===

[[Image:Foobar2000-Facets-Toolbar.png|none|frame|Facets toolbar]]

To control the toolbar, enable the layout editing mode, and right-click on it.
* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
* Unchecking "Show the toolbar" disables the toolbar entirely.
* To restore the toolbar, right-click on one of the splitters between two panes, and re-enable "Show the toolbar".

====Source====
Toggles between browsing and searching in the contents of the media library and the current playlist. Can be set to automatic to display the playlist by default, and to switch to the library if the library selection playlist is active.

====Filter====

[[Image:Foobar2000-Facets-Preferences-Filters.png|thumb|Facets filters preferences]]

Selects one or multiple frequently used searches. Panes are automatically filtered according to the results. Once a filter has been selected, the toolbar button can be clicked to quickly enable or disable it. Note that some predefined filters require the [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].

====Search====

Filters panes based on a [[Foobar2000:Query_syntax|query]]. To focus the search box, press F3 from a Facets pane, or assign a [[Foobar2000:Preferences:General:Keyboard_Shortcuts|keyboard shortcut]] like Ctrl+F to [main] / Library / Facets.

====Search results====
Click on the dropdown button to display a menu for filter and search results. When browsing the library, the default action is the same as the double-click action, which can be configured at Preferences, Media Library, Facets. For playlists, clicking on the button starts playback of the first track in the search results.

====Search help====
Opens the query syntax reference in the browser.

====Layout editing mode====
Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog. Embedded UI elements automatically detect the layout editing mode of the default user interface.

==Columns==
Each pane can display one or multiple columns. To change them, right-click on one of the column headers.
===Example===
Set the first pane to genre, the second to artist, and the third to album. In the third one, enable multiple columns and add the date column. Resize and reorder them to your liking.
===Column patterns===

[[Image:Foobar2000-Facets-Preferences.png|thumb|Facets preferences]]

Columns are based on [[Foobar2000:Title_Formatting_Introduction|title formatting]]. Their patterns can be edited at Preferences, Media Library, Facets.

====Missing fields====
Depending on the pattern, missing fields are treated in different ways:
{| class="wikitable"
|-
!width="150"|Syntax
! Tracks without the specified field
! Summary item
|-
|%field%
|Listed under "?".
|Contains all tracks.
|-
|[%field%]
|Not listed at all, because the result is empty.
|Only contains tracks where the field exists. 1
|-
|$if2(%field%,Unknown)
|Listed under "Unknown".
|Contains all tracks.
|}
:# The rationale for ignoring empty results in the summary item is that, for example, selecting "All (# albums)" should only select actual albums, and not unsorted tracks without an album field. To display all items in the next pane, including those without the field, unselect the summary item with Ctrl-click if necessary.

====Multivalue fields====
Some fields like genre typically have multiple values. Facets makes some additions which allow values to be split into individual items:
{| class="wikitable"
|-
!width="250"|Syntax
! Description
|-
|%<field>%
|Checks one or more metadata fields according to the title formatting definition of the specified field. For the first field that is found, multiple values are split into separate items.
|-
|$meta_branch(field)
|Splits multiple values of specified field into separate items.
|-
|$meta_branch_stripprefix(field)
|Same as above, additionally removes leading "The" or "A" from each value.
|-
|$meta_branch_swapprefix(field)
|Same as above, additionally moves leading “The” or “A” to the end.
|-
|$meta_branch_remap(field)
|Same as %<field>%.
|-
|$meta_branch_remap_stripprefix(field)
|Additionally removes leading "The" or "A". For use instead of nonworking $stripprefix(%<artist>%).
|-
|$meta_branch_remap_swapprefix(field)
|Additionally moves leading "The" or "A" to the end. For use instead of nonworking $swapprefix(%<artist>%).
|}
Note that some title formatting functions are incompatible with fields that have been split this way. This applies to string comparison and measuring functions, such as $strcmp and $strstr, as well as any string manipulation function that removes a part of a string or inserts a substring by position, such as $left, $right, $cut, and $pad. Due to popular demand, compatible versions of $stripprefix and $swapprefix have been implemented as shown in the above table. It should be safe to use any function that replaces characters or sequences of characters, including $lower, $upper, $caps, $caps2, and $ansi.

====Multiple patterns====
Multiple patterns can be combined with | to display values from different fields in the same column. For example, %<artist>%|%<composer>% lists both artists and composers, which might be useful to create a list of persons regardless of their actual role.

====Colors====
Use < and > characters to dim or apply the highlight color to individual parts, with up to three levels, for example: <dimmed>, >highlight<, >>more highlight<<. Note that text in parentheses "(...)", brackets "[...]", and braces "{...}" is dimmed automatically. Color functions including $rgb, $hsl, $blend, and $transition are not supported.

To display the < and > characters, use $char(60) and $char(62).

===Ignore leading "The" when sorting===
Sorts items such as "The Beatles" among other entries starting with "B", while still displaying "The Beatles". Alternatively, columns can be changed to display "Beatles, The" or just "Beatles" by setting the pattern to, for example: $swapprefix(%artist%) or $stripprefix(%artist%), respectively.

===Summary item of date columns===
For columns containing "date" or "year" in their name, instead of the number of different dates, the summary item displays the number of years from the first to the last year (e.g. 5 years if the displayed dates range from 2007 to 2011; yes, five and not four). To be read as how many years an artist has been active or similar.

===Folder columns===
Folder columns are not based on title formatting. They display folders relative to the music folders set up at Preferences, Media Library, or, when browsing the current playlist, the full file path including the drive letter at the first level. Folder columns can be added to multiple panes to display several levels of subfolders. To mimic the typical appearance of some file managers, symbols at the right indicate the presence of subitems in the next pane.

===Automatic column resizing===
Multiple columns are automatically resized to use the full width. To avoid frequent readjustments, the size of statistics and columns named *date*, *year*, *number*, or codec remains the same if another column can be resized.

==Statistics==
Statistics are columns that display aggregated information for the tracks contained in each item.
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|Bitrate
|Average bitrate.
|-
|Duration
|Total length.
|-
|First release
|First date or release date tag.
|-
|Index
|Position in the list, always ranges from 1 to the number of displayed items, regardless of how items are sorted. Useful to quickly see the top or bottom N elements. The summary item displays the total number of items.
|-
|Items
|Number of tracks.
|-
|Last modified
|Last time a track has been modified.
|-
|Last release
|Latest date or release date tag.
|-
|Lossless ratio
|Number of lossless files, in percent.
|-
|Rating
|Average rating from metadata, displayed as stars. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|-
|Subitems
|Number of subitems in the next pane.
|-
|Total peak
|Highest peak of ReplayGain-scanned tracks.
|-
|Total size
|Sum of file sizes.
|}
===Playback statistics===
The following statistics require the additional [http://www.foobar2000.org/components/view/foo_playcount playback statistics component].
{| class="wikitable"
|-
!width="100"|Statistic
! Description
|-
|First added
|First time a track has been added. Based on %added%.
|-
|First played
|First time a track has been played. Based on %last_played%.
|-
|Last added
|Last time a track has been added. Based on %added%.
|-
|Last played
|Last time a track has been played. Based on %last_played%.
|-
|Played
|Number of times a track has been played. Based on %play_count%.
|-
|Played duration
|Sum over products of duration and %play_count%. Note that this counts tracks as fully played each time, even if playback was stopped after playback statistics counted the track as played (usually after one minute).
|-
|Rating
|Average rating, displayed as stars. Checks playback statistics %rating% first, then metadata field rating. The text color is dimmed according to the number of files that are rated, which indicates the reliability of the displayed value. This is also taken into account when sorting by rating.
|}

==Display==
===Columns===
By default, panes display their contents in a table-like view.

===Album art===
Additionally, one of three different views with album art can be selected:
{| class="wikitable"
|-
! Display
! Comment
|-
|right labels
|Best used with three or more columns.
|-
|bottom labels
|Best used with one or two columns. Requiring less space for labels, it is better suited for larger images.
|-
|no labels
|Can be used if all albums have album art and if they can be identified without any additional text.
|}
* Album art is loaded from the file sources defined at [[Foobar2000:Preferences:Display|Preferences: Display]] and embedded images.
* Images can be resized/zoomed by holding the Ctrl key and rotating the mouse wheel.
* To change the order of displayed lines, reorder the columns in the header. The first line displays the first column, and so on.
* Text in the first line is always displayed in bold, which makes it an ideal choice for the column that best distinguishes individual items.
* The third and following lines are dimmed automatically. Use them for less important columns, such as dates or statistics.
* For a pane that lists albums, a recommended order would be album, album artist, and date.

==Playlist interaction==
===Library selection playlist===
In media library mode, Facets sends the current selection to foobar2000's library selection playlist. Note that it creates the selection playlist even if it has not been enabled at [[Foobar2000:Preferences:Media Library|Preferences: Media Library]] to allow for a faster way of sending tracks to it. The "Activate when changed" option is ignored as well. To prevent selection changes from interrupting playback, Facets can be configured to preserve the playlist if the playing track is no longer selected, and to create a new selection playlist instead.
===Double-click action===
The double-click action is automatically set to "Send to current playlist" if the library selection playlist is used. It is only configurable when the selection action is set to "None".
===Creating autoplaylists===
To create an autoplaylist, right-click on a pane selection, or, if available, use the search results toolbar menu, and choose "Create autoplaylist". Autoplaylists are automatically updated to include tracks that match the search results or selected items. Note that their sort order is fixed to the "Default sort order" option at Preferences, Facets, unless the filter or search query used for the autoplaylist includes a SORT BY or SORT DESCENDING BY statement.
===Editing created autoplaylists===
To change the settings of a created autoplaylist, right-click on its playlist tab or playlist manager entry, and choose "Autoplaylist (Facets)". This will open the Facets view with the settings and selection used to create the autoplaylist. Note that in order to change the layout of panes, Facets' own layout editing mode toolbar will have to be added and selected. After clicking on the close window button (X), a dialog will ask if the changes should be saved.
===Displaying contents of the current playlist===
Instead of the media library, Facets can also be set to watch the active playlist via the source toolbar. Playlist views will follow the Facets selection and focus, but not the other way around.

==Selection logic==
Holding the Shift key when right-clicking on column headers reveals the selection logic option. It controls how tracks of multiple selected items are combined. The default behaviour "OR" selects all tracks that can be found in any of the selected items, while "AND" only selects tracks that can be found in all selected items. For example, in a genre pane, AND selection logic can be used to obtain tracks that have all selected genres.

==Facets 1.0 release notes==
===Upgrading from older versions===
All settings should be carried over to the new version. To be absolutely safe, backups of the current configuration can be kept, and, in case some settings were not imported correctly, put back later to repeat the update process with a fixed version. To locate the configuration files, hold the Shift key and select "Browse configuration folder" from the File menu.
{| class="wikitable"
|-
! Object
! Description
|-
|foo_facets.cfg
|Found in the configuration subfolder. Stores column patterns.
|-
|theme.fth
|Contains the current user interface layout, including Facets UI elements.
|-
|playlists folder
|Includes settings of created autoplaylists.
|}
Note that when installing an older version over Facets 1.0, the old configuration files will have to be put back in place. Due to new configuration formats, settings written by the new version cannot be ported back to the old one.

Keeping the old version by renaming the component DLL file will lead to conflicts and is not supported.

===Default sort order option===
A new setting at Preferences, Media Library, Facets now determines the order of media library items. "Sort incoming files by" at Preferences, Shell integration is no longer used when sending tracks to playlists. If this option has been changed, it is recommended to copy the pattern to the new location.

===Displaying items with leading "The"===
The option to ignore the leading "The" when sorting is still present. To change the display of affected items, instead of the previously available option, $stripprefix or $swapprefix can be used in the pattern of columns such as artist or album artist.
===Setting colors in column patterns===
Due to hardcoded colors being incompatible with different color schemes, title formatting functions to indicate colors - $rgb, $hsl, $blend, and $transition - can no longer be used in column patterns. Upgrading to the new version will not change existing columns, but color functions will no longer have any effect. Supported now are the < and > characters to dim or apply the highlight color to individual parts. Please see the title formatting syntax help for details and examples. Text in parenthesis is still dimmed by default.

===New predefined filters===
The search box no longer keeps a history of recently used searches. Instead, a new filter toolbar has been introduced to quickly access frequently used search queries, along with a new preferences page below Media Library, Facets.

===Version numbering scheme===
Facets now uses actual version numbers instead of the release date.

==Change log==
===1.0===
User interface:
* New Album art display modes
* Themed selection style with default background colors
* Automatic column size adjustment to use the full width
* Smooth mouse scrolling with middle-button.
* Mouse rectangle selection from all columns instead of only the first one
* Edit, Select all, Ctrl+A selects the summary item, option to hide it
* Thinner splitters, cut/copy/paste individual panes in layout editing mode
* Faster column sorting, initialization of multiple columns
* Previous scroll positions are restored after restart
Search:
* Filter toolbar for frequently used searches, new search results menu
* Reset button can be disabled or moved in front of the search box
* Search syntax supports DURING LAST, SORT BY, SORT DESCENDING BY
* Added entry to the library menu, assign as keyboard shortcut to focus the search
* Fixed search box redraw problems with classic visual style
Playlist interaction:
* New source mode to display contents of the current playlist
* Use media library selection playlist, faster playlist updates
* Playing selection playlist is preserved by default when changing selection
* Autoplaylist editor, opens Facets view that was used to create it
Preferences:
* Updated preferences page to use new buttons, refined looks
* Title formatting additions to deal with leading "The" of multivalue fields
* Color control syntax to <dim> and >highlight< text, removed $rgb support
* Default sort order option replaces usage of "Sort incoming files by"
Other:
* New statistics: first and last added, last release, lossless ratio, played duration, total peak
* Ratings use playback statistics database in addition to tags
* Optional AND selection logic, useful to find tracks with all selected genres
* Removed useless "Remove dead entries" context menu entry

==Links==
* [http://www.foobar2000.org/components/view/foo_facets Official website]