Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:LargeFieldsConfig-v2

2025-12-28T23:08:05Z

DEATH: /* History */ removed reference to unreleased build

== Overview ==
LargeFieldsConfig feature allows you to fine-tune how foobar2000 caches information about your media. You can keep long meta values (ripping logs, lyrics) from being loaded into app memory, significantly reducing memory usage of foobar2000 if your large music library uses such tags, but hiding these fields from features such as search. Properties dialog will re-read complete tags before showing tags of affected files.

The feature is not accessible from foobar2000 itself - instead, a text file in foobar2000 profile contains relevant settings and can be edited manually; new settings will take effect on next startup. Also, any change will trigger automatic reload of tags for all your playlists and library on next foobar2000 startup.

A text file with default settings and an overview of this feature is created on first run of foobar2000 versions that support this, if it does not yet exist.

== History ==
Original LargeFieldsConfig was introduced in foobar2000 v1.3 and worked until 1.6 series, dropped in 2.0.

LargeFieldsConfig-v2 was introduced in v2.26 preview 2025-12-28, mostly reusing existing technology from foobar2000 v1.x series, but with a new file format; also defaulting to blank config - no large fields dropped by default.

== Syntax ==
LargeFieldsConfig-v2.txt consists of zero or more sections, each beginning with a limit= line, followed by one or more meta= or info= lines.

Lines beginning with # are treated as comments and ignored.

The limit line defines how many UTF-8 bytes per value are allowed for elements listed in the section. Length is unlimited if the value is missing ("limit=") or is not a number.

A meta line declares meta field name, such as artist, that above limit applies to; meta=* matches all fields not matched in sections prior to this one.

An info line declares tech info field name, such as bitrate, that above limit applies to; info=* matches all info fields not matched in sections prior to this one.

Sections are evaluated in order they appear in the file. For an example, if you use meta=* in the final section, it will apply to all fields not matched in other sections; but if you do so in the first section, meta= lines in following sections will have no effect.

== Example ==
Below is a rough conversion of foobar2000 v1.x defaults to the new format:
<pre>
# See: https://www.foobar2000.org/LargeFieldsConfig-v2

# Essential meta fields
limit=2000
meta=album
meta=album artist
meta=artist
meta=composer
meta=conductor
meta=date
meta=discnumber
meta=genre
meta=keywords
meta=performer
meta=producer
meta=style
meta=title
meta=totaldiscs
meta=totaltracks
meta=tracknumber

# Meta fields we never want
limit=0
meta=accurate rip
meta=aucdtect
meta=biography
meta=cuesheet
meta=eac logfile
meta=itunes_cddb_1
meta=itunmovi
meta=log
meta=logfile
meta=lyrics
meta=unsynced lyrics

# All info fields
limit=200
info=*

# All meta fields not listed in previous entries
limit=1000
meta=*</pre>

Foobar2000:LargeFieldsConfig-v2

2025-12-27T17:44:39Z

DEATH: /* Syntax */

== Overview ==
LargeFieldsConfig feature allows you to fine-tune how foobar2000 caches information about your media. You can keep long meta values (ripping logs, lyrics) from being loaded into app memory, significantly reducing memory usage of foobar2000 if your large music library uses such tags, but hiding these fields from features such as search. Properties dialog will re-read complete tags before showing tags of affected files.

The feature is not accessible from foobar2000 itself - instead, a text file in foobar2000 profile contains relevant settings and can be edited manually; new settings will take effect on next startup. Also, any change will trigger automatic reload of tags for all your playlists and library on next foobar2000 startup.

A text file with default settings and an overview of this feature is created on first run of foobar2000 versions that support this, if it does not yet exist.

== History ==
Original LargeFieldsConfig was introduced in foobar2000 v1.3 and worked until 1.6 series, dropped in 2.0.

LargeFieldsConfig-v2 was introduced in v2.26 preview 2025-12-27, mostly reusing existing technology from foobar2000 v1.x series, but with a new file format; also defaulting to blank config - no large fields dropped by default.

