Foobar2000:Components/SimPlaylist (foo simplaylist): Difference between revisions

From Hydrogenaudio Knowledgebase
(Created page with "{{fb2k}} SimPlaylist (foo_simplaylist) Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrollin…")
 
mNo edit summary
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{fb2k}}
[[Category:Foobar2000 Legacy Default UI components|Legacy Default UI components]]
[[Category:Foobar2000 3rd-Party Components|SimPlaylist (foo_simplaylist)]]
{{Foobar Component Infobox
| name                = SimPlaylist
| screenshot          = [[File:Foobar2000-SimPlaylist-Groups-v2.png|256px]]
| caption              =
| module_name          = foo_simplaylist
| developer            = Frank Bicking
| repository          =
| released            = 2011-05-02
| released_ref        =
| stable_release      = 1.0
| stable_release_date  = 2011-08-18
| preview_release      =
| preview_release_date =
| foobar2000_minimum  = 1.1
| foobar2000_ui_module = Default UI
| use                  = UI
| license              =
}}
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.
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==
==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.
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.
<!-- To be added with the final version.
<!-- To be added.


===Preconfigured layout===
===Preconfigured layout===
Open the "View" menu, choose "Layout", "Quick Setup", and select "SimPlaylist" under "Playlist Layout". Note that this replaces your current playlist view, all its settings will be lost.-->
Open the "View" menu, choose "Layout", "Quick Setup", and select "SimPlaylist" under "Playlist Layout". Note that this replaces your current playlist view, all its settings will be lost.-->


===Manual integration===
===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.
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==
==Columns==
Line 35: Line 64:
|-
|-
|Duration
|Duration
|[%playback_time%]$if($and(%playback_time%,%length%), / )[%length%]
|Displays playback time / length. Click on playing item to toggle between elapsed and remaining time.
|-
|Index
|%list_index%
|-
|-
|Playing
|Playing
Line 65: Line 91:
|-
|-
|Played
|Played
|[%play_count% times]
|[%play_count%]
|-
|-
|Rating (database)
|Rating (database)
Line 72: Line 98:


===Custom columns===
===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.
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===
===Automatic column resizing===
Line 78: Line 111:


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


Line 142: Line 180:
|-
|-
|%rating%
|%rating%
|Average rating from metadata, as number from 1 to 5.
|Average rating from playback statistics or metadata, as number from 1 to 5.
|-
|-
|%rating_stars%
|%rating_stars%
Line 191: Line 229:
|%rating_stars_fixed%
|%rating_stars_fixed%
|Same as above, formatted as five stars, e.g. ★★★☆☆
|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===
===Album art===
Line 208: Line 248:


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

Latest revision as of 13:52, 23 September 2022

SimPlaylist

Developer(s) Frank Bicking
Repository
Release information
Initial release May 2, 2011
Stable release 1.0 (August 18, 2011)
Preview release
foobar2000 compatibility
Architecture {{{foobar2000_architecture}}}
Minimum version 1.1
Maximum version {{{foobar2000_maximum}}}
UI module(s) Default UI
Additional information
Use UI
License
Discussion thread {{{discussion_thread}}}
View all components

Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.

Screenshots

Artist - album / cover
Artist / cover + album info
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 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

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:

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 playback statistics component.

Name Pattern / remarks
Played [%play_count%]
Rating (database) Displays clickable rating from playback statistics database.

Custom columns

Custom columns

Custom columns based on 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

Artist - album / cover
Artist / cover + album info
Artist / cover / album

Playlist tracks are grouped by comparing each track with the next one according to a 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.

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 playback statistics component.

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 default highlight color. < and > characters can be used to dim individual parts, similar to column colors.

Album art

To display album art in group headers, columns, or subgroups:

  1. Open Preferences, Display, SimPlaylist, Groups.
  2. Select a grouping preset.
  3. Click into the display column of a header, column, or subgroup.
  4. Make sure Image/Text is selected.
  5. Select one of artist, front, back, or disc image types.
  6. Press Apply or OK to save the changes.
  • Album art is loaded from the file sources defined at 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