# Spotify Player

The **Spotify Player** widget for UniDeck allows you to seamlessly integrate your Spotify music and playback controls directly into your dashboard. Manage your currently playing songs, control your music, and see what's coming up next in your playlist without ever leaving your workspace.

{% hint style="warning" %}
The Spotify Player widget is currently in **Beta**. We're continuously working on improving it, and we welcome your feedback!
{% endhint %}

### Getting Started

To get started with the Spotify Player widget, you first need to add it to your dashboard and connect your Spotify account.

1. Click on the **"Add more widgets"** button at the top of your dashboard.
2. In the widget gallery, select **"Spotify"** from the categories or search for it.
3. Find the **Spotify Player** widget and click the **"+ Add"** button.

Once added to your dashboard, you will be prompted to connect your Spotify account. Right-click on the widget and select **"Spotify Account"** to authenticate and link your account.

### Features

* **Now Playing View:** See the album art, song title, and artist for the music you're currently listening to.
* **Playback Controls:** Play, pause, skip to the next track, or go back to the previous track directly from the widget.
* **Up Next Queue:** The larger widget sizes display a list of the upcoming songs in your current playlist or queue.
* **Volume Control:** Adjust the playback volume from within the widget.
* **Progress Bar:** A visual indicator shows the current progress of the song.

### Widget Sizes

The Spotify Player widget is available in a variety of sizes to fit your dashboard layout. You can choose the size that best suits your needs, from a compact player to a more detailed view with an "Up Next" list.

<table data-card-size="large" data-view="cards" data-full-width="true"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td align="center">1x1</td><td><a href="/files/EpwcdB3JQWYpdvT6ei0d">/files/EpwcdB3JQWYpdvT6ei0d</a></td></tr><tr><td align="center">2x1</td><td><a href="/files/UMIgiTYXrbCYSYTRXlob">/files/UMIgiTYXrbCYSYTRXlob</a></td></tr><tr><td align="center">2x2</td><td><a href="/files/WV43hLJLoIKjM3SZ8bx0">/files/WV43hLJLoIKjM3SZ8bx0</a></td></tr><tr><td align="center">3x1</td><td><a href="/files/MsqbgZZemFafhRKZi5El">/files/MsqbgZZemFafhRKZi5El</a></td></tr><tr><td align="center">3x2</td><td><a href="/files/zxODoFwQUJACQy6wzIXI">/files/zxODoFwQUJACQy6wzIXI</a></td></tr><tr><td align="center">3x3</td><td><a href="/files/C87hwzInN79LFZfJlTCh">/files/C87hwzInN79LFZfJlTCh</a></td></tr><tr><td align="center">4x1</td><td><a href="/files/whO5RphIeRNXpomYfHx0">/files/whO5RphIeRNXpomYfHx0</a></td></tr><tr><td align="center">4x4</td><td><a href="/files/b9OHagsumZsdT83b8Zo4">/files/b9OHagsumZsdT83b8Zo4</a></td></tr></tbody></table>

You can change the size at any time by right-clicking on the widget and selecting a new option from the **"Size"** menu.

### Configuration Options

To configure the Spotify Player widget, simply right-click on it to open the context menu.

* **Spotify Account:** Connect or manage your linked Spotify account. You must be connected to a Spotify account for the widget to function.
* **Size:** Adjust the widget's size to fit your dashboard layout.
* **Learn More:** Links to this documentation page.
* **Delete:** Removes the widget from your dashboard.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ainur.gitbook.io/unideck-docs/reference-and-spec/widgets/spotify-player.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
