Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2012-03-11T09:16:57Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.
* Frame style of the component can be changed with Columns UI (CUI) by clicking anywhere in the UI element and choosing a style from the ''Frame style'' context menu.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.1 / 2012-03-11
** Improvements.
*** Frame style of the component can be changed with Columns UI (CUI) interface. DUI components use the same frame style as before, and with DUI the style cannot be changed.
* '''0.5 / 2012-01-07
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!). Tested quite thoroughly this time.
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
*** Minor UI fixes regarding item selection and focus when opening context menu.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2012-02-19T11:41:53Z

Salski: /* UI Element */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.
* Frame style of the component can be changed with Columns UI (CUI) by clicking anywhere in the UI element and choosing a style from the ''Frame style'' context menu.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.1 / 2012-02-xx
** Improvements.
*** Frame style of the component can be changed with Columns UI (CUI) interface. DUI components use the same frame style as before, and with DUI the style cannot be changed.
* '''0.5 / 2012-01-07
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!). Tested quite thoroughly this time.
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
*** Minor UI fixes regarding item selection and focus when opening context menu.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2012-02-19T11:40:01Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.1 / 2012-02-xx
** Improvements.
*** Frame style of the component can be changed with Columns UI (CUI) interface. DUI components use the same frame style as before, and with DUI the style cannot be changed.
* '''0.5 / 2012-01-07
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!). Tested quite thoroughly this time.
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
*** Minor UI fixes regarding item selection and focus when opening context menu.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2012-01-07T11:39:52Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5 / 2012-01-07
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!). Tested quite thoroughly this time.
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
*** Minor UI fixes regarding item selection and focus when opening context menu.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-12-12T18:47:09Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.0 / 2011
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
*** New context menu option for locating the track corresponding the queued item.
** Bug fixes:
*** Drag & Drop of columns fixed (again!)
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
*** Minor UI fixes regarding item selection and focus when opening context menu.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-12-12T17:51:47Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.0 / 2011
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
*** New context menu option for locating the track corresponding the queued item.
** Bug fixes:
*** Drag & Drop of columns fixed (again!)
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-12-11T11:08:20Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.0 / 2011
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!)
*** Ctrl+Shift+Up/Down crashed when all the items were selected.
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-12-11T10:56:00Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.5.0 / 2011
** Improvements:
*** Addition of two new context menu options ("Move Up" and "Move Down"). [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=778481 Suggested] by auditorium.
** Bug fixes:
*** Drag & Drop of columns fixed (again!)
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-09-13T18:19:02Z

Salski: /* Download link */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [https://github.com/ssalonen/foo_queuecontents github]. Please see the license files.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-09-13T18:06:59Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.5 / 2011-09-13
** Improvements:
*** Standalone (pop-up) window can be closed with ESC or ALT+F4
** Bug fixes:
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** Item focus should be preserved on queue update
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-09-05T17:02:34Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* Next version / 2011
** TODO:
*** DONE/Queuecontents standalone window can be closed with ESC or ALT+F4
*** DONE/Selection behaves similarly to default playlist on item delete (focus & selection)
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-09-05T17:00:46Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* Next version / 2011
** TODO:
*** Queuecontents standalone window can be closed with ESC or ALT+F4
*** Selection behaves similarly to default playlist on item delete (focus & selection)
*** TODO double registration of window
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-08-17T17:35:19Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* Next version / 2011
** TODO:
*** Queuecontents standalone window can be closed with ESC or ALT+F4
*** Selection behaves similarly to default playlist on item delete (focus & selection)
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-08-16T18:28:23Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* Next version / 2011
** TODO:
*** Queuecontents standalone window can be closed with ESC or ALT+F4
*** Selection behaves similarly to default playlist on item delete
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-08-09T18:03:05Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / 2011-08-09
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-08-09T15:11:32Z

Salski: /* Requirements */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 (or later) and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-08-09T15:01:26Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** Fields available in formatting strings (added by this component) are now case-insensitive as they should be, e.g. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-07-31T15:26:30Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** %queue_index% and %queue_total% are now case-insensitive as they should be, i.e. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
*** Queue playlist functionality no longer identifies the ''queue playlist'' by name. This makes it safe to have other playlists with the same name as the ''queue playlist''.
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-07-31T11:54:27Z

Salski: /* Configuration */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use ''%playlist_name%'' to refer to the playlist name of the queued item. Similarly, ''%list_index%'' and ''%list_total%'' tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** %queue_index% and %queue_total% are now case-insensitive as they should be, i.e. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-07-31T11:54:04Z

Salski: /* Configuration */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue. In addition you can use %playlist_name% to refer to the playlist name of the queued item. Similarly, %list_index% and %list_total% tell you the position and size of the playlist corresponding to the queued item.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** %queue_index% and %queue_total% are now case-insensitive as they should be, i.e. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-07-28T16:28:05Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.4. / XXX
** Bug fixes:
*** %queue_index% and %queue_total% are now case-insensitive as they should be, i.e. %QUEUE_INDEX% is same as %queue_index%.
** Improvements:
*** Additional fields available in formatting strings: %playlist_name% (name of the queued playlist corresponding to queued item), %list_index% (index of the queued item in the queued playlist), %list_total% (total number of items in the queued playlist).
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-06-08T15:08:04Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.3. / 2011-06-08
** Bug fixes:
*** Fixed incorrect behaviour (addition of 'ghost rows') when adding the first column. Reported [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648&view=findpost&p=755835 here].
* '''0.4.2 / 2011-05-20'''
** Bug fixes:
*** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-05-20T05:59:16Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.2 / 2011-05-20'''
* Bug fixes:
** Column reordering should work correctly now.
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-05-04T12:55:09Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.1 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-05-04T12:54:42Z

Salski: /* Requirements */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.6 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.1.5 / 2011-01-18'''
** Potential race condition resolved.
* '''0.1.4 / 2011-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2011-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2011-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2011-01-11'''
** More verbose component description added.
* '''0.1 / 2011-01-10'''
** Initial release

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-05-04T12:54:30Z

Salski: /* Requirements */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.1 and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-05-04T12:22:15Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.6 / 2011-05-04'''
** Rebuilt with foobar SDK 1.1. From now on requires at least foobar 1.1.
* '''0.1.5 / 2011-01-18'''
** Potential race condition resolved.
* '''0.1.4 / 2011-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2011-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2011-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2011-01-11'''
** More verbose component description added.
* '''0.1 / 2011-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-05-03T05:57:26Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.5 / 2011-01-18'''
** Potential race condition resolved.
* '''0.1.4 / 2011-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2011-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2011-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2011-01-11'''
** More verbose component description added.
* '''0.1 / 2011-01-10'''
** Initial release

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-02-24T16:26:51Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.0 / 2011-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Queue Contents Editor (foo queuecontents)

2011-02-24T16:22:23Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Queue Contents Editor (foo queuecontents)]]
[[Image:general.png|thumb|right|292px|Queue Contents Editor]]
=General=
'''foo_queuecontents''' enables the user to edit and view queue contents through an ui element. Both the Default User Interface (DUI) and Columns User Interface (CUI/uie) are supported. As a legacy option, queue contents can also be viewed and edited by a special queue playlist, which is updated automatically with queue contents.

The component started as a modification of '''foo_locktest''' (by foosion) but since then it has developed much further.

===Download link===
The component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/foo_queuecontents.zip?attredirects=0&d=1 here]. Install the .zip package in "Preferences > Components", or manually by unziping '''foo_queuecontents.dll''' to foobar2000 components directory.

Source code for the component is available from [http://sites.google.com/site/salskisite/foo_queuecontents/]. The licence is inside the zip file.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=73648 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x and Column UI 0.3.8.x (Optional). The component will not work with previous versions of foobar.

===Getting started===
The recommended way to use foo_queuecontents is to use the UI element. Just add the panel as you would any other UI element. The element can be found under ''Utility'' category in DUI, or under ''Panels'' category in CUI with the name ''Queue Contents Editor''.

The component is ready to use :)

=Features and Usage=
As stated before the component supports two kind of interfaces: UI element (CUI/DUI) and a special playlist for displaying/editing queue contents.

=== UI Element ===
[[Image:item_context.png|thumb|right|275px|UI Element: Context menu for queue items]]
[[Image:header_context.png|thumb|right|275px|UI Element: Context menu for column header]]
UI element works with both popular user interfaces for foobar: Default UI and Columns UI.
Following features are supported in each:
* Views items currently in the queue using interface similar to foobar default playlist component.
* Reorder queue items by drag & drop, and by using keyboard shortcuts similar to foobar default playlist component.
* Delete queue items through the context menu, or pressing the delete key.
* Add items to queue by drag & drop. Files can be dragged either outside or inside from foobar. Files that are dragged from a foobar playlist are queued in the same way they would have been with the ''Add to Playback Queue'' command.
* Fully user-customizable columns in the UI element. You can add, delete and reorder columns however you like. User can define new columns with custom format strings from the preferences.
* Optionally auto-size of columns so that ''column width/element width'' ratio is kept constant (''Auto-scale Columns with Window Size'').
* Optionally show or hide the column header. You can always show the column header by clicking anywhere in the UI element and clicking ''Show Column Header''.

=== Playlist (legacy) ===
Queue playlist functionality has been from the start. It is now considered obsolete/legacy option since reflecting queue contents in a separate playlist is confusing to say the least. It also has strange behaviour (due to inherent features of a playlist) that might confuse people. However, the functionality is preserved for compatibility reasons. UI element is recommended over the playlist functionality.

Features:
* Queue contents are reflected to a special playlist. The items are ordered according to their queue position, i.e. items on the top of the playlist are played first.
* All changes (deletions, insertions and reordering) to playlist is reflected also to queue.
* Queue playlist name can be changed by just renaming the playlist. It can also be changed from the foobar preferences.
* Queue playlist functionality is disabled by default but it can be enabled from the preferences.

=Configuration=
[[Image:preferences.png|thumb|300px|Queue Contents Editor Preferences]]
Configuration of the columns is very straight-forward and should be familiar to anyone with foobar DUI experience. Each column has the following properties:
* Name, used for the column header in the UI element
* Pattern, format string for displaying information about the queue item. Click ''Syntax Help'' for more information on format strings.
* Alignment, alignment of the column.

In the pattern you can also use ''%queue_index%'' to reference item's position in the queue (first one has index 1), and ''%queue_total%'' to reference items currently in a queue.

For each queuecontents UI element you have, you can choose different columns to display by right-clicking the column header.

As a legacy option, foo_queuecontents supports reflecting of playlist contents to a special playlist. You can enable/disable the functionality from the preferences using the checkbox ''Enable Queue Playlist Feature''.

=Change Log=
* '''0.4.0 / 2010-02-24'''
** Bug fixes:
*** Fixed bug with newest columns ui and foobar 1.1.3+. With autosize enabled, all the columns disappeared on foobar start.
*** Component about dialog now has correct wiki url (pointing to this page)
* '''0.3.9 / 2010-05-20'''
** Bug fixes:
*** Finally fixed the bug which broke completely the queuecontents playlist behaviour.
** Improvements:
*** More default columns. They will be visible only for new installations (or if you reset your settings).
*** Better component description.
* '''0.3.8 / 2010-05-19'''
** Bug fixes:
*** Drag & Drop from queue playlist to UI element works now as expected (it will queue the items again to the specified position in the queue).
*** Removed warning related to configuration on first UI element startup since it is always expected.
** Improvements:
*** Drag & Drop to UI element from a playlist queues items to correct position
* '''0.3.7 / 2010-05-18'''
** Bug fixes:
*** Erratic queue playlist behaviour fixed.
** Improvements:
*** Queue playlist supports drag & drop better.
* '''0.3.6 / 2010-05-15'''
** Bug fixes:
*** Queue playlist item reorder problems solved.
*** Fixed crash when removing queuecontents panel when using Columns UI.
* '''0.3.5 / 2010-05-07'''
** Bug fixes:
*** Column order is preserved correctly after drag & drop of columns.
* '''0.3.4 / 2010-05-07'''
** Bug fixes:
*** Left and Right cursor keys works correctly in preferences when editing columns.
* '''0.3.3 / 2010-04-22'''
** Bug fixes:
*** Alignment of columns is now correctly displayed in the settings.
* '''0.3.2 / 2010-04-20'''
** Bug fixes:
*** Changes to column names are updated immediately in ui elements.
*** "Show Column Header" setting is now correctly preserved over different foobar2000 sessions.
*** ESC button works as expected in the preferences dialog: it closes it.
*** Fixed column size glitches when enabling/disabling auto-sizing of columns
** Improvements:
*** %queue_total% supported in format strings.
*** UI element automatically refreshes items when one of the queue items has a metadata change.
*** UI element has the same border style than the DUI playlist view.
*** Preferences dialog: When configuring columns, no need to press return key anymore, text is committed automatically. Also improved processing of ESC and other keys in the prerences.
*** Preferences dialog: Columns are sized reasonably by default
*** Preferences dialog: ''Syntax Help'' button for HA Syntax Help.
*** Preferences dialog: Help button brings to this wiki page.
*** Drag from playlist to ui element now correctly queues the item preserving the "link" to the playlist (i.e. playlist items will have %queue_index%) for the dragged items in the playlist).
**** Behaviour tested with DUI playlist and various playlist components for CUI.
**** NOTE: As far as I know there is no proper way to do this, and currently the program checks every drop against the active playlist selection. If they are the same (same items and in the same order), drop is interpreted as queuing from the playlist. In addition, I've implemented a check that matches the dropped items against ''currently selected items''. ''Currently selected items'' are the selected items of the currently focused UI element. This is not 100% fool proof but it should work in 99.9 % of the regular cases. (And in the 0.01 % of the cases it still doesn't explode the universe).
** Other:
*** Queue playlist functionality is now disabled by default for new installations.

