Api_WidgetCustomization

object

primaryColorstring | null

Primary accent color (hex without #).

Example

2196F3

backgroundColorstring | null

Background color (hex without #).

Example

ffffff

textColorstring | null

Text color (hex without #).

Example

showAlbumArtboolean

Whether album art should be shown.

Example

true

roundedCornersboolean

Whether the widget should use rounded corners.

Example

false

autoplayboolean

Whether autoplay should be requested.

Example

false

showVolumeControlsboolean

Whether the volume controls are visible.

Example

true

showTrackProgressboolean

Whether track progress is visible.

Example

true

showStreamSelectionboolean

Whether stream selection controls are visible.

Example

true

showHistoryButtonboolean

Whether the history button is visible.

Example

false

showRequestButtonboolean

Whether the request button is visible.

Example

false

showPlaylistButtonboolean

Whether the playlist download button is visible.

Example

false

initialVolumeinteger[0, 100]

Initial player volume (0-100).

Example

layoutstring

Layout variant for the widget.

Example

horizontal

enablePopupPlayerboolean

Whether to show an “open popup” button.

Example

false

continuousPlayboolean

Whether to persist playback state across pages.

Example

false

customCssstring | null

Additional CSS applied to the widget.

Example

.radio-player-widget { border-radius: 12px; }

Example

{
  "primaryColor": "2196F3",
  "backgroundColor": "ffffff",
  "textColor": "000000",
  "showAlbumArt": true,
  "roundedCorners": false,
  "autoplay": false,
  "showVolumeControls": true,
  "showTrackProgress": true,
  "showStreamSelection": true,
  "showHistoryButton": false,
  "showRequestButton": false,
  "showPlaylistButton": false,
  "initialVolume": 75,
  "layout": "horizontal",
  "enablePopupPlayer": false,
  "continuousPlay": false,
  "customCss": ".radio-player-widget { border-radius: 12px; }"
}

Docs by Sourcey