Riff

Riff is a Spotify client that puts your music library front and center. It features a clean, minimal design that lets you listen distraction-free.

---

[!NOTE] Requires a Spotify Premium account. Some accounts may not work due to Spotify's new PlayPlay DRM, which is proprietary and cannot be implemented externally.

[!WARNING] This project does not accept AI-generated contributions, as outlined by Flathub's Generative AI Policy and GNOME Circle's AI Policy.

Features

• Modern GTK4 and libadwaita interface with light/dark themes and a responsive layout
• Play, pause, skip, seek, shuffle, and repeat with gapless playback
• Like tracks and follow artists, albums, and playlists
• Browse your saved albums, playlists, liked tracks, and followed artists
• Search for albums, artists, tracks, and playlists
• Share and open Spotify links with your friends using automatic link detection
• Fine-tune your sound with a built-in DSP engine featuring a 10-band equalizer, stereo pan, and pitch shift
• Advance desktop integration: media keys (MPRIS), inhibits session suspend while playing, and secure credential storage

Installing

Flathub (recommended)

flatpak install flathub dev.diegovsky.Riff

From a GitHub release

Pre-built bundles are available on the Releases page. Download the latest full release or development build Flatpak bundle and install it with:

flatpak install --user Riff-x86_64.flatpak

Build from source

./scripts/setup-dev.sh                # install dependencies
./scripts/build.sh release --install  # build and install to ~/.local
~/.local/bin/riff                     # run Riff

See the Development Guide for full build instructions, project structure, and troubleshooting.

Contributing

Contributions are welcome and encouraged! See Contributing Guide for PR guidelines and process, and the Development Guide for build setup, feature flags, and debug tools.

Translation contributions are temporarily paused while we migrate to a new platform.

Code of Conduct

This project follows the GNOME Code of Conduct. Please familiarize yourself with it before interacting with this repository.