The Timbre Player, available to Broadcasting and Podcasting users, has various options for customisation. Here you will find the available parameters to add to the Timbre Player's embed code.


Parameter

Default

Description

custom_themenullUsed when copying an embed code from Timbre for a feed/item with a custom theme selected. 

layout

legacy

The layout to be rendered.

legacy – Render the default rectangular layout (Slim Player).

square – Render the square layout.

sharing

1

Whether or not to show the sharing section component.

0 – Disables sharing.

1 – Enables sharing.

artwork

1

Whether or not to show cover art. Only available on streams, required valid "Now Playing" metadata.

0 – Disables cover art.

1 – Enables cover art.

waveforms

1

Whether or not to render use a simple scroll area or audio waveforms.

0 – Disables cover art.

1 – Enables cover art.

accent

ed3b96

Theme accent color as a hexadecimal code. Example: ed3d96

background

ffffff

Theme background color as a hexadecimal code.

border

dddddd

Theme border color as a hexadecimal code.

text

444444

Theme text color as a hexadecimal code.

rounded

0

Theme rounded corners, must be a value between 0 and 20.

limit

20

Limit amount of episodes loaded in player. 

A large value may slow down player load time. 

Note: This parameter is only valid for the Feed Embed.

skip

0

Skip selected amount of episodes on player load.

Note: This parameter is only valid for the Feed Embed.


With a custom theme already set, you can make use of parameters such as accent, border, rounded, etc. to further customise your player without changing the custom theme.


How to use URL parameters

To customise the player, append URL parameters to the end of the embed URL. Start by adding a "?" after the feed UID (seen in the basic structure below) to indicate that a URL parameter will be used. Use an "=" to assign a value to each parameter in the format parameter=value. If you have multiple parameters, separate them with an "&".


The basic structure of the embed URL is:

https://timbre-player.sharp-stream.com/embed/feed/[feed UID]?[parameter=value]&[parameter=value]


Example: https://timbre-player.sharp-stream.com/embed/feed/3fdddd6f-e5da-4bbc-8fa0-aa32ac5a1b02?layout=legacy&custom_theme=173&accent=ed3b96


Please note, embed URLs retrieved from Timbre will have the following default values:

layout=legacy(slim)/square (based on selection made in Timbre)
custom_theme=value by default

The custom_theme parameter will not override URL parameters added before custom_theme.