spotify/soloist
spotify/soloist has 92 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours and +10 in 7 days. Last checked 2026-11-15 16:57 UTC. Last push 2026-10-23.
What you can do
- Music, podcasts, and audiobooks: the whole catalog, streaming into your custom setup
- Spotify Connect: control playback from your phone or desktop
- Local WebSocket API: playback control, real-time events, and queue access for building your own DIY integrations
- Jam: listen together with your family and friends
Measured star growth
- in 24h
- 0
- in 7 days
- +10
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A headless Spotify client for Linux-based systems
Creative & MediaREADME.md
OriginalSpotify Soloist
A new headless Spotify client for terminal-based and DIY setups.
Spotify Soloist is a lightweight, command-line Spotify Connect receiver for Linux, macOS, and Windows. Install it on a Raspberry Pi, a home server, any Linux box, or your Mac or PC, and it shows up in your Spotify app as a Connect device, ready to play. It is built on the same playback engine as the other Spotify apps.
Read the full announcement on the Spotify for Developers blog.
Features
- Music, podcasts, and audiobooks: the whole catalog, streaming into your custom setup
- Spotify Connect: control playback from your phone or desktop
- Local WebSocket API: playback control, real-time events, and queue access for building your own DIY integrations
- Jam: listen together with your family and friends
- Loudness normalization with peak limiting
- Smart Shuffle and Autoplay to keep the music flowing
- Lossless audio: up to 24-bit/44.1 kHz (Premium)
- Crossfade and automix for smooth transitions between tracks (Premium)
Requirements
- One of:
- A Raspberry Pi or any other Linux device on ARMv7, AArch64, or x86_64, with PipeWire (or PulseAudio) for audio output
- An Apple Silicon Mac running macOS 13 or newer
- An x86_64 Windows PC
- A Premium account is needed to set up Spotify Soloist, but once it’s running both Free and Premium users can connect. Premium unlocks lossless audio and mixing
- A Spotify for Developers account, used to download Spotify Soloist and issue your device credential.
Install & Getting Started
Read the full Getting Started instructions on Spotify for Developers.
WebSocket API
Spotify Soloist runs a local WebSocket server for integrations. It accepts playback commands (play, pause, seek, volume, shuffle, repeat, add to queue), emits real-time playback events, and exposes the play queue with full track metadata. If you are building a now-playing display, a hardware controller, or a home automation hook, start here: WebSocket API
Feedback
Questions and general feedback: the Soloist thread on the Spotify Community forum. Bug reports: open an issue on this repository.