Foobar2000:Components/SimPlaylist (foo simplaylist)
From Hydrogenaudio Knowledgebase
Playlist view with multiple grouping levels, album art, smart column resizing, smooth scrolling, and clickable rating columns for tags and playback statistics.
Contents |
[edit] Screenshots
 |  |  |
[edit] Usage
To be able to revert to the previous playlist view, export the current main layout at Preferences, Display, Default User Interface, Export Theme.
[edit] 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.
[edit] 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.
[edit] Columns
[edit] 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%] |
[edit] 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. |
[edit] Custom columns
Custom columns based on title formatting can be added at Preferences, Display, SimPlaylist.
[edit] 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).
[edit] 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.
[edit] Groups
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.
[edit] 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.
[edit] 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.
[edit] 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.
[edit] Sorting pattern
This pattern is used to sort the playlist when clicking on a group column.
[edit] 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.
[edit] 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. |
[edit] 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. ★★★☆☆ |
[edit] Group colors
Groups use the default highlight color. < and > characters can be used to dim individual parts, similar to column colors.
[edit] 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 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.