* '''0.3.1 / 2010-04-13'''
** Bug fixes:
*** Foobar2000 keyboard shortcuts now work even if the uie element has the focus
*** Fixed column autosizing logic when resizing or adding a column

* '''0.3 / 2010-04-13'''
** '''Note that you will lose the format string you defined in version 0.2 when moving to a newer version. Please backup the format string before updating the component!'''
** Bug fixes:
*** reordering of queue playlist might fail if the playlist corresponding to a queue item is removed.
*** Wrong colors with default ui element when using system colors
*** When disabling queue playlist functionality, the playlist lock wasn't removed
*** When drag & dropping items to queue playlist, they are added twice.
*** Different selection logic in ui element when compared to default ui playlist
** Improvements:
*** Columns ui element support (CUI). Uses CUI font and color configuration facilities.
*** Added user-configurable columns support to ui elements. Columns can be configured from settings
*** Drag & Drop support for ui element outside and inside of foobar2000. Queue order can also be changed by drag & drop.
*** Added context menu to ui element with "Show Column Header", "Auto-Scale columns with Window Size", "Move To Top", "Move To Bottom" and "Delete" options.
*** selection of queue item(s) in the ui element is reflected in "Selection Properties" (and others like album art) UI element.
*** Focus and selection rectangle follows default ui playlist style (i.e. solid line)

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-18T06:55:33Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.5 / 2010-01-18'''
** Potential race condition resolved.
* '''0.1.4 / 2010-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-18T06:50:10Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.5 / 2010-01-18'''
* Potential race condition resolved.
* '''0.1.4 / 2010-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-14T06:49:16Z

Salski: /* General */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' command in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.4 / 2010-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-14T06:41:55Z

Salski: /* General */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

From 0.1.4 onwards the component includes ''Restore last removed playlist'' in the ''Edit'' menu.

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

In addition to the above commands, the component features 'Restore last removed playlist' command, available in the ''Edit'' menu.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.4 / 2010-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-14T06:39:23Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.4 / 2010-01-14'''
** Playlist removals no longer produce history which contain the same playlist many times in the row.
** 'Restore last removed playlist' command added to Edit menu. Effect is same as the standard 'restore' command when right clicking the playlist manager.
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

File:Menu.png

2011-01-12T12:17:54Z

Salski: uploaded a new version of "File:Menu.png"

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-12T12:13:27Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.3 / 2010-01-12'''
** Cleaned up main menu a little bit: it now includes a separator for commands.
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-12T10:32:51Z

Salski: /* Download link */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-12T10:22:25Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
The only configuration is ''After delete go to last active playlist'' in the ''View/Recently activated playlists'' menu.

If the setting is enabled (checked) and the currently visible playlist is removed, the last used (i.e. visible) playlist will be activated. Foobar default behaviour is preserved when setting is disabled (not checked); this is the default setting.