== Syntax ==
LargeFieldsConfig-v2.txt consists of zero or more sections, each beginning with a limit= line, followed by one or more meta= or info= lines.

Lines beginning with # are treated as comments and ignored.

The limit line defines how many UTF-8 bytes per value are allowed for elements listed in the section. Length is unlimited if the value is missing ("limit=") or is not a number.

A meta line declares meta field name, such as artist, that above limit applies to; meta=* matches all fields not matched in sections prior to this one.

An info line declares tech info field name, such as bitrate, that above limit applies to; info=* matches all info fields not matched in sections prior to this one.

Sections are evaluated in order they appear in the file. For an example, if you use meta=* in the final section, it will apply to all fields not matched in other sections; but if you do so in the first section, meta= lines in following sections will have no effect.

== Example ==
Below is a rough conversion of foobar2000 v1.x defaults to the new format:
<pre>
# See: https://www.foobar2000.org/LargeFieldsConfig-v2

# Essential meta fields
limit=2000
meta=album
meta=album artist
meta=artist
meta=composer
meta=conductor
meta=date
meta=discnumber
meta=genre
meta=keywords
meta=performer
meta=producer
meta=style
meta=title
meta=totaldiscs
meta=totaltracks
meta=tracknumber

# Meta fields we never want
limit=0
meta=accurate rip
meta=aucdtect
meta=biography
meta=cuesheet
meta=eac logfile
meta=itunes_cddb_1
meta=itunmovi
meta=log
meta=logfile
meta=lyrics
meta=unsynced lyrics

# All info fields
limit=200
info=*

# All meta fields not listed in previous entries
limit=1000
meta=*</pre>

Foobar2000:LargeFieldsConfig-v2

2025-12-27T17:41:55Z

DEATH: /* Overview */

== Overview ==
LargeFieldsConfig feature allows you to fine-tune how foobar2000 caches information about your media. You can keep long meta values (ripping logs, lyrics) from being loaded into app memory, significantly reducing memory usage of foobar2000 if your large music library uses such tags, but hiding these fields from features such as search. Properties dialog will re-read complete tags before showing tags of affected files.

The feature is not accessible from foobar2000 itself - instead, a text file in foobar2000 profile contains relevant settings and can be edited manually; new settings will take effect on next startup. Also, any change will trigger automatic reload of tags for all your playlists and library on next foobar2000 startup.

A text file with default settings and an overview of this feature is created on first run of foobar2000 versions that support this, if it does not yet exist.

== History ==
Original LargeFieldsConfig was introduced in foobar2000 v1.3 and worked until 1.6 series, dropped in 2.0.

LargeFieldsConfig-v2 was introduced in v2.26 preview 2025-12-27, mostly reusing existing technology from foobar2000 v1.x series, but with a new file format; also defaulting to blank config - no large fields dropped by default.

== Syntax ==
LargeFieldsConfig-v2.txt consists of zero or more sections, each beginning with a limit= line, followed by one or more meta= or info= lines.

Lines beginning with # are treated as comments and ignored.

A limit line declares limit of many UTF-8 bytes per value for elements in this section, no limit if blank ("limit=") or not a number.

A meta line declares meta field name, such as artist, that above limit applies to; meta=* matches all fields not matched in sections prior to this one.

An info line declares tech info field name, such as bitrate, that above limit applies to; info=* matches all info fields not matched in sections prior to this one.

Sections are evaluated in order they appear in the file. For an example, if you use meta=* in the final section, which will apply to all fields not matched in other sections; but if you do so in the first section, meta= lines in following sections will have no effect.

== Example ==
Below is a rough conversion of foobar2000 v1.x defaults to the new format:
<pre>
# See: https://www.foobar2000.org/LargeFieldsConfig-v2

