Spotify Soloist

Run Spotify playback on your own Linux hardware.

Spotify Soloist enables Linux-based systems to play Spotify content as dedicated playback devices, with support for local audio output, command-line control, and integrations through a WebSocket API.

Spotify Soloist is a headless Spotify client for Linux-based systems, aimed at devices like the Raspberry Pi. It supports the full Spotify audio experience that you know and love while audio plays on your device.

• Use a Linux-based device, like a Raspberry Pi, as a network speaker.
• Connect Spotify Soloist to a local amplifier, DAC, or Bluetooth speaker.
• Connect a local display, button panel, or automation using the optional WebSocket API.
• Use single-track mode for scripts that play one Spotify URI and then exit.

Spotify Soloist runs as a command-line application on your device. Your app or script can control it through the optional WebSocket API or soloist ctl.

Spotify Soloist requires an API key at startup.

• Do not share your Spotify Soloist API key. Each user must generate their own key from Spotify for Developers.
• Do not redistribute Spotify Soloist archives or binaries directly. Link users to the official Downloads and updates page instead.

To use Spotify Soloist for the first time:

1. Log in to the Spotify for Developers dashboard.
2. Open Spotify Soloist API Key and generate an API key.
3. Download the Spotify Soloist archive for your device architecture.
4. Extract the soloist executable and run it with your device name and API key.
5. Open the Spotify app on the same local network and select your Spotify Soloist device.

Follow the Getting started tutorial for the full walkthrough.

Spotify Soloist builds expire after 90 days. After that, download and install a newer build. Read more about build lifetime and updates in Downloads and updates.

• Overview explains how Spotify Soloist runs and which integration mode to choose.
• Authentication explains API keys, Spotify Connect pairing, and stored sessions.
• Basic integration shows how to observe and control Spotify Soloist from another local process.
• Downloads and updates documents archive URLs and build expiry behavior.
• The Features page describes Spotify Connect device mode, the WebSocket API, command-line control, and single-track mode.
• Reference links to detailed pages for CLI options, the WebSocket API, and soloist ctl.

For questions and help, use the Spotify Developer Community. To report client issues, use the Spotify Soloist GitHub issues tracker. Do not post API keys, unredacted logs, crash reports, or data directories in public community posts.

By using Spotify Soloist, you accept the Spotify Terms and Conditions of Use.

Spotify Soloist includes open-source software. See the Soloist Third-Party Licenses for applicable notices and license terms.