Psst

A fast Spotify client with a native GUI written in Rust, without Electron. Psst is still very early in development, lacking in features, stability, and general user experience. It's fully cross-platform, supporting Windows, Linux, and macOS. Contributions are welcome!

Note: A Spotify Premium account is required.

Download

GitHub Actions automatically creates builds when new commits are pushed to the main branch. You can download the prebuilt binaries for x86_64 Windows, Linux (Ubuntu), and macOS.

Platform
Linux (x86_64)
Linux (aarch64)
Debian Package (amd64)
Debian Package (arm64)
MacOS
Windows

Unofficial builds of Psst are also available through the AUR and Homebrew.

Building

On all platforms, the latest Rust stable (at least 1.65.0) is required. For platform-specific requirements, see the dropdowns below.

Linux

Our user-interface library, Druid, has two possible backends on Linux: GTK and pure X11, with a Wayland backend in the works. The default Linux backend is GTK. Before building on Linux, make sure the required dependencies are installed.

Debian/Ubuntu:

sudo apt-get install libssl-dev libgtk-3-dev libcairo2-dev libasound2-dev

RHEL/Fedora:

sudo dnf install openssl-devel gtk3-devel cairo-devel alsa-lib-devel

OpenBSD (WIP)

OpenBSD support is still a WIP, and things will likely not function as intended. Similar to Linux, Druid defaults to GTK while also providing a pure X11 backend. Furthermore, bindgen must be able to find LLVM through the expected environment variable. Only OpenBSD/amd64 has been tested so far.

doas pkg_add gtk+3 cairo llvm
export LIBCLANG_PATH=/usr/local/lib

In case rustc(1) fails building bigger crates

memory allocation of xxxx bytes failed
error: could not compile `gtk`
Caused by:
  process didn't exit successfully: `rustc --crate-name gtk [...]` (signal: 6, SIGABRT: process abort signal)
warning: build failed, waiting for other jobs to finish...

try increasing your user's maximum heap size:

ulimit -d $(( 2 * `ulimit -d` ))

Build from Source:

cargo build
# Append `--release` for a release build.

Run from Source:

cargo run --bin psst-gui
# Append `--release` for a release build.

Build Installation Bundle (i.e., macOS .app):

cargo install cargo-bundle
cargo bundle --release

Roadmap

Development

Contributions are very welcome!
Here's the basic project structure:

/psst-core - Core library, takes care of Spotify TCP session, audio file retrieval, decoding, audio output, playback queue, etc.
/psst-gui - GUI application built with Druid
/psst-cli - Example CLI that plays a track. Credentials must be configured in the code.
/psst-protocol - Internal Protobuf definitions used for Spotify communication.

Privacy Policy

Psst connects only to the official Spotify servers and does not call home. Caches of various things are stored locally and can be deleted anytime. User credentials are not stored at all; instead, a re-usable authentication token from Spotify is used.

Thanks

This project would not exist without the following:

Big thank you to librespot, the Open Source Spotify client library for Rust. Most of psst-core is directly inspired by the ideas and code of librespot, although with a few differences:
- Spotify Connect (remote control) is not supported yet.
- Psst is completely synchronous, without tokio or other async runtime, although it will probably change in the future.
- Psst is using HTTPS-based CDN audio file retrieval, similar to the official Web client or librespot-java, instead of the channel-based approach in librespot.
druid native GUI library for Rust.
ncspot cross-platform ncurses Spotify client written in Rust, using librespot.
...and of course other libraries and projects.

jpochyla/psst