TobiasVeiga00/soloist-mpris

选用指南

AI 根据 README 整理 · 2026/10/20 16:52:09

使用方式

通过安装脚本安装，使用playerctl或媒体键控制播放，可通过命令行或Spotify Connect选择播放内容。

查看 README 依据

git clone https://github.com/TobiasVeiga00/soloist-mpris cd soloist-mpris ./install.sh ``` The script installs the bridge, downloads Soloist from Spotify, sets up the user services and asks for your **Soloist API key**. To get one, open the [Spotify for Developers dashboard](https://developer.spotify.com/dashboard), go to the **Spotify Soloist API Key** page, accept the terms and generate a key. The key is stored in `~/.config/soloist/env`, readable only by you. Everything goes under your home directory; nothing needs root. ### Pair it once

Open Spotify on your phone, **on the same network**, play something, tap the devices icon and choose your computer (its hostname). Soloist remembers the login, so from then on it is available from every Spotify app. If it does not show up, your firewall is blocking the local discovery. Allow incoming `5353/udp` and the TCP port Soloist listens on (`ss -tlnp | grep soloist`) from your local network, pair, then remove the rules. ## Everyday use ```sh playerctl -p soloist play-pause # or your media keys playerctl -p soloist metadata

部署要求

需要Linux系统（x86_64、arm64或arm32）及systemd用户会话，PipeWire或PulseAudio，Spotify Premium账户，以及curl和tar。

查看 README 依据

when the music is going; - a native client such as [Spotifast](https://github.com/crmne/spotifast), used as a remote control; - the terminal: `soloist ctl play spotify:playlist:...` Once music plays, everything else comes from your desktop: keys, bar, `playerctl`. ## Requirements - Linux on x86_64, arm64 or arm32, with a systemd user session - PipeWire or PulseAudio - Spotify **Premium** (Soloist needs it to set up) - `curl` and `tar`. Rust is optional: without it, the installer downloads a prebuilt bridge for x86_64 or arm64 (arm32 needs Rust to build it) ## Install ```sh

已知限制

Soloist构建版本90天后失效，需每周定时更新；Soloist本身没有库或搜索功能，需通过其他Spotify Connect控制器选择音乐。

查看 README 依据

- **Official playback.** Soloist is Spotify's own player, so it is not affected by the [audio key refusals](https://github.com/librespot-org/librespot/issues/1649) that stop librespot-based clients on many accounts. - **No expiry surprises.** Soloist builds stop working after 90 days, so a weekly timer fetches the current one from Spotify. ## How light is it? Same laptop (ThinkPad T480, i5-8350U, Arch Linux), same song, 60 seconds of playback each, measured with [`bench/measure.sh`](bench/measure.sh): | | RAM (PSS) | CPU (one core) | Installed size | | --- | --- | --- | --- |

Here, three small processes play the music and nothing renders at all. Run the same measurement on your machine while music plays: ```sh bench/measure.sh '^(soloist|soloist-mpris)$' 60 # this kit bench/measure.sh '^spotify$' 60 # the desktop app ``` ## Choosing what to play Soloist is a speaker: it has no library or search of its own. You pick music with any Spotify Connect controller and play it here: - the **Spotify app on your phone** (devices icon, then this computer); - **[open.spotify.com](https://open.spotify.com)** in any browser, closed again