foobar2000:Components/SimPlaylist (foo_simplaylist)
| SimPlaylist | |
|---|---|
 | |
| Developer(s) | Frank Bicking |
| Release information | |
| Initial release | May 2, 2011 |
| Stable release | 1.0 (August 18, 2011) |
| foobar2000 compatibility | |
| Minimum version | 1.1 |
| UI module(s) | Default UI |
| Additional information | |
| Use | UI |
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.
Contents
Screenshots[edit]
 |
|
 |
Usage[edit]
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.
Layout[edit]
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[edit]
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[edit]
Default columns[edit]
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[edit]
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[edit]
Custom columns based on title formatting can be added at Preferences, Display, SimPlaylist.
Column colors[edit]
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[edit]
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[edit]
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[edit]
- 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[edit]
- 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[edit]
- 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[edit]
This pattern is used to sort the playlist when clicking on a group column.
Subgroups[edit]
- 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[edit]
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[edit]
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[edit]
Groups use the default highlight color. < and > characters can be used to dim individual parts, similar to column colors.
Album art[edit]
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 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[edit]
- SimPlaylist on
foobar2000.org
