Foobar2000:Mac:Layout

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.

Each layout line is formatted as:

element-name [argument=value ...]

Specific example:

console mode=lite

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:

tabs
 elem1
 elem2
 elem3

tabs
tabs position=top
tabs position=bottom
tabs position=left
tabs position=right

Declares a tabs container.

You can set names of individual tabs by adding tab-name argument to each tab element:

tabs
 albumlist tab-name="Album List"
 albumart tab-name="Album Art"
 selection-properties tab-name="Properties"

splitter
splitter vertical
splitter style=thin
splitter style=thick
splitter style=pane

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:

splitter
 albumlist
 playlist

albumlist

No arguments.

refacets

No arguments.

selection-properties
selection-properties sections=metadata,location,general,replaygain,other

Use sections argument to specific which sections you want shown, defaults to all. Order of them can't be changed.

albumart

No arguments.

playlist

No arguments.

playback-controls

No arguments.

playlist-picker

Arguments (new in build 2024-10-04):

style, either "plain" or "sourcelist" (default, similar to past foobar2000 versions).

playlist-manager

New in build 2024-10-11. No arguments.

audiounit mode=control name=AUGraphicEQ vendor=Apple

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.

console
console mode=lite

foobar2000 console view. Use mode=lite to omit clear etc buttons.