Song table format

song_table_format: <song_table_column[]>

An array of objects which serve as a template for table of songs that are currently in the queue. Each object represents a column in the table.

song_table_column

Describes a single column in the song table. Allows you to specify the label, alignment, width and a property to display in the column.

prop

prop: <property>

Property of the song to display in the column. Described in its own page. Only Song properties are allowed for the Property and thus the property type is omitted here. Check the example or the default theme for more info.

width

width: "<string>"

Portion of the table width reserved for this column. Can be one of:

• Exact value: "5" which will result in 5 column width
• Percentage: "50%" which will result in half the table width

alignment

alignment: Left | Right | Center

Percentage of the table reserved for this column. Sum of these value must be 100.

label_prop and label

label_prop: <property>

label: "<string>"

Optional label for the column. Displayed in the QueueHeader() pane. Only the Text and Group property kinds are allowed here. label is a simple shorthand for (kind: Text("<value>")). Defaults to the name of the property if not provided.

Example

This configuration displays a table with a single column.

This column displays Artist of the song followed by a dash and Title of the song. If either the artist or title is missing in song’s metadata its Filename is shown instead.

song_table_format: [
    (
        prop: (
            kind: Group([
                (kind: Property(Artist)),
                (kind: Text(" - ")),
                (kind: Property(Title)),
            ]),
            default: (kind: Property(Filename))
        ),
        width: "100%",
    ),
]