Layout

Layout controls the base layout of the application. This layout is similar to tabs configuration except it contains a single Pane or Split. It is configured inside your theme.ron.

layout: Pane | Split

The layout can use any non-focusable Pane (these currently are AlbumArt, Lyrics, ProgressBar, Header and Tabs) and additionally must contain exactly one special TabContent pane which will display content of the currently active tab configured in tabs. The pane sizes can be either a percent value ie. "100%" or size in terminal cells (rows or columns, depending on the split direction) ie. "5".

Caution

Panes displayed in the base layout cannot be in used in the tabs. For example you cannot display album art in the base layout and in the queue tab simultaneously.

Examples

Below are some examples you can use as pointers how to configure the layout.

Album Art in the header

Very similar to the default layout except progress bar is moved to the top and album art is moved to the left of the header.

Click to show theme.ron

layout: Split(
    direction: Vertical,
    panes: [
        (
            size: "8",
            pane: Split(
                direction: Horizontal,
                panes: [
                    (
                        size: "21",
                        pane: Pane(AlbumArt),
                    ),
                    (
                        size: "100%",
                        pane: Split(
                            direction: Vertical,
                            panes: [
                                (
                                    size: "5",
                                    pane: Pane(Header),
                                ),
                                (
                                    size: "1",
                                    pane: Pane(ProgressBar),
                                ),
                                (
                                    size: "3",
                                    pane: Pane(Tabs),
                                ),
                            ]
                        )
                    ),
                ]
            ),
        ),
        (
            size: "100%",
            pane: Pane(TabContent),
        ),
    ],
),

Default layout

This is the default layout you get when starting rmpc without any configuration.

Click to show theme.ron

layout: Split(
    direction: Vertical,
    panes: [
        (
            pane: Pane(Header),
            size: "2",
        ),
        (
            pane: Pane(Tabs),
            size: "3",
        ),
        (
            pane: Pane(TabContent),
            size: "100%",
        ),
        (
            pane: Pane(ProgressBar),
            size: "1",
        ),
    ],
),

Default layout with borders

This is the default layout, but with borders around all layout panes except the tabs.

Click to show theme.ron

layout: Split(
    direction: Vertical,
    panes: [
        (
            size: "4",
            borders: "ALL",
            pane: Pane(Header),
        ),
        (
            size: "3",
            pane: Pane(Tabs),
        ),
        (
            size: "100%",
            borders: "ALL",
            pane: Pane(TabContent),
        ),
        (
            size: "3",
            borders: "ALL",
            pane: Pane(ProgressBar),
        ),
    ],
),

No layout, just the tab’s content

It is also possible to not use the base layout at all and simply display just the content of the currently active tab.

layout: Pane(TabContent),