# Essential meta fields
limit=2000
meta=album
meta=album artist
meta=artist
meta=composer
meta=conductor
meta=date
meta=discnumber
meta=genre
meta=keywords
meta=performer
meta=producer
meta=style
meta=title
meta=totaldiscs
meta=totaltracks
meta=tracknumber

# Meta fields we never want
limit=0
meta=accurate rip
meta=aucdtect
meta=biography
meta=cuesheet
meta=eac logfile
meta=itunes_cddb_1
meta=itunmovi
meta=log
meta=logfile
meta=lyrics
meta=unsynced lyrics

# All info fields
limit=200
info=*

# All meta fields not listed in previous entries
limit=1000
meta=*</pre>

Foobar2000:Mac:Layout

2025-12-27T12:58:05Z

DEATH: 2.25 visualizations

== Introduction ==
2024 preview versions of foobar2000 for Mac, versioned as v2.7 series, introduced the ability to customize UI layout.

There's no live layout editing similar to Windows foobar2000; instead you edit layout description as plain text.

== Syntax ==
Each layout line is formatted as:

<pre>element-name [argument=value ...]</pre>

Specific example:
<pre>console mode=lite</pre>
Declares "console" element with argument "mode" set to "lite", which produces slim version of the console view, without utility buttons.

Some elements such as splitters and tabs can contain other elements.

To embed an element in other element, add indentation (space characters) before the declaration of an embedded element:
<pre>tabs
elem1
elem2
elem3</pre>
== Common arguments ==
These arguments are accepted by various elements, where applicable.
=== font-size ===
Specifies size of the font to be used in this element.

Added in build 2024-10-18
<pre>playlist font-size=20</pre>
=== font-name ===
Specifies name of the font to be used in this element.

Added in build 2024-10-18
<pre>playlist font-name=Courier</pre>

Since build 2024-11-07, these can be applied to higher-level containers, causing all contained elements to inherit them.

=== font-mono ===
Use system default monospace font. Can be used instead of font-name. No arguments.

Added in version 2.25.

<pre>console font-mono</pre>

== Elements ==
=== Containers ===
==== Tabs ====
<pre>tabs
tabs position=top
tabs position=bottom
tabs position=left
tabs position=right</pre>
Declares a tabs container.

You can set names of individual tabs by adding tab-name argument to each tab element:
<pre>tabs
albumlist tab-name="Album List"
albumart tab-name="Album Art"
selection-properties tab-name="Properties"</pre>
==== Splitter ====
<pre>splitter
splitter vertical
splitter style=thin
splitter style=thick
splitter style=pane</pre>
Splitter can hold any number of panes. Use optional style argument to control splitter visual style.

Add "vertical" argument, with no value, to create vertical instead of default horizontal.

Example:
<pre>splitter
albumlist
playlist</pre>

