Difference between revisions of "Foobar2000:Components/Album Art Panel (foo uie albumart)"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(Description)
(merged dup pages into this one)
Line 2: Line 2:
  
 
=Description=
 
=Description=
* Panel for Columns UI that typically displays the cover art of albums.
+
Album Art Panel is a component for foobar2000 and Columns UI that displays album art in a panel. When configured, it can display any image you would like to associate with a track.
* Can display any image you'd like to associate with a track.
+
 
 +
==Features==
 +
*Configurable sources list allows cycling of multiple images for a single track
 +
*Allows TAGZ and wildcards to specify image file location
 +
*Minimum height setting to assist with layouts
 +
*Configurable resizing of album art to fit panel size
 +
*Sliding and fading transitions between album art
 +
*Configurable actions when panel is left-clicked, double-clicked, and middle-clicked.
 +
*Can display album art for either the currently playing track or the currently selected track
 +
 
 +
==Reading Embedded Album Art==
 +
 
 +
Album Art Panel does not support reading album art which has been embedded as a tag (for example, as an ID3v2 tag in an MP3).
 +
 
 +
=Sources List=
 +
The sources list allows you to use [[Foobar2000:Titleformat_Reference|titleformatting scripts]] to specify exactly where Album Art Panel will look for image files.  In order to learn how to use the sources list, let's look at an example:
 +
 
 +
  $replace(%_path%,%_filename_ext%,)folder.jpg
 +
  -match:$replace(%_path%,%_filename_ext%,)*
 +
  -components\default.png
 +
  match:C:\Music\Arts\%artist% %album%*
 +
  -components\default.png
 +
 
 +
The sources list is organized into groups, based on which lines have a '-' in front of them.  Each line that does not start with a '-' is the beginning of a new source group.  A line which starts with '-' is part of the same source group as the line above it.  In the example above, there are two source groups.  The first source group consists of the first three lines and the second group consists of the last two lines.
 +
 
 +
If a line begins with "match:" or "-match:", the wildcard '*' can be used in place of one or any number of characters and '?' can be used in place of any single character.  For instance, the second line of the example above tells Album Art Panel to look for any file it can display in the same directory as the track.  Album Art Panel will display the first image which matches the pattern.
 +
 
 +
Starting with version 0.160, the "match:" prefix is optional and ignored, and "-match:" is treated like "-". The wildcards '*' and '?' can be used in any source string; characters in tags that are not allowed in filenames will be replaced by an underscore '_' or - in version 0.164 and newer - with the '?' wildcard.
 +
 
 +
The "Next Source" action (by default, left-clicking on the panel) will cycle through the source list as follows: If a wildcard is used, "Next Source" will cycle through all images which match the pattern.  Otherwise, "Next Source" will cycle through the source groups.
 +
 
 +
Album Art Panel will first look for an image at the location indicated in the first line of a source group.  In this example, it will look in the same directory as the track for a file called "folder.jpg".  The TAGZ code takes the full path of the track, replaces the filename with a blank, and appends "folder.jpg" to the end (e.g, "C:\Music\Soundgarden\Badmotorfinger\01 Rusty Cage.mp3" becomes "C:\Music\Soundgarden\Badmotorfinger\folder.jpg").
 +
 
 +
If the image indicated by the first line cannot be found, Album Art Panel will look at subsequent lines within the same source group and display the first image which can be found.  If no image within a source group can be found, Album Art Panel will try to display the next source group instead.  If none of the source groups can be found, the display will be blank.
 +
 
  
 
=Link=
 
=Link=
* [http://stephan.kochen.nl/proj/foobar2000.html Website] (Awaiting new website for latest build, see this one )
+
* [http://stephan.kochen.nl/proj/foobar2000.html Website and Download] (links to latest)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=39924 Discussion Forum Thread]
+
 
* [http://eolindel.free.fr/foobar0.9/albumart.shtml Unofficial User Manual]
 
* [http://eolindel.free.fr/foobar0.9/albumart.shtml Unofficial User Manual]
* [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=39924&view=findpost&p=387294 Where the forum post discussion of the current version of album art panel starts]
+
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=39924 Current Discussion Forum Thread] [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=39924&view=findpost&p=387294 current version]
 +
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=39924 Original Discussion Forum Thread]
  
 
[[Category: foobar2000]]
 
[[Category: foobar2000]]
 
[[Category: Columns UI]]
 
[[Category: Columns UI]]

Revision as of 16:40, 10 May 2006

Albumartpannel.PNG

Description

Album Art Panel is a component for foobar2000 and Columns UI that displays album art in a panel. When configured, it can display any image you would like to associate with a track.

Features

  • Configurable sources list allows cycling of multiple images for a single track
  • Allows TAGZ and wildcards to specify image file location
  • Minimum height setting to assist with layouts
  • Configurable resizing of album art to fit panel size
  • Sliding and fading transitions between album art
  • Configurable actions when panel is left-clicked, double-clicked, and middle-clicked.
  • Can display album art for either the currently playing track or the currently selected track

Reading Embedded Album Art

Album Art Panel does not support reading album art which has been embedded as a tag (for example, as an ID3v2 tag in an MP3).

Sources List

The sources list allows you to use titleformatting scripts to specify exactly where Album Art Panel will look for image files. In order to learn how to use the sources list, let's look at an example:

 $replace(%_path%,%_filename_ext%,)folder.jpg
 -match:$replace(%_path%,%_filename_ext%,)*
 -components\default.png
 match:C:\Music\Arts\%artist% %album%*
 -components\default.png

The sources list is organized into groups, based on which lines have a '-' in front of them. Each line that does not start with a '-' is the beginning of a new source group. A line which starts with '-' is part of the same source group as the line above it. In the example above, there are two source groups. The first source group consists of the first three lines and the second group consists of the last two lines.

If a line begins with "match:" or "-match:", the wildcard '*' can be used in place of one or any number of characters and '?' can be used in place of any single character. For instance, the second line of the example above tells Album Art Panel to look for any file it can display in the same directory as the track. Album Art Panel will display the first image which matches the pattern.

Starting with version 0.160, the "match:" prefix is optional and ignored, and "-match:" is treated like "-". The wildcards '*' and '?' can be used in any source string; characters in tags that are not allowed in filenames will be replaced by an underscore '_' or - in version 0.164 and newer - with the '?' wildcard.

The "Next Source" action (by default, left-clicking on the panel) will cycle through the source list as follows: If a wildcard is used, "Next Source" will cycle through all images which match the pattern. Otherwise, "Next Source" will cycle through the source groups.

Album Art Panel will first look for an image at the location indicated in the first line of a source group. In this example, it will look in the same directory as the track for a file called "folder.jpg". The TAGZ code takes the full path of the track, replaces the filename with a blank, and appends "folder.jpg" to the end (e.g, "C:\Music\Soundgarden\Badmotorfinger\01 Rusty Cage.mp3" becomes "C:\Music\Soundgarden\Badmotorfinger\folder.jpg").

If the image indicated by the first line cannot be found, Album Art Panel will look at subsequent lines within the same source group and display the first image which can be found. If no image within a source group can be found, Album Art Panel will try to display the next source group instead. If none of the source groups can be found, the display will be blank.


Link