> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Spotify Player

> A media player widget with command bindings for playback control.

<Info>
  **Category:** Controls · **Sends commands:** playback controls · **Reads data:** track info
</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.

## Related

Each transport button fires the command ID you set — handle those like any other
[command](/studio/api-commands) in firmware or your integration.

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
// Compact player on small screens
if (context.device.isMobile) widget.resize('player', 300, 120);
```

<Card title="Triggers" icon="bolt" href="/dashboard/triggers">
  How command IDs reach a device.
</Card>