foobar2000:Components/Album List Panel (foo uie albumlist)

From Hydrogenaudio Knowledgebase
Revision as of 17:07, 11 November 2023 by Thorna (talk | contribs) (Cleaning old information, making infobox more useful)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Album List Panel

foo uie albumlist
Developer(s) musicmusic
Repository github
Release information
Initial release
Stable release 2.0.2 (November 9, 2023)
Preview release
foobar2000 compatibility
Architecture x86 64-bit, 32-bit
Minimum version 1.5
Maximum version
UI module(s) Columns UI
Additional information
License LGPL
Discussion thread {{{discussion_thread}}}
View all components


Displays the database in a tree view using customizable sorting methods (by genre, artist, directory, etc.). Album list panel is based on Album List 3.1.0, by Peter Pawlowski.




  1. Extract the downloaded archive and place foo_uie_albumlist.dll in your foobar2000 "components" folder (normally located at %ProgramFiles%\foobar2000\components\), or install fb2k.component.
  2. Start foobar2000.
  3. Open up Preferences, navigate to Display -> Columns UI, and select the Layout tab.
  4. Right-click on a splitter and select Insert Panel -> Panels -> Album List
  5. Click Apply to make the panel appear.

Context Menu Options


This is where you pick the different views for the panel. You can add more views (see section: adding views)

Refresh Tree

Refreshes the tree. This is useful if: You've updated the media library by moving/deleting files, by updating tags, or if you changed the code of the view you're using.


Enabling this option puts a small text box at the bottom of the panel which accepts queries (use the autoplaylist help for a guide).


Allows you to change the behavior of the panel.


Album List Panel settings can be accessed either by pressing the Configure button on the Columns UI Layout tab, or by right-clicking the panel itself and selecting Settings. The available settings are split up into two tabs.

Note: This section relates to version 0.2.3 beta.

Display Tab

This is the lists of "views" available. To change a view while using the panel, Right click the panel, select View -> <choose a view>. To add custom views, see the next section.
Up/Down buttons
Use these to reorder the views list
Delete/New buttons
Use these to remove / create new views
Double click / Middle Button action
Use this dropdown to configure what happens when you double click / Middle Click an entry in the panel (default: Expand/Collapse, no defaults for middle click)
Autosend to playlist
use this checkbox to control whether the panel should list contents of the entry when you single click it (e.g. Single clicking on "Metallica" automatically sends all files under Metallica to the playlist)
Text box below it
Type the name of the target playlist (where the panel should display the files)

Advanced Tab


Show sub-item count
Shows the number of items under each entry
Show horizontal scrollbar
(if the content of the entries do not fit the width of the panel)
Use Item Indices
Displays items in this form: 1. <entry 1> 2. <entry 2 and so on
Use Custom vertical padding
Change the amount of whitespace between entries
Use Custom indentation
Change the amount of indentation (between an entry and it's parent)
Window Frame Style
Choose between None, Sunken or Gray


Autoplay on send to playlist
Choose whether the songs play automatically when added to playlist
Apply core sort settings on added files
If selected, the panel sorts files based on the criteria specified in Preferences-> General -> "Sort incoming files by". When unselected, uses the order as determined by the view.
Select Added items
Choose whether the songs added to the playlist are selected automatically
Populate on Initialization
If unselected, the panel is blank when you start foobar. You need to manually right click the panel and select refresh tree to have it list items. Unchecking this option leads to a decrease in startup time of the program (the effect is very pronounced if you have large libraries)
Process keyboard shortcuts
Allows you to use keyboard shortcuts specified in Preferences-> General -> "Keyboard shortcuts" when the panel has the focus.
Auto-collapse on Item Expand
Automatically closes an entry if you select another one (e.g. if "Metallica" is currently open, and you open "Megadeth", the "metallica" entry collapses)

Adding Sources

The panel uses the pipe key "|" to distinguish between parent and child entries. e.g. If you want to create an entry that goes as Genre -> Artist -> Album, you'd use %genre%|%artist%|%album%.

Since the panel supports the full gamut of titleformatting options, you can do some pretty nifty things with it. Examples:

  • Decade -> Year -> Artist -> Album:


  • Separate files based on whether they have Replaygain Information:

$if(%__replaygain_track_gain%,RG,NO RG)|%album artist%|%album%

  • Separate files based on the date added to libary (This uses the %added% tag which can be added to files using foo_cwb_hooks):

$if(%added%,$left(%added%,4)|$substr(%added%,6,7)|$right(%added%,2)|%album artist%|%album%,No Info ':(')

  • Sort by codec

%codec%|%album artist%|%album%

Tip: As far as possible, avoid using code which forces the panel to display a large number of files under a single entry. This reduces memory usage and significantly shortens startup time.