Foobar2000:Components/Facets (foo facets) - Revision history

Thorna at 13:48, 23 September 2022

2022-09-23T13:48:45Z

← Older revision		Revision as of 13:48, 23 September 2022
Line 1:		Line 1:
			[[Category:Foobar2000 Legacy Default UI components\|Legacy Default UI components]]
	{{Foobar Component Infobox		{{Foobar Component Infobox
	\| name = Facets		\| name = Facets

Beardgoggles: Minor fix to infobox data.

2019-07-07T18:26:18Z

Minor fix to infobox data.

← Older revision		Revision as of 18:26, 7 July 2019
Line 6:		Line 6:
	\| developer = Frank Bicking		\| developer = Frank Bicking
	\| released = 2007-10-20		\| released = 2007-10-20
	\| released_ref = ~~<ref>~~[https://web.archive.org/web/20110310065026/http://foobar2000.audiohq.de/foo_facets/changelog Original Facets changelog] via archive.org~~</ref>~~		\| released_ref = [https://web.archive.org/web/20110310065026/http://foobar2000.audiohq.de/foo_facets/changelog Original Facets changelog] via archive.org
	\| stable_release = 1.0		\| stable_release = 1.0
	\| stable_release_date = 2011-08-18		\| stable_release_date = 2011-08-18

Beardgoggles: Minor fix to infobox data.

2019-07-07T14:53:30Z

Minor fix to infobox data.

← Older revision		Revision as of 14:53, 7 July 2019
Line 6:		Line 6:
	\| developer = Frank Bicking		\| developer = Frank Bicking
	\| released = 2007-10-20		\| released = 2007-10-20
	\| released_ref = [https://web.archive.org/web/20110310065026/http://foobar2000.audiohq.de/foo_facets/ Original Facets ~~page~~] via archive.org		\| released_ref = <ref>[https://web.archive.org/web/20110310065026/http://foobar2000.audiohq.de/foo_facets/changelog Original Facets changelog] via archive.org</ref>
	\| stable_release = 1.0		\| stable_release = 1.0
	\| stable_release_date = 2011-08-18		\| stable_release_date = 2011-08-18

Beardgoggles: Added component infobox; minor reformatting.

2019-07-07T14:44:54Z

Added component infobox; minor reformatting.

← Older revision		Revision as of 14:44, 7 July 2019
Line 1:		Line 1:
	{{~~fb2k}}~~		{{Foobar Component Infobox
	[[~~Category~~:Foobar2000 ~~3rd~~-~~Party Components~~\|Facets ~~(foo facets)]~~]		\| name = Facets
			\| screenshot = [[File:Foobar2000-Facets-Preferences.png\|256px]]
	~~Media~~ library viewer with multiple columns, album art, statistics, and search functions.		\| caption = Facets preferences page.
			\| module_name = foo_facets
	* [[Foobar2000:Components/Facets (foo_facets)/Release notes\|Facets 1.0 release notes]]		\| developer = Frank Bicking
	* [[Foobar2000:Components/Facets (foo_facets)/Change log\|Facets 1.0 change log]]		\| released = 2007-10-20
			\| released_ref = [https://web.archive.org/web/20110310065026/http://foobar2000.audiohq.de/foo_facets/ Original Facets page] via archive.org
			\| stable_release = 1.0
			\| stable_release_date = 2011-08-18
			\| foobar2000_version = 1.1
			\| foobar2000_ui_module = Default UI
			\| use = TBC
			}}
			'''Facets''' is a media library viewer with multiple columns, album art, statistics, and search functions.

	==Usage==		==Usage==
Line 22:		Line 30:
	==Layout==		==Layout==
	===Panes===		===Panes===

	[[Image:Foobar2000-Facets-Panes-Layout.png\|thumb\|Panes layout editing]]		[[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.		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.

Line 30:		Line 36:

	===Toolbar===		===Toolbar===

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

	To control the toolbar, enable the layout editing mode, and right-click on it.		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.		* "Bottom-dock toolbar" moves the toolbar below the panes. Repeating this action will move it back to the top.
Line 155:		Line 159:

	====Multiple patterns====		====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.		Multiple patterns can be combined with {{code\|{{!}}}} 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====		====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.		Use {{code\|<}} and {{code\|>}} 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).		To display the < and > characters, use $char(60) and $char(62).
Line 269:		Line 273:
	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.		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~~==		==See also==
	* [http://www.foobar2000.org/components/view/foo_facets Official website]		* [[Foobar2000:Components/Facets (foo_facets)/Release notes\|Facets 1.0 release notes]]
	* [http://www.hydrogenaudio.org/forums/index.php?showtopic=88410 Discussion thread]		* [[Foobar2000:Components/Facets (foo_facets)/Change log\|Facets 1.0 change log]]
	* [[Foobar2000:Components/Facets (foo_facets)/Release notes\|~~Release~~ notes]]
	* [[Foobar2000:Components/Facets (foo_facets)/Change log\|~~Change~~ log]]		==References==
			<references/>

			==External links==
			* {{foobar2000\|http://www.foobar2000.org/components/view/foo_facets\|Facets}}
			* {{ha\|https://hydrogenaud.io/index.php/topic,88410.0.html}}

Neptune: /* Panes */

2011-08-18T17:26:18Z

Panes

← Older revision		Revision as of 17:26, 18 August 2011
Line 27:		Line 27:
	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.		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".		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===		===Toolbar===

Neptune: /* Panes */

2011-08-18T17:25:34Z

Panes

← Older revision		Revision as of 17:25, 18 August 2011
Line 25:		Line 25:
	[[Image:Foobar2000-Facets-Panes-Layout.png\|thumb\|Panes layout editing]]		[[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.		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.

	~~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".		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===		===Toolbar===

Neptune at 22:56, 17 August 2011

2011-08-17T22:56:52Z

@@ Line 64: / Line 64: @@
 |Activates the integrated layout editing mode. Only available for the standalone window opened from the Library menu, and the autoplaylist editor dialog.
 |}
 ==Columns==
@@ Line 218: / Line 245: @@
 |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==

Neptune: /* Playlist interaction */

2011-08-17T22:43:31Z

Playlist interaction

← Older revision		Revision as of 22:43, 17 August 2011
Line 248:		Line 248:
	==Playlist interaction==		==Playlist interaction==
	===Library selection playlist===		===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.		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===		===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".		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===		===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.		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===		===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.		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===		===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~~.		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==		==Selection logic==

Neptune: /* Toolbar */

2011-08-17T22:31:15Z

Toolbar

← Older revision		Revision as of 22:31, 17 August 2011
Line 50:		Line 50:
	\|-		\|-
	\|Filter		\|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].		\|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		\|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.		\|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		\|Search results

Neptune: /* Layout */

2011-08-17T22:26:35Z

Layout

← Older revision		Revision as of 22:26, 17 August 2011
Line 38:		Line 38:
	* Unchecking "Show the toolbar" disables the toolbar entirely.		* 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".		* 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]]		[[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].		{\| class="wikitable"
			\|-
	~~====~~Search~~====~~		!width="125"\|Toolbar
			!Remarks
	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.		\|-
			\|Source
	~~====~~Search results~~====~~		\|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.
	~~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.		\|-
			\|Filter
	~~====~~Search help~~====~~		\|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].
	Opens query syntax reference in the browser.		\|-
			\|Search
	~~====~~Layout editing mode~~====~~		\|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.
	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.~~		\|-
			\|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==		==Columns==