=Change Log=
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-12T10:16:55Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:Menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (instead of next playlist in the list which is the default. First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

File:Menu.png

2011-01-12T10:16:24Z

Salski: uploaded a new version of "File:Menu.png"

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-12T10:13:23Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1.2 / 2010-01-12'''
** 'After delete go to last active playlist' feature added. If activated and the currently active playlist is removed, the last used playlist will be activated (instead of next playlist in the list which is the default. First requested [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=77808&view=findpost&p=679792 here].)
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components

2011-01-12T09:14:51Z

Salski: /* Playlist tools */

{{title|foobar2000 Components}}

{{fb2k}}
This page contains most foobar2000 components available at time of history last update.
=Offical Components=
The following components are created and maintained by the foobar2000 development team. Support for them should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=29 Support forum]
===Included in Installer===
[[Image:Optional_features.png|thumb|The Optional Features screen of the fb2k Installer]]
In addition to foobar2000's core functionality, the following components can be installed as needed, in the Optional Features section of the installer.
*Audio CD Support (foo_cdda) Adds Support for [[CD|Audio CD]] Playback
*Album List (foo_albumlist) Gives quick access to Media Library Content with customizable tree view
*Archive Reader (foo_unpack) Adds support for playing files directly from ZIP RAR and GZIP archives
*[[Foobar2000:Converter|Converter (foo_converter)]] Converts files to WAV or any other formats using command line encoders
*[[Foobar2000:File_operations|File Operations (foo_fileops)]] Renames, moves, or copies files according to specified patterns
*[[Foobar2000:Components_0.9/Freedb_Tagger_(foo_freedb2)|freedb Tagger (foo_freedb2)]] Tag retrieving support from freedb service for any set of files (mp3,mpc,flac,...-not only CDDA tracks)
*ReplayGain Scanner (foo_rgscan) advanced solution for volume matching
*Standard DSPs (foo_dsp_std) Equalizer, resampler, advanced limiter, hard limiter, stereo to 4 channel upmixer and a couple other effects

===Additional Components===
These components are provided as separate downloads, found on the [http://www.foobar2000.org/components/author/Peter Additional Components page].
*[[Foobar2000:Components_0.9/ABX_Comparator(foo_abx)|ABX comparator (foo_abx)]] component for double blind listening tests
*[[Foobar2000:Components 0.9/ALAC Decoder (foo_input_alac)|ALAC Decoder (foo_input_alac)]] Apple Lossless ([[ALAC]]) decoder
* [[Foobar2000:Components 0.9/ASIO Output (foo_out_asio)|ASIO output support (foo_out_asio)]] Adds ASIO output support.
* [[Foobar2000:Components 0.9/Audio CD Writer (foo_burninate)|Audio CD Writer (foo_burninate)]] CD burning support
*[[Foobar2000:Components 0.9/Binary Comparator (foo_bitcompare)|Binary Comparator (foo_bitcompare)]] Performs binary comparison between two or more tracks and reports differences.
* [[Foobar2000:Components 0.9/Decoding Speed Test (foo_benchmark)|Decoding Speed Test (foo_benchmark)]] Measures decoding speed of audio files.
* [[Foobar2000:Components 0.9/File Integrity Verifier (foo_verifier)|File Integrity Verifier (foo_verifier)]] Checks specified media files for decoding errors.
* [[Foobar2000:Components 0.9/Convolve (foo_convolve)|Impulse response convolver (foo_convolve)]] Allows arbitrary effects to be captured and used inside foobar2000. ([http://www.hydrogenaudio.org/forums/index.php?showtopic=10611 More Info])
* [[Foobar2000:Components 0.9/Kernel Streaming Output (foo_out_ks)|Kernel Streaming support (foo_out_ks)]] Allows bit-exact playback bypassing Windows kernel mixer.
* [[Foobar2000:Components 0.9/Masstagger (foo_masstag)|Masstagger (foo_masstag)]] Automates various tag editing operations.
* [[Foobar2000:Components 0.9/Monkey's Audio Decoder (foo_input_monkey)|Monkey's Audio Decoder (foo_input_monkey)]] Adds decoding support for Monkey's Audio files (.[[APE]]) as well as APE Link files (.[[APL]]).
*[[Foobar2000:Components/Playback Statistics v3.x (foo playcount)|Playback Statistics (foo playcount)]] Collects playback statistics for your Media Library content.
* [[Foobar2000:Components 0.9/Quick Tagger (foo_quicktag)| Quick Tagger (foo_quicktag)]] Adds customizable context menu commands for quickly setting tag fields to preconfigured values
* [[Foobar2000:Components 0.9/Text Tools (foo texttools)|Text Tools (foo_texttools)]] Adds customizable context menu commands for copying information about the selected tracks to Windows Clipboard.
* [[Foobar2000:Components 0.9/WASAPI output support (foo_out_wasapi)|WASAPI output support (foo_out_wasapi)]] Adds Windows Audio Session API exclusive mode output support, allowing bit-exact output and muting all other sounds on Windows Vista and Windows 7 systems.

=3rd Party Components=
The following components are created and maintained by 3rd-party authors, using foobar2000's [http://www.foobar2000.org/SDK.html SDK]. Support for these components should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=33 3rd Party Plugins forum] Asking for help directly in the component's thread is usually preferred.
== User Interfaces ==

=== Columns UI ===
[[Foobar2000:Components 0.9/Columns UI (foo_ui_columns)|Columns UI (foo_ui_columns)]] Very popular alternate interface for foobar2000 based on a columns and panel layout.

Columns UI introduced components with [[#Panels|panel]] capability which extend the user interface.

== User Interface Addons ==
=== UI Elements ===
The [[Foobar2000:Components 0.9/Default user interface (foo_ui_std)|default user interface (foo_ui_std)]], included in the standard installation package, can be extended with the following component(s):
* [[Foobar2000:Components 0.9/Facets (foo_facets)|Facets (foo_facets)]] Flexible media library viewer based on linked lists.
* [[Foobar2000:Components 0.9/Text Display (foo_textdisplay)|Text Display (foo_textdisplay)]] Displays information about the playing or selected track.
* [[Foobar2000:Components/Waveform Seekbar (foo_wave_seekbar)|Waveform Seekbar (foo_wave_seekbar)]] Element for DUI with seekbar functionality on top of the waveform of the playing song.
* [[Foobar2000:Components/Queue Contents Editor (foo queuecontents)|Queue Contents Editor (foo_queuecontents)]] Edit and view queue contents using an UI Element.
* [[Foobar2000:Components/Quicksearch UI Element (foo quicksearch)|Quicksearch UI Element (foo_quicksearch)]] Search toolbar that sends results to a playlist.
* [[Foobar2000:Components/Playlist_Organizer_(foo_plorg)|Playlist Organizer (foo_plorg)]] Advanced playlist manager to organize playlists in a treeview.

=== Panels ===
Panels extend the functionality of Columns UI components.
* [[Foobar2000:Components 0.9/Album Art Panel (foo_uie_albumart)|Album Art Panel (foo_uie_albumart)]] Panel to display album art.
* [[Foobar2000:Components 0.9/Album List Panel (foo_uie_albumlist)|Album List Panel (foo_uie_albumlist)]] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, etc.)
* [[Foobar2000:Components 0.9/Bookmarks (foo_uie_bookmarks)|Bookmarks (foo_uie_bookmarks)]] Help you remember positions in songs.
* [[Foobar2000:Components 0.9/Console (foo_uie_console)|Console (foo_uie_console)]] Panel version of console. Displays diagnostic messages. Requires Columns UI 0.1.3 beta 1 or newer.
* [[Foobar2000:Components 0.9/Cover Flow (foo_bubble_coverflow)|Cover Flow (foo_bubble_coverflow)]] The plugin can work either as a UI panel or a standalone window (found in the view menu), and a fullscreen mode for both.
* [[Foobar2000:Components 0.9/Dockable Panels (foo_dockable_panels)|Dockable Panels (foo_dockable_panels)]] It allows you to create windows that host columns ui panels as floating windows that can be attached to the side of the main foobar2000 window or each other.
* [[Foobar2000:Components 0.9/Egoh Spectrum Analyser (foo_uie_vis_egoh)|Egoh Spectrum Analyser (foo_uie_vis_egoh)]] Similar to the default spectrum analyser.
* [[Foobar2000:Components 0.9/ELplaylist panel (foo uie elplaylist)|ELplaylist panel (foo uie elplaylist)]] Playlist panel replacement with extensive customization options.
* [[Foobar2000:Components 0.9/Explorer Panel (foo_uie_explorer)|Explorer Panel (foo_uie_explorer)]] Displays a treeview of selected disks/folders.
* [[Foobar2000:Components 0.9/Graphical Browser (foo uie graphical browser) |Graphical Browser (foo uie graphical browser)]] A panel that allows to browse media library by graphical or text tiles
* [[Foobar2000:Components 0.9/Lyrics Panel (foo_uie_lyrics_panel)|Lyrics Panel (foo_uie_lyrics_panel)]] Display lyrics stored in file tags.
* [[Foobar2000:Components 0.9/Music Browser (foo_browser)|Music Browser (foo_browser)]] Panels for Browsing Library, Similar to iTunes. No longer updated. Most have better success CUI's in-built [[Foobar2000:Components_0.9/Columns_UI_%28foo_ui_columns%29#Playlist_filters|filters]].
* [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter) | Panel Stack Splitter (foo_uie_panel_splitter)]] Allows you to place objects freely within the foobar2000 window, including panels, text, and images
* [[Foobar2000:Components 0.9/Playlist Dropdown (foo_uie_playlists_dropdown)|Playlist Dropdown (foo_uie_playlists_dropdown)]] Displays the playlist in a dropdown menu.
* [[Foobar2000:Components 0.9/Playlist Tree (foo_playlist_tree)|Playlist Tree (foo_playlist_tree)]] Tree based media library with many available customizations.
* [[Foobar2000:Components 0.9/Power Panels (foo_uie_powerpanels)|Power Panels (foo_uie_powerpanels)]] Seekbar and volume transparent version panels. Useful for theming.
* [[Foobar2000:Components 0.9/ProjectM Visualisation Panel (foo_uie_vis_projectM)|ProjectM Visualisation Panel (foo_uie_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components/Queue Contents Editor (foo queuecontents)|Queue Contents Editor (foo_queuecontents)]] Edit and view queue contents using an UI Element.
* [[Foobar2000:Components 0.9/Queue Manager (foo_uie_queuemanager)|Queue Manager (foo_uie_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[Foobar2000:Components 0.9/Tabs (foo_uie_tabs)|Tabs (foo_uie_tabs)]] Tabs allows you to break Pauli's Exclusion principle by placing multiple panels in the same position at the same time.
* [[Foobar2000:Components 0.9/Typefind (foo_typefind)|Typefind (foo_typefind)]] Provides some in-line search facilities.
* [[Foobar2000:Components/Waveform Seekbar (foo_wave_seekbar)|Waveform Seekbar (foo_wave_seekbar)]] Panel for CUI with seekbar functionality on top of the waveform of the playing song.
* [[Foobar2000:Components 0.9/WmpVis (foo_uie_wmpvis)|<span id="wmpvis">WmpVis (foo_uie_wmpvis)</span>]] Uses the visualizations from WMP.
* [[Foobar2000:Components 0.9/WSH panel (foo_uie_wsh_panel)|WSH panel (foo_uie_wsh_panel)]] Windows script host panel.

==DSP==
===Multichannel audio===
* [[Foobar2000:Components 0.9/ATSurround Processor (foo_dsp_atsurround)|ATSurround Processor (foo_dsp_atsurround)]] Reproduces surround sound information present in many stereo audio material and more.
* [[Foobar2000:Components 0.9/Channel Mixer (foo_channel_mixer)|Channel Mixer (foo_channel_mixer)]] Up/down mix to/from 1-6 channels.
* [[Foobar2000:Components 0.9/Dolby Pro Logic II wrapper (foo_dsp_pl2)|Dolby Pro Logic II wrapper (foo_dsp_pl2)]] Dolby Pro Logic II engine DLL (dll not included).
* [[Foobar2000:Components 0.9/Downmix (foo_dsp_downmix)|Downmix (foo_dsp_downmix)]] Downmix [[AC3]], [[DTS]], etc. to stereo.
* [[Foobar2000:Components 0.9/FreeSurround (foo_dsp_fsurround)|FreeSurround (foo_dsp_fsurround)]] It takes Dolby Surround / Pro Logic I/II encoded stereo music and decodes it into 5.1 sound.
* [[Foobar2000:Components 0.9/Surround Pan (foo_dsp_span)|Surround Pan (foo_dsp_span)]] WYSIWYG Surround panning.
===Headphones===
* [[Foobar2000:Components 0.9/4Front Headphones (foo_dsp_headphones9)|4Front Headphones (foo_dsp_headphones9)]] Effects for headphone users.
* [[Foobar2000:Components 0.9/BS2D (foo_dsp_bs2p)|BS2D (foo_dsp_bs2p)]] Improves headphone listening of regular hi-fi stereo records.
* [[Foobar2000:Components 0.9/Crossfeed (foo_dsp_crossfeed)|Crossfeed (foo_dsp_crossfeed)]] Filters the music to help reduce fatigue caused by listening to music with headphones.
* [[Foobar2000:Components 0.9/Dolby Headphone Wrapper (foo_dsp_dolbyhp)|Dolby Headphone Wrapper (foo_dsp_dolbyhp)]] Dolby Headphone engine DLL.
===Utilities===
* [[Foobar2000:Components 0.9/Post-track Silence (foo_dsp_silence)|Post-track Silence (foo_dsp_silence)]] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [[Foobar2000:Components 0.9/Voice Cut Filter (foo_dsp_centercut)|Voice Cut Filter (foo_dsp_centercut)]] Voice cut filter.
* [[Foobar2000:Components/Equalizer split (foo_dsp_eqsplit)|Equalizer split (foo_dsp_eqsplit)]] A meta-DSP that feeds each channel into a separate equalizer instance.
* [[Foobar2000:Components 0.9/XOver (foo_dsp_xover)|XOver (foo_dsp_xover)]] Implements this digital crossover to achieve active multi-amplification.
===Effects===
* [[Foobar2000:Components 0.9/Soundtouch (foo_dsp_soundtouch)|Soundtouch (foo_dsp_soundtouch)]] Ajust pitch, tempo and rate.
* [[Foobar2000:Components 0.9/Tube Sound (foo_dsp_tube)|Tube Sound (foo_dsp_tube)]] Emulate tube sound.
* [[Foobar2000:Components 0.9/VLevel (foo_dsp_vlevel)|VLevel (foo_dsp_vlevel)]] Dynamic compressor which amplifies the quiet parts of music.
===Converters===
* [[Foobar2000:Components/HDCD Decoder (foo_dsp_hdcd)|HDCD Decoder (foo_dsp_hdcd)]] This DSP component will decode HDCD data in any 16-bit PCM stream passed through it, resulting in 20-bit PCM.
* [[Foobar2000:Components 0.9/LPCM - Delta-PCM Converter (foo_dsp_delta)|LPCM - Delta-PCM Converter (foo_dsp_delta)]] Noise sharpening filter.
* [[Foobar2000:Components 0.9/SSRC (foo_dsp_ssrc)|SSRC (foo_dsp_ssrc)]] Sample rate converter.

===Multi-purpose===
* [[Foobar2000:Components 0.9/OSS/3D (foo_dsp_oss3ddsp)|OSS/3D (foo_dsp_oss3ddsp)]] Audio enhancement. SHAREWARE.
* [[Foobar2000:Components 0.9/Stereo Convolver (foo_dsp_stereoconv)|Stereo Convolver (foo_dsp_stereoconv)]] Take stereo audio and convolve each channel with two impulse responses.
* [[Foobar2000:Components 0.9/Winamp DSP Bridge (foo_dsp_winamp)|Winamp DSP Bridge (foo_dsp_winamp)]] Allows the use of Winamp DSPs.
* [[Foobar2000:Components/VST adapter|VST 2.4 adapter (foo_vst)]] Allows Foobar2000 users to use VST 2.4 plug-ins equally with “native” ones.
* [[Foobar2000:Components 0.9/George Yohng's VST Wrapper (foo_dsp_vstwrap)|George Yohng's VST Wrapper (foo_dsp_vstwrapper)]] Enables VST plug-ins.
* [[Foobar2000:Components 0.9/VST Host (foo_dsp_vst)|VST Host (foo_dsp_vst)]] Adds support to Virtual Studio Technology audio interface.

==Input==
===Music Decoders===
* [[Foobar2000:Components 0.9/AC3 Decoder (foo_ac3)|AC3 Decoder (foo_ac3)]] Decodes Dolby Digital lossy audio compression technologies format ([[AC3]]).
* [[Foobar2000:Components 0.9/DTS Decoder (foo_dts)|DTS Decoder (foo_dts)]] Decodes Digital Theater Systems ([[DTS]]) audio format.
* [[Foobar2000:Components 0.9/MIDI Synthesizer Host (foo_midi)|MIDI Synthesizer Host (foo_midi)]] Adds decoding support for General MIDI files (.MID) and RIFF MIDI files (.RMI) as well as several proprietary MIDI formats (.MIDS, .GMF, .HMI, .HMP, .MUS, .XMI).
* [[Foobar2000:Components 0.9/OptimFROG Lossless Audio Decoder (foo_input_ofr)|OptimFROG Lossless Audio Decoder (foo_input_ofr)]] Decodes both the Lossless ([[OptimFROG|OFR]]) and DualStream (OFS) audio format.
* [[Foobar2000:Components 0.9/Shorten Decoder (foo_input_shorten)|Shorten Decoder (foo_input_shorten)]] Decodes Shorten ([[SHN]]) audio format.
* [[Foobar2000:Components 0.9/SPDIF Passthrough (foo_spdif)|SPDIF Passthrough (foo_spdif)]] SPDIF passthrough for [[AC3]] and [[DTS]] files.
* [[Foobar2000:Components 0.9/TAK Decoder (foo_input_tak)|TAK Decoder (foo_input_tak)]] Adds support for decoding and tagging [[TAK]] files as well as reading embedded album art.
* [[Foobar2000:Components/TTA Audio Decoder (foo_input_tta)|TTA Audio Decoder (foo_input_tta)]] Decodes True Audio ([[TTA]]) audio format.

===Other Decoders===
* [[Foobar2000:Components 0.9/ADPCM Decoder (foo_adpcm)|ADPCM Decoder (foo_adpcm)]] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST, etc.)
* [[Foobar2000:Components 0.9/AdPlug decoder (foo_input_adplug)|AdPlug decoder (foo_input_adplug)]] Adds decoding support for all Adlib FM chip formats supported by the AdPlug library.
* [[Foobar2000:Components 0.9/Another Slight Atari Player (foo_asap)|Another Slight Atari Player (foo_asap)]] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [[Foobar2000:Components 0.9/AviSynth decoder (foo_input_avs)|AviSynth decoder (foo_input_avs)]] Adds decoding support for AviSynth scripts (.AVS), audio only.
* [[Foobar2000:Components/DSDIFF Decoder (foo_input_dsdiff)|DSDIFF Decoder (foo_input_dsdiff)]] Adds decoding support for DSDIFF files (.DFF).
* [[Foobar2000:Components 0.9/DUMB Module Decoder (foo_dumb)|DUMB Module Decoder (foo_dumb)]] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [[Foobar2000:Components 0.9/Game Emu Player (foo_gep)|Game Emu Player (foo_gep)]] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [[Foobar2000:Components 0.9/Ganbatte! (foo_ganbatte)|Ganbatte! (foo_ganbatte)]] Plays compressed Edlib (.d00, .d01) files.
* [[Foobar2000:Components/Hively Tracker Decoder (foo_input_hvl)|Hively Tracker Decoder (foo_input_hvl)]] Adds decoding support for Hively Tracker files (.HVL) as well as Abyss' Highest eXperience files (.AHX).
* [[Foobar2000:Components 0.9/Lunar 2 PCM Decoder (foo_lunar2)|Lunar 2 PCM Decoder (foo_lunar2)]] Plays audio files found on the original Lunar: Eternal Blue CD (RP*.PCM).
* [[Foobar2000:Components 0.9/M1 Decoder (foo_m1)|M1 Decoder (foo_m1)]] Plays arcade/pinball game sound.
* [[Foobar2000:Components 0.9/MDX Decoder (foo_input_mdx)|MDX Decoder (foo_input_mdx)]] MDX is a MIDI-like format that is designed to be played using the X68000's FM synthesizer.
* [[Foobar2000:Components 0.9/NSF Decoder (foo_input_nsf)|NSF Decoder (foo_input_nsf)]] NSF file is a sound data file containing instructions for the Nintendo Entertainment System (NES) sound hardware.
* [[Foobar2000:Components 0.9/PSF Decoder (foo_psf)|PSF Decoder (foo_psf)]] Plays PlayStation Sound Format (PSF) files.
* [[Foobar2000:Components/QSF decoder (foo_input_qsf)|QSF decoder (foo_input_qsf)]] Adds decoding support for Capcom QSound Sound Format files (.QSF/.MINIQSF).
* [[Foobar2000:Components 0.9/Reverse (foo_input_reverse)|Reverse (foo_input_reverse)]] Play music in reverse.
* [[Foobar2000:Components 0.9/SID Player 2 (foo_sid)|SID Player 2 (foo_sid)]] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.
* [[Foobar2000:Components 0.9/S98 Decoder (foo_input_s98)|S98 Decoder (foo_input_s98)]] Sound format for the NEC PC-98 microcomputer.
* [[Foobar2000:Components 0.9/USF Decoder (foo_input_usf)|USF Decoder (foo_input_usf)]] Decodes sound data ripped directly from a Nintendo 64 video game.

==Visualisation==
* [[Foobar2000:Components 0.9/Peakmeter (foo uie peakmeter)|Peakmeter for Columns UI (foo_uie_peakmeter)]] Displays the level for each channel in dB.
* [[Foobar2000:Components 0.9/Peakmeter Spectrum (foo uie vis peakmeter spectrum)|Peakmeter and spectrum analyzer (foo_uie_vis_peakmeter_spectrum)]] Plugin that combines a peakmeter with a spectrum analyzer.
* [[Foobar2000:Components 0.9/ProjectM Visualisation (foo_vis_projectM)|ProjectM Visualisation (foo_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[#wmpvis|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP. ''Panel version only''.

==Other==
===General===
* [[Foobar2000:Components 0.9/Alarm (foo_alarm)|Alarm (foo_alarm)]] Starts playback at the specified period of time.
* [[Foobar2000:Components/Automatic BPM Analyser (foo_bpm)|Automatic BPM Analyser (foo_bpm)]] Automatically calculate the BPM of songs. Manual BPM calculation also available.
* [[Foobar2000:Components 0.9/Autosave & Autobackup (foo_jesus)|Autosave & Autobackup (foo_jesus)]] Allows periodic automatic saving of configuration and other data in foobar2000 and keeping backup copies of such data.
* [[Foobar2000:Components 0.9/Channel Usage Visualisation (foo_vis_channelusage)|Channel Usage Visualisation (foo_vis_channelusage)]] Channel Usage Visualisation.
* [[Foobar2000:Components 0.9/EXTM3U Playlist Creator (foo_extm3u)|EXTM3U Playlist Creator (foo_extm3u)]] Allow to save current playlist in the EXTM3U format.
* [[Foobar2000:Components 0.9/Feature Watcher (foo_whatsnew)|Feature Watcher (foo_whatsnew)]] Watches for added or removed features.
* [[Foobar2000:Components 0.9/File Date (foo_filedate)|File Date (foo_filedate)]] Add to file tag date added, accessed, created or modified from context menu entries.
* [[Foobar2000:Components 0.9/HyperIM (foo_2hyperim)|HyperIM (foo_2hyperim)]] Provides 19 media macros.
* [[Foobar2000:Components 0.9/Infospect (foo_infospect)|Infospect (foo_infospect)]] Displays low level playback information.
* [[Foobar2000:Components 0.9/iPod Manager (foo_dop)|iPod Manager (foo_dop)]] Experimental iPod plugin for foobar2000 0.9.2+, currently in alpha version.
* [[Foobar2000:Components 0.9/Logitech G15 LCD Display (foo_g15lcd)|Logitech G15 LCD Display (foo_g15lcd)]] Control the LCD panel on a Logitech G15 keyboard.
* [[Foobar2000:Components 0.9/Logitech LCD Display & Visualization (foo_logitech_lcd)|Logitech LCD Display & Visualization (foo_logitech_lcd)]] Customizable visualizations and track info on the LCD panel on a Logitech G15/G19/Z-10.
* [[Foobar2000:Components 0.9/Menu Addons (foo_menu_addons)|Menu Addons (foo_menu_addons)]] Adds a few shortcuts in menu.
* [[Foobar2000:Components 0.9/Open URL (foo_openurl)|Open URL (foo_openurl)]] Adds a context menu item to open URLs from metadata fields in a web browser.
* [[Foobar2000:Components 0.9/Pause On Lock (foo_lock)|Pause On Lock (foo_lock)]] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [[Foobar2000:Components 0.9/Pause on Lock (extended) (foo_lock_ex)|Pause on Lock (extended) (foo_lock_ex)]] Pause playing on workstation lock. Optimized for use with Windows XP/2003.
* [[Foobar2000:Components 0.9/Preview (foo_preview)|Preview (foo_preview)]] Play only part of each track in the playlist.
* [[Foobar2000:Components 0.9/Replaygain Override (foo_rg_trn)|Replaygain Override (foo_rg_trn)]] Allows you to automatically switch between replaygain modes based on specified criteria (e.g. use track based RG for shuffle mode, etc.)
* [[Foobar2000:Components 0.9/Run (foo_run)|Run (foo_run)]] Able you to run a external program with the foobar syntax.
* [[Foobar2000:Components 0.9/Run Commands (foo_runcmd)|Run Commands (foo_runcmd)]] Search and execute menu commands.
* [[Foobar2000:Components 0.9/Scheduler (foo_scheduler)|Scheduler (foo_scheduler)]] Plugin for scheduling actions like play, stop, system shutdown/wake up and many more.
* [[Foobar2000:Components/Seekbox (foo_seek_box)|Seekbox (foo_seek_box)]] Main menu item that pops up a box for seeking to a particular hh:mm:ss time in the current track.
* [[Foobar2000:Components 0.9/Send To Device (foo_sendtodevice)|Send To Device (foo_sendtodevice)]] Add "Send to Device" feature.
* [[Foobar2000:Components 0.9/Shell Link Resolver (foo_lnk)|Shell Link Resolver (foo_lnk)]] Shell link resolver.
* [[Foobar2000:Components 0.9/Timebomb (foo_timebomb)|Timebomb (foo_timebomb)]] Stop playback / exit program after a specified time.
* [[Foobar2000:Components/Unix archive support (foo_unpack_unix)|Unix archive support (foo_unpack_unix)]] Adds support for reading from Unix Tape Archives (.TAR), gzip files (.GZ), and bzip2 files (.BZ2).
* [[Foobar2000:Components 0.9/Unpacker for 7-Zip archive (foo_unpack_7z) |Unpacker for 7-Zip archive (foo_unpack_7z)]]
* [[Foobar2000:Components 0.9/Unpacker for JMA archive (foo_unpack_jma)|Unpacker for JMA archive (foo_unpack_jma)]]
* [[Foobar2000:Components 0.9/Unpacker for LHA archive (foo_unpack_lha)|Unpacker for LHA archive (foo_unpack_lha)]]
* [[Foobar2000:Components/UPnP/DLNA Renderer, Server, Control Point (foo_upnp)|UPnP/DLNA Renderer, Server, Control Point (foo_upnp)]]
* [[Foobar2000:Components 0.9/Winamp API Emulator (foo_winamp_spam)|Winamp API Emulator (foo_winamp_spam)]] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.

===Lyrics===
* [[Foobar2000:Components 0.9/Gasazip Lyrics (foo_gasazip)|Gasazip Lyrics (foo_gasazip)]] Search for lyrics and displays it in external window.
* [[Foobar2000:Components 0.9/Lyrics Show 2(foo_uie_lyrics2)|Lyrics Show 2(foo_uie_lyrics2)]] Downloads and displays lyrics, with LRC/timestamp support.
* [[Foobar2000:Components 0.9/LyricsDB (foo_lyricsdb)|LyricsDB (foo_lyricsdb)]] Search lyrics basing on song's artist title and sometimes album.
* [[Foobar2000:Components 0.9/foo_lyricsgrabber2|Lyrics Grabber 2 (foo_lyricsgrabber2)]] Downloads lyrics and stores them in tags.
* [[Foobar2000:Components 0.9/Mini Lyrics (foo_ui_minilyrics)|Mini Lyrics (foo_ui_minilyrics)]] Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.
* [[Foobar2000:Components 0.9/Sakura Script Lyrics (foo_sstp_lyrics)|Sakura Script Lyrics (foo_sstp_lyrics)]] Plays a SAKURA script lyrics to a SSP client.

===Notifier===
* [[Foobar2000:Components 0.9/AMIP Wrapper (foo_amipwrapper)|AMIP Wrapper (foo_amipwrapper)]] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [[Foobar2000:Components 0.9/Listening To (foo_listeningto)|Listening To (foo_listeningto)]] Sends NowPlaying information to Miranda IM.
* [[Foobar2000:Components 0.9/Miranda IM Notifier (foo_mim_notify)|Miranda IM Notifier (foo_mim_notify)]] Sends configurable information about the current playing song to Miranda-IM and shows popup windows with this info.
* [[Foobar2000:Components 0.9/MSN avatar changer (foo_uie_albumart_msn)|MSN avatar changer (foo_uie_albumart_msn)]] Set currently playing song's album art as avatar.
* [[Foobar2000:Components 0.9/MSN Now Playing (alt) (foo_msnalt)|MSN Now Playing (alt) (foo_msnalt)]] Show the current song as "Now Playing" in MSN and Windows Live messenger.
* [[Foobar2000:Components_0.9/WLM_Notifier_(foo_wlm)|Windows Live Notifier (foo_wlm)]] Shows current song as "Now Playing" in in MSN Messenger and Windows Live messenger (WLM). Supports unicode.
* [[Foobar2000:Components 0.9/On-Screen Display (foo_osd)|On-Screen Display (foo_osd)]] On screen display of track information and volume bar.
* [[Foobar2000:Components 0.9/On-Screen Display GDI (foo_osd_gdiplus)|On-Screen Display GDI (foo_osd_gdiplus)]] Same as foo_osd but uses GDI+ for osd drawing.
* [[Foobar2000:Components 0.9/Pretty Popup (foo_prettypop)|Pretty Popup (foo_prettypop)]] Display a moderately sized popup of song information when a new song plays.

===Online database===
* [[Foobar2000:Components 0.9/Audioscrobbler (foo_audioscrobbler)|Audioscrobbler (foo_audioscrobbler)]] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.

===Online radio===
* [[Foobar2000:Components/Podcatcher (foo_podcatcher)|Podcatcher (foo_podcatcher)]] A podcatcher component for subscribing to, downloading, and playing RSS and Atom podcast feeds in foobar2000.
* [[Foobar2000:Components/Vorbis Streamer (foo_vorbisstream)|Vorbis Streamer (foo_vorbisstream)]] Streams Vorbis and associated metadata to Icecast2 and Shoutcast servers.
* [[Foobar2000:Components 0.9/XM Radio Online Player (foo_xm)|XM Radio Online Player (foo_xm)]] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

===Playlist tools===
* [[Foobar2000:Components 0.9/Audioscrobble Charts (foo_scrobblecharts)|Audioscrobble Charts (foo_scrobblecharts)]] Generate a playlist from an artist's Last.fm chart. It also allows you to sort a selection in the playlist by the artist's charts.
* [[Foobar2000:Components 0.9/Bin Pack (foo_binpack)|Bin Pack (foo_binpack)]] Creates playlists from a list with a maximum length.
* [[Foobar2000:Components 0.9/Command Playlist (foo_cmd_playlist)|Command Playlist (foo_cmd_playlist)]] Add /playlist-activate:"Name" to the foobar command line to activate the named playlist.
* [[Foobar2000:Components 0.9/Cuesheet Creator (foo_cuesheet_creator)|Cuesheet Creator (foo_cuesheet_creator)]] Cuesheet creator.
* [[Foobar2000:Components 0.9/Database Search (foo_dbsearch)|Database Search (foo_dbsearch)]] Database search.
* [[Foobar2000:Components 0.9/Default Video Player (foo_default_videoplayer)|Default Video Player (foo_default_videoplayer)]] Allows you to play your video clips from foobar playlist with default external player.
* [[Foobar2000:Components 0.9/Delete Current (foo_deletecurrent)|Delete Current (foo_deletecurrent)]] Adds a menu item giving the possibility to delete from computer the current playing track.
* [[Foobar2000:Components 0.9/Highlight Playing (foo_highlightplaying)|Highlight Playing (foo_highlightplaying)]] Highlights actual now playing item even when the playlist has been broken.
* [[Foobar2000:Components 0.9/History (foo_history)|History (foo_history)]] Very basic song history.
* [[Foobar2000:Components 0.9/Inactive Tracks (foo_skip)|Inactive Tracks (foo_skip)]] Skips tracks that are marked via a tag as inactive.
* [[Foobar2000:Components 0.9/MeowDB (foo_meowdb)|MeowDB (foo_meowdb)]] Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [[Foobar2000:Components 0.9/Navigator (foo_navigator)|Navigator (foo_navigator)]] Advanced history component.
* [[Foobar2000:Components 0.9/Now Playing Simple (foo_np_simple)|Now Playing Simple (foo_np_simple)]] Simple now playing plugin to output formatted string to plain text file.
* [[Foobar2000:Components 0.9/Playback Queue Viewer (foo_pqview)|Playback Queue Viewer (foo_pqview)]] Playback queue viewer.
* [[Foobar2000:Components 0.9/Playlist Bind (foo_playlist_bind)|Playlist Bind (foo_playlist_bind)]] Synchronize playlist with contents of specific directory.
* [[Foobar2000:Components 0.9/Playlist Clear (foo_playlistclear)|Playlist Clear (foo_playlistclear)]] All playlists are cleared at startup.
* [[Foobar2000:Components/Playlist History (foo playlisthistory)|Playlist History (foo playlisthistory)]] Enables playlist history in foobar2000, similar to page history in browsers.
* [[Foobar2000:Components 0.9/Playlist Manager (foo_playlist_manager)|Playlist Manager (foo_playlist_manager)]] Playlist manager.
* [[Foobar2000:Components 0.9/Playlist Name Enhenced (foo_playlist_name_enhanced)|Playlist Name Enhenced (foo_playlist_name_enhanced)]] Appends automatically playlist info ("items / length") to all playlist names.
* [[Foobar2000:Components 0.9/Playlist Tools (foo_utils)|Playlist Tools (foo_utils)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Playlist Tools for Matroska (foo_utils_mka)|Playlist Tools for Matroska (foo_utils_mka)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Queue Manager (foo_queuemanager)|Queue Manager (foo_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue. ''Non-ColumnUI obsolete version, try panel version instead.''
* [[Foobar2000:Components 0.9/Randomized Playlist Entry (foo_random)|Randomized Playlist Entry (foo_random)]] Randomized playlist entry.
* [[Foobar2000:Components 0.9/Rating (foo_rating)|Rating (foo_rating)]] Display an icon in the systray with a tooltip popup from which you can choose a rating between 1 and 5 for the currently playing file.
* [[Foobar2000:Components 0.9/Remove Played (foo_removeplayed)|Remove Played (foo_removeplayed)]] It removes tracks from the playlist once they've been played.
* [[Foobar2000:Components/Soft Playlists (foo_softplaylists)|Soft Playlists (foo_softplaylists)]] Can create different Last.fm related playlists, love tracks on Last.fm and save and load XSPF playlists (make playlists without hard paths).
* [[Foobar2000:Components 0.9/Track Finder (foo_trackfinder)|Track Finder (foo_trackfinder)]] Displays a context menu that lets you quickly find songs based on their album title or artists name.
* [[Foobar2000:Components 0.9/Track Position (foo_trackpos)|Track Position (foo_trackpos)]] Provides a new context menu item "place after current playing", that allows you to place any tracks after the current playing one in the playing playlist.
* [[Foobar2000:Components 0.9/XSPF (foo_xspf)|XSPF (foo_xspf)]] Adds XSPF support. XSPF is an open, XML based playlist format.

===Playback Statistics===
* [[Foobar2000:Components 0.9/Playback Statistics Custom (foo_playback_custom)|Playback Statistics Custom (foo_playback_custom)]] Stores playback statistics in tags like foo_playcount_mod, with claimed faster response, and uses foo_custominfo db if file is unavailable for writing.
* [[Foobar2000:Components 0.9/Play Count Mod (foo_playcount_mod)|Play Count Mod (foo_playcount_mod)]] Unofficial playcount modded to supress the update tag popups.

===Remote control===
* [[Foobar2000:Components 0.9/Advanced Controls (foo_advancedcontrols)|Advanced Controls (foo_advancedcontrols)]] Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [[Foobar2000:Components 0.9/Bluetooth Control (foo_bluetooth_ctrl)|Bluetooth Control (foo_bluetooth_ctrl)]] Control your favourite music player using your favourite Symbian-based bluetooth enabled phone.
* [[Foobar2000:Components 0.9/COM Automation Server (foo_comserver2)|COM Automation Server (foo_comserver2)]] Allows controlling foobar2000 through COM Automation
* [[Foobar2000:Components 0.9/Control Server (foo_controlserver)|Control Server (foo_controlserver)]] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [[Foobar2000:Components 0.9/DDE Control (foo_ddecontrol)|DDE Control (foo_ddecontrol)]] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [[Foobar2000:Components 0.9/HTTP Writer (foo_write_http)|HTTP Writer (foo_write_http)]] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [[Foobar2000:Components 0.9/Joystick Control (foo_joystick_control)|Joystick Control (foo_joystick_control)]] Control foobar2000 from a joystick/gamepad.
* [[Foobar2000:Components 0.9/Minibar2k (foo_Minibar2k)|Minibar2k (foo_Minibar2k)]] Control Foobar2k from your PDA (PocketPC based).
* [[Foobar2000:Components 0.9/Remote Control (foo_remotecontrol)|Remote Control (foo_remotecontrol)]] Adds support to Melloware Intelliremote software which claims to work with Creative remote control (Soundblaster Live!, Audigy, Extigy, Audigy ZS and Soundblaster X-Fi.)
* [[Foobar2000:Components 0.9/RM-1800 (foo_mr1800)|RM-1800 (foo_mr1800)]] Adds support of Creative X-Fi's remote (RM-1800).
* [[Foobar2000:Components 0.9/RM-X Media Edition (foo_rmx)|RM-X Media Edition (foo_rmx)]] Yet another plugin for remote control. SHAREWARE.
* [[Foobar2000:Components 0.9/Titlebar (foo_managedWrapper)|Titlebar (foo_managedWrapper)]] Create a personal title bar that shows the currently playing song on the top of the screen all the time. It supports custom-made skins.
* [[Foobar2000:Components 0.9/WinLIRC Client (foo_lirc)|WinLIRC Client (foo_lirc)]] Control Foobar from a remote control.

===Tagging===
* [[Foobar2000:Components 0.9/Chacon (foo_chacon)|Chacon (foo_chacon)]] Chacon is a simple tool for fixing tags by converting them between different character sets.
* [[Foobar2000:Components 0.9/Custom Info (foo_custominfo)|Custom Info (foo_custominfo)]] Allows you to set info fields for files without modifying them.
* [[Foobar2000:Components 0.9/Discogs (foo_discogs)|Discogs (foo_discogs)]] Retrieve info and album art from Discogs.com database.
* [[Foobar2000:Components 0.9/Freedb Tagger (foo_freedb2)|Freedb Tagger (foo_freedb2)]] Freedb.org tagger. Now included with official foobar2000 installers.
* [[Foobar2000:Components 0.9/Live Show Tagger (foo_tradersfriend)|Live Show Tagger (foo_tradersfriend)]] Live show tagger.

==Links==
* [http://www.foobar2000.org/components Official third-party components site]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 List of components] from earlier versions not yet ported to 0.9.x.

* [[foobar2000:foobar2000|Go back to Main Page]]

Foobar2000:Components 0.9/foo playlisthistory

2011-01-12T09:10:45Z

Salski: Redirected page to Foobar2000:Components/Playlist History (foo playlisthistory)

#REDIRECT [[Foobar2000:Components/Playlist_History_(foo_playlisthistory)]]

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-11T06:49:42Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [http://www.foobar2000.org/components/view/foo_playlisthistory here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-11T06:49:15Z

Salski: /* Change Log */

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [notYet here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1.1 / 2010-01-11'''
** More verbose component description added.
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-11T06:35:30Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [notYet here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [http://www.hydrogenaudio.org/forums/index.php?showtopic=86082 this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-11T06:27:57Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to page history in browsers.

The component watches activated playlists and provides the user ''back'' and ''next'' buttons to navigate the ''playlist history''.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [notYet here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [insert link this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. If you like, these two commands can bound to keyboard shortcuts as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1 / 2010-01-10'''
** Initial release

Foobar2000:Components

2011-01-11T06:02:02Z

Salski: foo_queuecontents added to the list

{{title|foobar2000 Components}}

{{fb2k}}
This page contains most foobar2000 components available at time of history last update.
=Offical Components=
The following components are created and maintained by the foobar2000 development team. Support for them should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=29 Support forum]
===Included in Installer===
[[Image:Optional_features.png|thumb|The Optional Features screen of the fb2k Installer]]
In addition to foobar2000's core functionality, the following components can be installed as needed, in the Optional Features section of the installer.
*Audio CD Support (foo_cdda) Adds Support for [[CD|Audio CD]] Playback
*Album List (foo_albumlist) Gives quick access to Media Library Content with customizable tree view
*Archive Reader (foo_unpack) Adds support for playing files directly from ZIP RAR and GZIP archives
*[[Foobar2000:Converter|Converter (foo_converter)]] Converts files to WAV or any other formats using command line encoders
*[[Foobar2000:File_operations|File Operations (foo_fileops)]] Renames, moves, or copies files according to specified patterns
*[[Foobar2000:Components_0.9/Freedb_Tagger_(foo_freedb2)|freedb Tagger (foo_freedb2)]] Tag retrieving support from freedb service for any set of files (mp3,mpc,flac,...-not only CDDA tracks)
*ReplayGain Scanner (foo_rgscan) advanced solution for volume matching
*Standard DSPs (foo_dsp_std) Equalizer, resampler, advanced limiter, hard limiter, stereo to 4 channel upmixer and a couple other effects

===Additional Components===
These components are provided as separate downloads, found on the [http://www.foobar2000.org/components/author/Peter Additional Components page].
*[[Foobar2000:Components_0.9/ABX_Comparator(foo_abx)|ABX comparator (foo_abx)]] component for double blind listening tests
*[[Foobar2000:Components 0.9/ALAC Decoder (foo_input_alac)|ALAC Decoder (foo_input_alac)]] Apple Lossless ([[ALAC]]) decoder
* [[Foobar2000:Components 0.9/ASIO Output (foo_out_asio)|ASIO output support (foo_out_asio)]] Adds ASIO output support.
* [[Foobar2000:Components 0.9/Audio CD Writer (foo_burninate)|Audio CD Writer (foo_burninate)]] CD burning support
*[[Foobar2000:Components 0.9/Binary Comparator (foo_bitcompare)|Binary Comparator (foo_bitcompare)]] Performs binary comparison between two or more tracks and reports differences.
* [[Foobar2000:Components 0.9/Decoding Speed Test (foo_benchmark)|Decoding Speed Test (foo_benchmark)]] Measures decoding speed of audio files.
* [[Foobar2000:Components 0.9/File Integrity Verifier (foo_verifier)|File Integrity Verifier (foo_verifier)]] Checks specified media files for decoding errors.
* [[Foobar2000:Components 0.9/Convolve (foo_convolve)|Impulse response convolver (foo_convolve)]] Allows arbitrary effects to be captured and used inside foobar2000. ([http://www.hydrogenaudio.org/forums/index.php?showtopic=10611 More Info])
* [[Foobar2000:Components 0.9/Kernel Streaming Output (foo_out_ks)|Kernel Streaming support (foo_out_ks)]] Allows bit-exact playback bypassing Windows kernel mixer.
* [[Foobar2000:Components 0.9/Masstagger (foo_masstag)|Masstagger (foo_masstag)]] Automates various tag editing operations.
* [[Foobar2000:Components 0.9/Monkey's Audio Decoder (foo_input_monkey)|Monkey's Audio Decoder (foo_input_monkey)]] Adds decoding support for Monkey's Audio files (.[[APE]]) as well as APE Link files (.[[APL]]).
*[[Foobar2000:Components/Playback Statistics v3.x (foo playcount)|Playback Statistics (foo playcount)]] Collects playback statistics for your Media Library content.
* [[Foobar2000:Components 0.9/Quick Tagger (foo_quicktag)| Quick Tagger (foo_quicktag)]] Adds customizable context menu commands for quickly setting tag fields to preconfigured values
* [[Foobar2000:Components 0.9/Text Tools (foo texttools)|Text Tools (foo_texttools)]] Adds customizable context menu commands for copying information about the selected tracks to Windows Clipboard.
* [[Foobar2000:Components 0.9/WASAPI output support (foo_out_wasapi)|WASAPI output support (foo_out_wasapi)]] Adds Windows Audio Session API exclusive mode output support, allowing bit-exact output and muting all other sounds on Windows Vista and Windows 7 systems.

=3rd Party Components=
The following components are created and maintained by 3rd-party authors, using foobar2000's [http://www.foobar2000.org/SDK.html SDK]. Support for these components should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=33 3rd Party Plugins forum] Asking for help directly in the component's thread is usually preferred.
== User Interfaces ==

=== Columns UI ===
[[Foobar2000:Components 0.9/Columns UI (foo_ui_columns)|Columns UI (foo_ui_columns)]] Very popular alternate interface for foobar2000 based on a columns and panel layout.

Columns UI introduced components with [[#Panels|panel]] capability which extend the user interface.

== User Interface Addons ==
=== UI Elements ===
The [[Foobar2000:Components 0.9/Default user interface (foo_ui_std)|default user interface (foo_ui_std)]], included in the standard installation package, can be extended with the following component(s):
* [[Foobar2000:Components 0.9/Facets (foo_facets)|Facets (foo_facets)]] Flexible media library viewer based on linked lists.
* [[Foobar2000:Components 0.9/Text Display (foo_textdisplay)|Text Display (foo_textdisplay)]] Displays information about the playing or selected track.
* [[Foobar2000:Components/Waveform Seekbar (foo_wave_seekbar)|Waveform Seekbar (foo_wave_seekbar)]] Element for DUI with seekbar functionality on top of the waveform of the playing song.
* [[Foobar2000:Components/Queue Contents Editor (foo queuecontents)|Queue Contents Editor (foo_queuecontents)]] Edit and view queue contents using an UI Element.
* [[Foobar2000:Components/Quicksearch UI Element (foo quicksearch)|Quicksearch UI Element (foo_quicksearch)]] Search toolbar that sends results to a playlist.
* [[Foobar2000:Components/Playlist_Organizer_(foo_plorg)|Playlist Organizer (foo_plorg)]] Advanced playlist manager to organize playlists in a treeview.

=== Panels ===
Panels extend the functionality of Columns UI components.
* [[Foobar2000:Components 0.9/Album Art Panel (foo_uie_albumart)|Album Art Panel (foo_uie_albumart)]] Panel to display album art.
* [[Foobar2000:Components 0.9/Album List Panel (foo_uie_albumlist)|Album List Panel (foo_uie_albumlist)]] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, etc.)
* [[Foobar2000:Components 0.9/Bookmarks (foo_uie_bookmarks)|Bookmarks (foo_uie_bookmarks)]] Help you remember positions in songs.
* [[Foobar2000:Components 0.9/Console (foo_uie_console)|Console (foo_uie_console)]] Panel version of console. Displays diagnostic messages. Requires Columns UI 0.1.3 beta 1 or newer.
* [[Foobar2000:Components 0.9/Cover Flow (foo_bubble_coverflow)|Cover Flow (foo_bubble_coverflow)]] The plugin can work either as a UI panel or a standalone window (found in the view menu), and a fullscreen mode for both.
* [[Foobar2000:Components 0.9/Dockable Panels (foo_dockable_panels)|Dockable Panels (foo_dockable_panels)]] It allows you to create windows that host columns ui panels as floating windows that can be attached to the side of the main foobar2000 window or each other.
* [[Foobar2000:Components 0.9/Egoh Spectrum Analyser (foo_uie_vis_egoh)|Egoh Spectrum Analyser (foo_uie_vis_egoh)]] Similar to the default spectrum analyser.
* [[Foobar2000:Components 0.9/ELplaylist panel (foo uie elplaylist)|ELplaylist panel (foo uie elplaylist)]] Playlist panel replacement with extensive customization options.
* [[Foobar2000:Components 0.9/Explorer Panel (foo_uie_explorer)|Explorer Panel (foo_uie_explorer)]] Displays a treeview of selected disks/folders.
* [[Foobar2000:Components 0.9/Graphical Browser (foo uie graphical browser) |Graphical Browser (foo uie graphical browser)]] A panel that allows to browse media library by graphical or text tiles
* [[Foobar2000:Components 0.9/Lyrics Panel (foo_uie_lyrics_panel)|Lyrics Panel (foo_uie_lyrics_panel)]] Display lyrics stored in file tags.
* [[Foobar2000:Components 0.9/Music Browser (foo_browser)|Music Browser (foo_browser)]] Panels for Browsing Library, Similar to iTunes. No longer updated. Most have better success CUI's in-built [[Foobar2000:Components_0.9/Columns_UI_%28foo_ui_columns%29#Playlist_filters|filters]].
* [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter) | Panel Stack Splitter (foo_uie_panel_splitter)]] Allows you to place objects freely within the foobar2000 window, including panels, text, and images
* [[Foobar2000:Components 0.9/Playlist Dropdown (foo_uie_playlists_dropdown)|Playlist Dropdown (foo_uie_playlists_dropdown)]] Displays the playlist in a dropdown menu.
* [[Foobar2000:Components 0.9/Playlist Tree (foo_playlist_tree)|Playlist Tree (foo_playlist_tree)]] Tree based media library with many available customizations.
* [[Foobar2000:Components 0.9/Power Panels (foo_uie_powerpanels)|Power Panels (foo_uie_powerpanels)]] Seekbar and volume transparent version panels. Useful for theming.
* [[Foobar2000:Components 0.9/ProjectM Visualisation Panel (foo_uie_vis_projectM)|ProjectM Visualisation Panel (foo_uie_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components/Queue Contents Editor (foo queuecontents)|Queue Contents Editor (foo_queuecontents)]] Edit and view queue contents using an UI Element.
* [[Foobar2000:Components 0.9/Queue Manager (foo_uie_queuemanager)|Queue Manager (foo_uie_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[Foobar2000:Components 0.9/Tabs (foo_uie_tabs)|Tabs (foo_uie_tabs)]] Tabs allows you to break Pauli's Exclusion principle by placing multiple panels in the same position at the same time.
* [[Foobar2000:Components 0.9/Typefind (foo_typefind)|Typefind (foo_typefind)]] Provides some in-line search facilities.
* [[Foobar2000:Components/Waveform Seekbar (foo_wave_seekbar)|Waveform Seekbar (foo_wave_seekbar)]] Panel for CUI with seekbar functionality on top of the waveform of the playing song.
* [[Foobar2000:Components 0.9/WmpVis (foo_uie_wmpvis)|<span id="wmpvis">WmpVis (foo_uie_wmpvis)</span>]] Uses the visualizations from WMP.
* [[Foobar2000:Components 0.9/WSH panel (foo_uie_wsh_panel)|WSH panel (foo_uie_wsh_panel)]] Windows script host panel.

==DSP==
===Multichannel audio===
* [[Foobar2000:Components 0.9/ATSurround Processor (foo_dsp_atsurround)|ATSurround Processor (foo_dsp_atsurround)]] Reproduces surround sound information present in many stereo audio material and more.
* [[Foobar2000:Components 0.9/Channel Mixer (foo_channel_mixer)|Channel Mixer (foo_channel_mixer)]] Up/down mix to/from 1-6 channels.
* [[Foobar2000:Components 0.9/Dolby Pro Logic II wrapper (foo_dsp_pl2)|Dolby Pro Logic II wrapper (foo_dsp_pl2)]] Dolby Pro Logic II engine DLL (dll not included).
* [[Foobar2000:Components 0.9/Downmix (foo_dsp_downmix)|Downmix (foo_dsp_downmix)]] Downmix [[AC3]], [[DTS]], etc. to stereo.
* [[Foobar2000:Components 0.9/FreeSurround (foo_dsp_fsurround)|FreeSurround (foo_dsp_fsurround)]] It takes Dolby Surround / Pro Logic I/II encoded stereo music and decodes it into 5.1 sound.
* [[Foobar2000:Components 0.9/Surround Pan (foo_dsp_span)|Surround Pan (foo_dsp_span)]] WYSIWYG Surround panning.
===Headphones===
* [[Foobar2000:Components 0.9/4Front Headphones (foo_dsp_headphones9)|4Front Headphones (foo_dsp_headphones9)]] Effects for headphone users.
* [[Foobar2000:Components 0.9/BS2D (foo_dsp_bs2p)|BS2D (foo_dsp_bs2p)]] Improves headphone listening of regular hi-fi stereo records.
* [[Foobar2000:Components 0.9/Crossfeed (foo_dsp_crossfeed)|Crossfeed (foo_dsp_crossfeed)]] Filters the music to help reduce fatigue caused by listening to music with headphones.
* [[Foobar2000:Components 0.9/Dolby Headphone Wrapper (foo_dsp_dolbyhp)|Dolby Headphone Wrapper (foo_dsp_dolbyhp)]] Dolby Headphone engine DLL.
===Utilities===
* [[Foobar2000:Components 0.9/Post-track Silence (foo_dsp_silence)|Post-track Silence (foo_dsp_silence)]] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [[Foobar2000:Components 0.9/Voice Cut Filter (foo_dsp_centercut)|Voice Cut Filter (foo_dsp_centercut)]] Voice cut filter.
* [[Foobar2000:Components/Equalizer split (foo_dsp_eqsplit)|Equalizer split (foo_dsp_eqsplit)]] A meta-DSP that feeds each channel into a separate equalizer instance.
* [[Foobar2000:Components 0.9/XOver (foo_dsp_xover)|XOver (foo_dsp_xover)]] Implements this digital crossover to achieve active multi-amplification.
===Effects===
* [[Foobar2000:Components 0.9/Soundtouch (foo_dsp_soundtouch)|Soundtouch (foo_dsp_soundtouch)]] Ajust pitch, tempo and rate.
* [[Foobar2000:Components 0.9/Tube Sound (foo_dsp_tube)|Tube Sound (foo_dsp_tube)]] Emulate tube sound.
* [[Foobar2000:Components 0.9/VLevel (foo_dsp_vlevel)|VLevel (foo_dsp_vlevel)]] Dynamic compressor which amplifies the quiet parts of music.
===Converters===
* [[Foobar2000:Components/HDCD Decoder (foo_dsp_hdcd)|HDCD Decoder (foo_dsp_hdcd)]] This DSP component will decode HDCD data in any 16-bit PCM stream passed through it, resulting in 20-bit PCM.
* [[Foobar2000:Components 0.9/LPCM - Delta-PCM Converter (foo_dsp_delta)|LPCM - Delta-PCM Converter (foo_dsp_delta)]] Noise sharpening filter.
* [[Foobar2000:Components 0.9/SSRC (foo_dsp_ssrc)|SSRC (foo_dsp_ssrc)]] Sample rate converter.

===Multi-purpose===
* [[Foobar2000:Components 0.9/OSS/3D (foo_dsp_oss3ddsp)|OSS/3D (foo_dsp_oss3ddsp)]] Audio enhancement. SHAREWARE.
* [[Foobar2000:Components 0.9/Stereo Convolver (foo_dsp_stereoconv)|Stereo Convolver (foo_dsp_stereoconv)]] Take stereo audio and convolve each channel with two impulse responses.
* [[Foobar2000:Components 0.9/Winamp DSP Bridge (foo_dsp_winamp)|Winamp DSP Bridge (foo_dsp_winamp)]] Allows the use of Winamp DSPs.
* [[Foobar2000:Components/VST adapter|VST 2.4 adapter (foo_vst)]] Allows Foobar2000 users to use VST 2.4 plug-ins equally with “native” ones.
* [[Foobar2000:Components 0.9/George Yohng's VST Wrapper (foo_dsp_vstwrap)|George Yohng's VST Wrapper (foo_dsp_vstwrapper)]] Enables VST plug-ins.
* [[Foobar2000:Components 0.9/VST Host (foo_dsp_vst)|VST Host (foo_dsp_vst)]] Adds support to Virtual Studio Technology audio interface.

==Input==
===Music Decoders===
* [[Foobar2000:Components 0.9/AC3 Decoder (foo_ac3)|AC3 Decoder (foo_ac3)]] Decodes Dolby Digital lossy audio compression technologies format ([[AC3]]).
* [[Foobar2000:Components 0.9/DTS Decoder (foo_dts)|DTS Decoder (foo_dts)]] Decodes Digital Theater Systems ([[DTS]]) audio format.
* [[Foobar2000:Components 0.9/MIDI Synthesizer Host (foo_midi)|MIDI Synthesizer Host (foo_midi)]] Adds decoding support for General MIDI files (.MID) and RIFF MIDI files (.RMI) as well as several proprietary MIDI formats (.MIDS, .GMF, .HMI, .HMP, .MUS, .XMI).
* [[Foobar2000:Components 0.9/OptimFROG Lossless Audio Decoder (foo_input_ofr)|OptimFROG Lossless Audio Decoder (foo_input_ofr)]] Decodes both the Lossless ([[OptimFROG|OFR]]) and DualStream (OFS) audio format.
* [[Foobar2000:Components 0.9/Shorten Decoder (foo_input_shorten)|Shorten Decoder (foo_input_shorten)]] Decodes Shorten ([[SHN]]) audio format.
* [[Foobar2000:Components 0.9/SPDIF Passthrough (foo_spdif)|SPDIF Passthrough (foo_spdif)]] SPDIF passthrough for [[AC3]] and [[DTS]] files.
* [[Foobar2000:Components 0.9/TAK Decoder (foo_input_tak)|TAK Decoder (foo_input_tak)]] Adds support for decoding and tagging [[TAK]] files as well as reading embedded album art.
* [[Foobar2000:Components/TTA Audio Decoder (foo_input_tta)|TTA Audio Decoder (foo_input_tta)]] Decodes True Audio ([[TTA]]) audio format.

===Other Decoders===
* [[Foobar2000:Components 0.9/ADPCM Decoder (foo_adpcm)|ADPCM Decoder (foo_adpcm)]] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST, etc.)
* [[Foobar2000:Components 0.9/AdPlug decoder (foo_input_adplug)|AdPlug decoder (foo_input_adplug)]] Adds decoding support for all Adlib FM chip formats supported by the AdPlug library.
* [[Foobar2000:Components 0.9/Another Slight Atari Player (foo_asap)|Another Slight Atari Player (foo_asap)]] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [[Foobar2000:Components 0.9/AviSynth decoder (foo_input_avs)|AviSynth decoder (foo_input_avs)]] Adds decoding support for AviSynth scripts (.AVS), audio only.
* [[Foobar2000:Components/DSDIFF Decoder (foo_input_dsdiff)|DSDIFF Decoder (foo_input_dsdiff)]] Adds decoding support for DSDIFF files (.DFF).
* [[Foobar2000:Components 0.9/DUMB Module Decoder (foo_dumb)|DUMB Module Decoder (foo_dumb)]] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [[Foobar2000:Components 0.9/Game Emu Player (foo_gep)|Game Emu Player (foo_gep)]] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [[Foobar2000:Components 0.9/Ganbatte! (foo_ganbatte)|Ganbatte! (foo_ganbatte)]] Plays compressed Edlib (.d00, .d01) files.
* [[Foobar2000:Components/Hively Tracker Decoder (foo_input_hvl)|Hively Tracker Decoder (foo_input_hvl)]] Adds decoding support for Hively Tracker files (.HVL) as well as Abyss' Highest eXperience files (.AHX).
* [[Foobar2000:Components 0.9/Lunar 2 PCM Decoder (foo_lunar2)|Lunar 2 PCM Decoder (foo_lunar2)]] Plays audio files found on the original Lunar: Eternal Blue CD (RP*.PCM).
* [[Foobar2000:Components 0.9/M1 Decoder (foo_m1)|M1 Decoder (foo_m1)]] Plays arcade/pinball game sound.
* [[Foobar2000:Components 0.9/MDX Decoder (foo_input_mdx)|MDX Decoder (foo_input_mdx)]] MDX is a MIDI-like format that is designed to be played using the X68000's FM synthesizer.
* [[Foobar2000:Components 0.9/NSF Decoder (foo_input_nsf)|NSF Decoder (foo_input_nsf)]] NSF file is a sound data file containing instructions for the Nintendo Entertainment System (NES) sound hardware.
* [[Foobar2000:Components 0.9/PSF Decoder (foo_psf)|PSF Decoder (foo_psf)]] Plays PlayStation Sound Format (PSF) files.
* [[Foobar2000:Components/QSF decoder (foo_input_qsf)|QSF decoder (foo_input_qsf)]] Adds decoding support for Capcom QSound Sound Format files (.QSF/.MINIQSF).
* [[Foobar2000:Components 0.9/Reverse (foo_input_reverse)|Reverse (foo_input_reverse)]] Play music in reverse.
* [[Foobar2000:Components 0.9/SID Player 2 (foo_sid)|SID Player 2 (foo_sid)]] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.
* [[Foobar2000:Components 0.9/S98 Decoder (foo_input_s98)|S98 Decoder (foo_input_s98)]] Sound format for the NEC PC-98 microcomputer.
* [[Foobar2000:Components 0.9/USF Decoder (foo_input_usf)|USF Decoder (foo_input_usf)]] Decodes sound data ripped directly from a Nintendo 64 video game.

==Visualisation==
* [[Foobar2000:Components 0.9/Peakmeter (foo uie peakmeter)|Peakmeter for Columns UI (foo_uie_peakmeter)]] Displays the level for each channel in dB.
* [[Foobar2000:Components 0.9/Peakmeter Spectrum (foo uie vis peakmeter spectrum)|Peakmeter and spectrum analyzer (foo_uie_vis_peakmeter_spectrum)]] Plugin that combines a peakmeter with a spectrum analyzer.
* [[Foobar2000:Components 0.9/ProjectM Visualisation (foo_vis_projectM)|ProjectM Visualisation (foo_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[#wmpvis|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP. ''Panel version only''.

==Other==
===General===
* [[Foobar2000:Components 0.9/Alarm (foo_alarm)|Alarm (foo_alarm)]] Starts playback at the specified period of time.
* [[Foobar2000:Components/Automatic BPM Analyser (foo_bpm)|Automatic BPM Analyser (foo_bpm)]] Automatically calculate the BPM of songs. Manual BPM calculation also available.
* [[Foobar2000:Components 0.9/Autosave & Autobackup (foo_jesus)|Autosave & Autobackup (foo_jesus)]] Allows periodic automatic saving of configuration and other data in foobar2000 and keeping backup copies of such data.
* [[Foobar2000:Components 0.9/Channel Usage Visualisation (foo_vis_channelusage)|Channel Usage Visualisation (foo_vis_channelusage)]] Channel Usage Visualisation.
* [[Foobar2000:Components 0.9/EXTM3U Playlist Creator (foo_extm3u)|EXTM3U Playlist Creator (foo_extm3u)]] Allow to save current playlist in the EXTM3U format.
* [[Foobar2000:Components 0.9/Feature Watcher (foo_whatsnew)|Feature Watcher (foo_whatsnew)]] Watches for added or removed features.
* [[Foobar2000:Components 0.9/File Date (foo_filedate)|File Date (foo_filedate)]] Add to file tag date added, accessed, created or modified from context menu entries.
* [[Foobar2000:Components 0.9/HyperIM (foo_2hyperim)|HyperIM (foo_2hyperim)]] Provides 19 media macros.
* [[Foobar2000:Components 0.9/Infospect (foo_infospect)|Infospect (foo_infospect)]] Displays low level playback information.
* [[Foobar2000:Components 0.9/iPod Manager (foo_dop)|iPod Manager (foo_dop)]] Experimental iPod plugin for foobar2000 0.9.2+, currently in alpha version.
* [[Foobar2000:Components 0.9/Logitech G15 LCD Display (foo_g15lcd)|Logitech G15 LCD Display (foo_g15lcd)]] Control the LCD panel on a Logitech G15 keyboard.
* [[Foobar2000:Components 0.9/Logitech LCD Display & Visualization (foo_logitech_lcd)|Logitech LCD Display & Visualization (foo_logitech_lcd)]] Customizable visualizations and track info on the LCD panel on a Logitech G15/G19/Z-10.
* [[Foobar2000:Components 0.9/Menu Addons (foo_menu_addons)|Menu Addons (foo_menu_addons)]] Adds a few shortcuts in menu.
* [[Foobar2000:Components 0.9/Open URL (foo_openurl)|Open URL (foo_openurl)]] Adds a context menu item to open URLs from metadata fields in a web browser.
* [[Foobar2000:Components 0.9/Pause On Lock (foo_lock)|Pause On Lock (foo_lock)]] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [[Foobar2000:Components 0.9/Pause on Lock (extended) (foo_lock_ex)|Pause on Lock (extended) (foo_lock_ex)]] Pause playing on workstation lock. Optimized for use with Windows XP/2003.
* [[Foobar2000:Components 0.9/Preview (foo_preview)|Preview (foo_preview)]] Play only part of each track in the playlist.
* [[Foobar2000:Components 0.9/Replaygain Override (foo_rg_trn)|Replaygain Override (foo_rg_trn)]] Allows you to automatically switch between replaygain modes based on specified criteria (e.g. use track based RG for shuffle mode, etc.)
* [[Foobar2000:Components 0.9/Run (foo_run)|Run (foo_run)]] Able you to run a external program with the foobar syntax.
* [[Foobar2000:Components 0.9/Run Commands (foo_runcmd)|Run Commands (foo_runcmd)]] Search and execute menu commands.
* [[Foobar2000:Components 0.9/Scheduler (foo_scheduler)|Scheduler (foo_scheduler)]] Plugin for scheduling actions like play, stop, system shutdown/wake up and many more.
* [[Foobar2000:Components/Seekbox (foo_seek_box)|Seekbox (foo_seek_box)]] Main menu item that pops up a box for seeking to a particular hh:mm:ss time in the current track.
* [[Foobar2000:Components 0.9/Send To Device (foo_sendtodevice)|Send To Device (foo_sendtodevice)]] Add "Send to Device" feature.
* [[Foobar2000:Components 0.9/Shell Link Resolver (foo_lnk)|Shell Link Resolver (foo_lnk)]] Shell link resolver.
* [[Foobar2000:Components 0.9/Timebomb (foo_timebomb)|Timebomb (foo_timebomb)]] Stop playback / exit program after a specified time.
* [[Foobar2000:Components/Unix archive support (foo_unpack_unix)|Unix archive support (foo_unpack_unix)]] Adds support for reading from Unix Tape Archives (.TAR), gzip files (.GZ), and bzip2 files (.BZ2).
* [[Foobar2000:Components 0.9/Unpacker for 7-Zip archive (foo_unpack_7z) |Unpacker for 7-Zip archive (foo_unpack_7z)]]
* [[Foobar2000:Components 0.9/Unpacker for JMA archive (foo_unpack_jma)|Unpacker for JMA archive (foo_unpack_jma)]]
* [[Foobar2000:Components 0.9/Unpacker for LHA archive (foo_unpack_lha)|Unpacker for LHA archive (foo_unpack_lha)]]
* [[Foobar2000:Components/UPnP/DLNA Renderer, Server, Control Point (foo_upnp)|UPnP/DLNA Renderer, Server, Control Point (foo_upnp)]]
* [[Foobar2000:Components 0.9/Winamp API Emulator (foo_winamp_spam)|Winamp API Emulator (foo_winamp_spam)]] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.

===Lyrics===
* [[Foobar2000:Components 0.9/Gasazip Lyrics (foo_gasazip)|Gasazip Lyrics (foo_gasazip)]] Search for lyrics and displays it in external window.
* [[Foobar2000:Components 0.9/Lyrics Show 2(foo_uie_lyrics2)|Lyrics Show 2(foo_uie_lyrics2)]] Downloads and displays lyrics, with LRC/timestamp support.
* [[Foobar2000:Components 0.9/LyricsDB (foo_lyricsdb)|LyricsDB (foo_lyricsdb)]] Search lyrics basing on song's artist title and sometimes album.
* [[Foobar2000:Components 0.9/foo_lyricsgrabber2|Lyrics Grabber 2 (foo_lyricsgrabber2)]] Downloads lyrics and stores them in tags.
* [[Foobar2000:Components 0.9/Mini Lyrics (foo_ui_minilyrics)|Mini Lyrics (foo_ui_minilyrics)]] Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.
* [[Foobar2000:Components 0.9/Sakura Script Lyrics (foo_sstp_lyrics)|Sakura Script Lyrics (foo_sstp_lyrics)]] Plays a SAKURA script lyrics to a SSP client.

===Notifier===
* [[Foobar2000:Components 0.9/AMIP Wrapper (foo_amipwrapper)|AMIP Wrapper (foo_amipwrapper)]] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [[Foobar2000:Components 0.9/Listening To (foo_listeningto)|Listening To (foo_listeningto)]] Sends NowPlaying information to Miranda IM.
* [[Foobar2000:Components 0.9/Miranda IM Notifier (foo_mim_notify)|Miranda IM Notifier (foo_mim_notify)]] Sends configurable information about the current playing song to Miranda-IM and shows popup windows with this info.
* [[Foobar2000:Components 0.9/MSN avatar changer (foo_uie_albumart_msn)|MSN avatar changer (foo_uie_albumart_msn)]] Set currently playing song's album art as avatar.
* [[Foobar2000:Components 0.9/MSN Now Playing (alt) (foo_msnalt)|MSN Now Playing (alt) (foo_msnalt)]] Show the current song as "Now Playing" in MSN and Windows Live messenger.
* [[Foobar2000:Components_0.9/WLM_Notifier_(foo_wlm)|Windows Live Notifier (foo_wlm)]] Shows current song as "Now Playing" in in MSN Messenger and Windows Live messenger (WLM). Supports unicode.
* [[Foobar2000:Components 0.9/On-Screen Display (foo_osd)|On-Screen Display (foo_osd)]] On screen display of track information and volume bar.
* [[Foobar2000:Components 0.9/On-Screen Display GDI (foo_osd_gdiplus)|On-Screen Display GDI (foo_osd_gdiplus)]] Same as foo_osd but uses GDI+ for osd drawing.
* [[Foobar2000:Components 0.9/Pretty Popup (foo_prettypop)|Pretty Popup (foo_prettypop)]] Display a moderately sized popup of song information when a new song plays.

===Online database===
* [[Foobar2000:Components 0.9/Audioscrobbler (foo_audioscrobbler)|Audioscrobbler (foo_audioscrobbler)]] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.

===Online radio===
* [[Foobar2000:Components/Podcatcher (foo_podcatcher)|Podcatcher (foo_podcatcher)]] A podcatcher component for subscribing to, downloading, and playing RSS and Atom podcast feeds in foobar2000.
* [[Foobar2000:Components/Vorbis Streamer (foo_vorbisstream)|Vorbis Streamer (foo_vorbisstream)]] Streams Vorbis and associated metadata to Icecast2 and Shoutcast servers.
* [[Foobar2000:Components 0.9/XM Radio Online Player (foo_xm)|XM Radio Online Player (foo_xm)]] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

===Playlist tools===
* [[Foobar2000:Components 0.9/Audioscrobble Charts (foo_scrobblecharts)|Audioscrobble Charts (foo_scrobblecharts)]] Generate a playlist from an artist's Last.fm chart. It also allows you to sort a selection in the playlist by the artist's charts.
* [[Foobar2000:Components 0.9/Bin Pack (foo_binpack)|Bin Pack (foo_binpack)]] Creates playlists from a list with a maximum length.
* [[Foobar2000:Components 0.9/Command Playlist (foo_cmd_playlist)|Command Playlist (foo_cmd_playlist)]] Add /playlist-activate:"Name" to the foobar command line to activate the named playlist.
* [[Foobar2000:Components 0.9/Cuesheet Creator (foo_cuesheet_creator)|Cuesheet Creator (foo_cuesheet_creator)]] Cuesheet creator.
* [[Foobar2000:Components 0.9/Database Search (foo_dbsearch)|Database Search (foo_dbsearch)]] Database search.
* [[Foobar2000:Components 0.9/Default Video Player (foo_default_videoplayer)|Default Video Player (foo_default_videoplayer)]] Allows you to play your video clips from foobar playlist with default external player.
* [[Foobar2000:Components 0.9/Delete Current (foo_deletecurrent)|Delete Current (foo_deletecurrent)]] Adds a menu item giving the possibility to delete from computer the current playing track.
* [[Foobar2000:Components 0.9/Highlight Playing (foo_highlightplaying)|Highlight Playing (foo_highlightplaying)]] Highlights actual now playing item even when the playlist has been broken.
* [[Foobar2000:Components 0.9/History (foo_history)|History (foo_history)]] Very basic song history.
* [[Foobar2000:Components 0.9/Inactive Tracks (foo_skip)|Inactive Tracks (foo_skip)]] Skips tracks that are marked via a tag as inactive.
* [[Foobar2000:Components 0.9/MeowDB (foo_meowdb)|MeowDB (foo_meowdb)]] Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [[Foobar2000:Components 0.9/Navigator (foo_navigator)|Navigator (foo_navigator)]] Advanced history component.
* [[Foobar2000:Components 0.9/Now Playing Simple (foo_np_simple)|Now Playing Simple (foo_np_simple)]] Simple now playing plugin to output formatted string to plain text file.
* [[Foobar2000:Components 0.9/Playback Queue Viewer (foo_pqview)|Playback Queue Viewer (foo_pqview)]] Playback queue viewer.
* [[Foobar2000:Components 0.9/Playlist Bind (foo_playlist_bind)|Playlist Bind (foo_playlist_bind)]] Synchronize playlist with contents of specific directory.
* [[Foobar2000:Components 0.9/Playlist Clear (foo_playlistclear)|Playlist Clear (foo_playlistclear)]] All playlists are cleared at startup.
* [[Foobar2000:Components 0.9/Playlist Manager (foo_playlist_manager)|Playlist Manager (foo_playlist_manager)]] Playlist manager.
* [[Foobar2000:Components 0.9/Playlist Name Enhenced (foo_playlist_name_enhanced)|Playlist Name Enhenced (foo_playlist_name_enhanced)]] Appends automatically playlist info ("items / length") to all playlist names.
* [[Foobar2000:Components 0.9/Playlist Tools (foo_utils)|Playlist Tools (foo_utils)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Playlist Tools for Matroska (foo_utils_mka)|Playlist Tools for Matroska (foo_utils_mka)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Queue Manager (foo_queuemanager)|Queue Manager (foo_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue. ''Non-ColumnUI obsolete version, try panel version instead.''
* [[Foobar2000:Components 0.9/Randomized Playlist Entry (foo_random)|Randomized Playlist Entry (foo_random)]] Randomized playlist entry.
* [[Foobar2000:Components 0.9/Rating (foo_rating)|Rating (foo_rating)]] Display an icon in the systray with a tooltip popup from which you can choose a rating between 1 and 5 for the currently playing file.
* [[Foobar2000:Components 0.9/Remove Played (foo_removeplayed)|Remove Played (foo_removeplayed)]] It removes tracks from the playlist once they've been played.
* [[Foobar2000:Components/Soft Playlists (foo_softplaylists)|Soft Playlists (foo_softplaylists)]] Can create different Last.fm related playlists, love tracks on Last.fm and save and load XSPF playlists (make playlists without hard paths).
* [[Foobar2000:Components 0.9/Track Finder (foo_trackfinder)|Track Finder (foo_trackfinder)]] Displays a context menu that lets you quickly find songs based on their album title or artists name.
* [[Foobar2000:Components 0.9/Track Position (foo_trackpos)|Track Position (foo_trackpos)]] Provides a new context menu item "place after current playing", that allows you to place any tracks after the current playing one in the playing playlist.
* [[Foobar2000:Components 0.9/XSPF (foo_xspf)|XSPF (foo_xspf)]] Adds XSPF support. XSPF is an open, XML based playlist format.

===Playback Statistics===
* [[Foobar2000:Components 0.9/Playback Statistics Custom (foo_playback_custom)|Playback Statistics Custom (foo_playback_custom)]] Stores playback statistics in tags like foo_playcount_mod, with claimed faster response, and uses foo_custominfo db if file is unavailable for writing.
* [[Foobar2000:Components 0.9/Play Count Mod (foo_playcount_mod)|Play Count Mod (foo_playcount_mod)]] Unofficial playcount modded to supress the update tag popups.

===Remote control===
* [[Foobar2000:Components 0.9/Advanced Controls (foo_advancedcontrols)|Advanced Controls (foo_advancedcontrols)]] Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [[Foobar2000:Components 0.9/Bluetooth Control (foo_bluetooth_ctrl)|Bluetooth Control (foo_bluetooth_ctrl)]] Control your favourite music player using your favourite Symbian-based bluetooth enabled phone.
* [[Foobar2000:Components 0.9/COM Automation Server (foo_comserver2)|COM Automation Server (foo_comserver2)]] Allows controlling foobar2000 through COM Automation
* [[Foobar2000:Components 0.9/Control Server (foo_controlserver)|Control Server (foo_controlserver)]] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [[Foobar2000:Components 0.9/DDE Control (foo_ddecontrol)|DDE Control (foo_ddecontrol)]] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [[Foobar2000:Components 0.9/HTTP Writer (foo_write_http)|HTTP Writer (foo_write_http)]] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [[Foobar2000:Components 0.9/Joystick Control (foo_joystick_control)|Joystick Control (foo_joystick_control)]] Control foobar2000 from a joystick/gamepad.
* [[Foobar2000:Components 0.9/Minibar2k (foo_Minibar2k)|Minibar2k (foo_Minibar2k)]] Control Foobar2k from your PDA (PocketPC based).
* [[Foobar2000:Components 0.9/Remote Control (foo_remotecontrol)|Remote Control (foo_remotecontrol)]] Adds support to Melloware Intelliremote software which claims to work with Creative remote control (Soundblaster Live!, Audigy, Extigy, Audigy ZS and Soundblaster X-Fi.)
* [[Foobar2000:Components 0.9/RM-1800 (foo_mr1800)|RM-1800 (foo_mr1800)]] Adds support of Creative X-Fi's remote (RM-1800).
* [[Foobar2000:Components 0.9/RM-X Media Edition (foo_rmx)|RM-X Media Edition (foo_rmx)]] Yet another plugin for remote control. SHAREWARE.
* [[Foobar2000:Components 0.9/Titlebar (foo_managedWrapper)|Titlebar (foo_managedWrapper)]] Create a personal title bar that shows the currently playing song on the top of the screen all the time. It supports custom-made skins.
* [[Foobar2000:Components 0.9/WinLIRC Client (foo_lirc)|WinLIRC Client (foo_lirc)]] Control Foobar from a remote control.

===Tagging===
* [[Foobar2000:Components 0.9/Chacon (foo_chacon)|Chacon (foo_chacon)]] Chacon is a simple tool for fixing tags by converting them between different character sets.
* [[Foobar2000:Components 0.9/Custom Info (foo_custominfo)|Custom Info (foo_custominfo)]] Allows you to set info fields for files without modifying them.
* [[Foobar2000:Components 0.9/Discogs (foo_discogs)|Discogs (foo_discogs)]] Retrieve info and album art from Discogs.com database.
* [[Foobar2000:Components 0.9/Freedb Tagger (foo_freedb2)|Freedb Tagger (foo_freedb2)]] Freedb.org tagger. Now included with official foobar2000 installers.
* [[Foobar2000:Components 0.9/Live Show Tagger (foo_tradersfriend)|Live Show Tagger (foo_tradersfriend)]] Live show tagger.

==Links==
* [http://www.foobar2000.org/components Official third-party components site]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 List of components] from earlier versions not yet ported to 0.9.x.

* [[foobar2000:foobar2000|Go back to Main Page]]

Foobar2000:Components/Playlist History (foo playlisthistory)

2011-01-10T20:24:39Z

Salski:

{{fb2k}}
[[Category:foobar2000 3rd-Party Components|Playlist History (foo playlisthistory)]]
[[Image:menu.png|thumb|right|292px|Playlist History]]
=General=
'''foo_playlisthistory''' enables playlist history in foobar2000, similar to browser history. Two commands are provided under the ''View/Recently activated playlists'': ''Previous playlist'' and ''Next playlist''. These two commands can bound to keyboard shortcuts using ''Keyboard Settings'' in ''Preferences'' (see [[#Getting started|Getting started]] section for details).

The component enables easy and fast switching between recently activated playlists.

===Download link===
The component is available from [notYet here]. Install the .zip package in "Preferences > Components" (the preferable method), or manually by unziping '''foo_playlisthistory.dll''' to foobar2000 components directory.

Source code for the component is available at [https://github.com/ssalonen/foo_playlisthistory]. The component is distributed under very permissive BSD license.

===Discussion===
Please use [insert link this thread] to provide feedback, or to report any bugs you might have found.

===Requirements===
foobar2000 1.x. The component will not work with previous versions of foobar.

===Getting started===
The component is usable immediately, no configuration is necessary.

However, '''I recommend binding ''Previous playlist'' and ''Next playlist'' to keyboard shortcuts'''. This can be done as follows:
* Open foobar preferences using Ctrl+P
* Click ''Keyboard shortcuts'' (on the left)
* Press ''Add new'' Button (on the right)
* Type ''recently'' to ''Filter list by'' text box to filter commands
* Choose ''Previous playlist'' under ''View/Recently activated playlists''
* Click ''Key'' textbox and press Alt+Left using keyboard
* Click Apply

Now ''Previous playlist'' functionality is mapped to Alt+Left key combination (similar to most browsers and Windows Explorer).

The same procedure can be repeated for ''Next playlist''<->Alt+Right binding.

=Configuration=
No configuration is necessary.

=Change Log=
* '''0.1 / 2010-01-10'''
** Initial release