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.
- Modern GTK4 and libadwaita interface with light/dark themes and a responsive layout
- Play, pause, skip, seek, shuffle, and repeat with gapless playback
- 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
Flathub (recommended)
flatpak install flathub dev.diegovsky.RiffFrom 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.flatpakBuild from source
./scripts/setup-dev.sh # install dependencies
./scripts/build.sh release --install # build and install to ~/.local
~/.local/bin/riff # run RiffSee the Development Guide for full build instructions, project structure, and troubleshooting.
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.
This project follows the GNOME Code of Conduct. Please familiarize yourself with it before interacting with this repository.