===== Splitter item properties =====
New feature added in build 2024-10-14.
<pre>NSSplitViewItem.canCollapse</pre>
Causes item to be collapsible, when out of space. Value is ignored - adding this argument causes the item to become collapsible. See also: [https://developer.apple.com/documentation/appkit/nssplitviewitem/1388926-cancollapse Apple developer documentation].
<pre>NSSplitViewItem.behavior</pre>
Controls split view item behavior. For details and available values, see [https://developer.apple.com/documentation/appkit/nssplitviewitem/1388899-behavior Apple developer documentation].
<pre>NSSplitViewItem.collapseBehavior</pre>
Controls split view item collapse behavior. For details and available values, see [https://developer.apple.com/documentation/appkit/nssplitviewitem/collapsebehavior Apple developer documentation].
<pre>NSSplitViewItem.holdingPriority</pre>
Controls priority for a split view item to hold its size. Allowed range: 0...1000. For details, see [https://developer.apple.com/documentation/appkit/nssplitviewitem/1388887-holdingpriority Apple developer documentation].

Example:
<pre>splitter
albumlist NSSplitViewItem.canCollapse NSSplitViewItem.behavior=NSSplitViewItemBehaviorSidebar
playlist NSSplitViewItem.behavior=NSSplitViewItemBehaviorDefault</pre>

=== Media Library ===
==== Album List ====
<pre>albumlist</pre>
No arguments.
==== ReFacets ====
<pre>refacets</pre>
No arguments.
=== Selected track info ===
==== Selection Properties ====
<pre>selection-properties
selection-properties sections=metadata,location,general,replaygain,other</pre>
Use sections argument to specific which sections you want shown, defaults to all. Order of them can't be changed.
==== Album Art ====
<pre>albumart</pre>
No arguments.
=== Playlist & playback ===
==== Playlist ====
<pre>playlist</pre>
No arguments.
==== Playback controls bar ====
<pre>playback-controls</pre>

Arguments (new in build 2024-11-07):
* format-title - overrides formatting of title, default: %title%
* format-artist - overrides formatting of artist, default: $if2(%artist%,unknown artist)
* format-info - overrides formatting of tech info, default: %codec_long%[ %bitrate%kbps][ %samplerate%Hz][ %channels%]
==== Playlist picker sidebar ====
<pre>playlist-picker</pre>

Arguments (new in build 2024-10-04):
* style, either "plain" or "sourcelist" (default, similar to past foobar2000 versions).
==== Playlist manager ====
<pre>playlist-manager</pre>
New in build 2024-10-11.
No arguments.

==== Audio Unit ====
<pre>audiounit mode=control name=AUGraphicEQ vendor=Apple</pre>
Embeds an Audio Unit in your layout.

Arguments:
* mode, either "control" (the default) or "visualization". "control" mode can't accurately show singal being played but applies changes in Audio Unit settings to current playback chain; "visualization" doesn't alter played audio but synchronizes singal fed to the audio unit with live audio, resulting in smoother appearance of Audio Units that visualize played audio.
* name, name of the Audio Unit
* vendor, OPTIONAL, name of the Audio Unit vendor, in case two different unrelated Audio Units exist with the same name.
=== Visualizations ===
Since foobar2000 v2.25, multiple built-in visualizations are accessible through the layout system.
==== Oscilloscope ====
<pre>vis-oscilloscope</pre>
Arguments:
* mono, show curve of mono-downmixed audio.
* window-ms, oscilloscope window duration in milliseconds.
* zoom-percent, zoom in to specific percent instead of showing full PCM range.
==== VU Meter ====
<pre>vis-vumeter</pre>
Arguments:
* vertical, make bars vertical regardless of element width/height
* horizontal, make bars horizontal regardless of element width/height.
==== Peak Meter ====
<pre>vis-peakmeter</pre>
Arguments:
* vertical, make bars vertical regardless of element width/height
* horizontal, make bars horizontal regardless of element width/height.
==== Spectrum ====
<pre>vis-spectrum bands=100</pre>
Arguments:
* bands, number of spectrum bands to show.
* vertical, make bars vertical regardless of element width/height
* horizontal, make bars horizontal regardless of element width/height.

=== Other ===
==== Console ====
<pre>console
console mode=lite</pre>
foobar2000 console view. Use mode=lite to omit clear etc buttons.

Accepts font parameters since version 2.24.5.
==== Internet Radio station list ====
<pre>radio-list
radio-list mode=lite</pre>
Same as relevant tab of Internet Radio window. Use mode=lite to omit everything but the table.

Added in build 2024-10-21.
==== Internet Radio search ====
<pre>radio-search</pre>
Same as relevant tab of Internet Radio window.

Added in build 2024-10-21.

Foobar2000:LargeFieldsConfig-v2

2025-12-27T12:24:40Z

DEATH: HA HA! I'm creating WIKI PAGES

== Overview ==
LargeFieldsConfig feature allows you to fine-tune how foobar2000 caches information about your media; you can keep long meta values (ripping logs, lyrics) from being loaded into app memory, significantly reducing memory usage of foobar2000 if your large music library uses such tags, but hiding these fields from features such as search; also requiring Properties dialog to re-read complete tags in order before showing tags of affected files.

The feature is not accessible from foobar2000 itself - instead, a text file in foobar2000 profile contains relevant settings and can be edited manually; new settings will take effect on next startup. Also, any change will trigger automatic reload of tags for all your playlists and library on next foobar2000 startup.

A text file with default settings and an overview of this feature is created on first run of foobar2000 versions that support this, if it does not yet exist.

== History ==
Original LargeFieldsConfig was introduced in foobar2000 v1.3 and worked until 1.6 series, dropped in 2.0.

LargeFieldsConfig-v2 was introduced in v2.26 preview 2025-12-27, mostly reusing existing technology from foobar2000 v1.x series, but with a new file format; also defaulting to blank config - no large fields dropped by default.

== Syntax ==
LargeFieldsConfig-v2.txt consists of zero or more sections, each beginning with a limit= line, followed by one or more meta= or info= lines.

Lines beginning with # are treated as comments and ignored.

A limit line declares limit of many UTF-8 bytes per value for elements in this section, no limit if blank ("limit=") or not a number.

A meta line declares meta field name, such as artist, that above limit applies to; meta=* matches all fields not matched in sections prior to this one.

An info line declares tech info field name, such as bitrate, that above limit applies to; info=* matches all info fields not matched in sections prior to this one.

Sections are evaluated in order they appear in the file. For an example, if you use meta=* in the final section, which will apply to all fields not matched in other sections; but if you do so in the first section, meta= lines in following sections will have no effect.

== Example ==
Below is a rough conversion of foobar2000 v1.x defaults to the new format:
<pre>
# See: https://www.foobar2000.org/LargeFieldsConfig-v2

# Essential meta fields
limit=2000
meta=album
meta=album artist
meta=artist
meta=composer
meta=conductor
meta=date
meta=discnumber
meta=genre
meta=keywords
meta=performer
meta=producer
meta=style
meta=title
meta=totaldiscs
meta=totaltracks
meta=tracknumber

# Meta fields we never want
limit=0
meta=accurate rip
meta=aucdtect
meta=biography
meta=cuesheet
meta=eac logfile
meta=itunes_cddb_1
meta=itunmovi
meta=log
meta=logfile
meta=lyrics
meta=unsynced lyrics

# All info fields
limit=200
info=*

# All meta fields not listed in previous entries
limit=1000
meta=*</pre>

MediaWiki:Sidebar

2025-10-09T13:18:53Z

DEATH:

2024-10-15T17:02:32Z

DEATH: /* Splitter */

2024-02-21T14:56:56Z

DEATH:

(newest first)

=== 2024-02-21 ===
* CPU usage reduced.
* ReplayGain scanner preferences typo fix.
* Fixed more window position saving bugs.
* Various cosmetic fixes.

=== 2024-02-19 ===
* Fixed preferences / output devices bugs.
* Fixed playlist rename then reorder bug.
* Fixed main window size not being remembered again.
* Fixed regression preventing internet radio album covers from being shown.

=== 2024-02-12 ===
* Improved ReFacets performance.
* Fixed erratic behavior if ID3v2 tag contains multiple date fields.
* Suppressed advancing to the next playlist item if internet radio playback stops due to a network error.
* File Operations: Added an option to overwrite existing files.
* Suppressed repeating console messages about decoder shims used.
* More thorough error reporting for blank WAV files.
* Added stream_count info for formats that support multiple streams.

=== 2024-02-05 ===
* Implemented meta autocomplete in Properties dialog.
* Implemented Ogg chapter support.
* New major revision of bitcompare code, improved performance.
* Allow local M3U referencing remote M3U to be both read as playlists, prevent HLS reader being used on non-HLS content.
* Updated File Operations recycle bin detection logic.
* Stop decoding ADTS AAC when running into APE tags, instead of reporting errors.
* Report zero-length WAV files as broken.
* Reduced memory usage.