Skip to main content
Category: Controls · Sends commands: playback controls · Reads data: track info

Mental model

A Spotify Player is a media remote. It shows what’s playing and sends playback commands (play / pause / next / previous) — each control mapped to a command your device or integration handles.

When to use it

  • Media playback control on a dashboard
  • Any transport-style control surface

Settings

General

  • Widget Title / ID
  • Play / Pause / Next / Previous command IDs — the command each control sends
  • Album / Artist / Album art URL — track display
  • Show album artwork · show playback controls

Behavior

  • Default volume · repeat mode · autoplay on load
  • API credentials — for the Spotify integration

Style

Background, accent color, border radius, container. Each transport button fires the command ID you set — handle those like any other command in firmware or your integration.

Script API example

The same interactions from a dashboard script:
// Compact player on small screens
if (context.device.isMobile) widget.resize('player', 300, 120);

Triggers

How command IDs reach a device.