Enjoy listening to your favorite Spotify content with Riff: a libadwaita/GTK4-based Spotify client designed for GNOME!

Originally a fork of Spot, Riff continues development to bring the coolest Spotify client onto your desktop and mobile. Written in Rust and based on librespot.

If you have any feature suggestions or want to contribute to the project, feel free to leave an issue / pull request or join the discussion on our Discord server!

Note: AI contributions in any part are not welcome.

Riff is currently only available on Flathub. Install with the command below:

flatpak install flathub dev.diegovsky.Riff

It is recommended to install a libsecret compliant keyring application, such as GNOME Keyring (aka seahorse). This will allow saving your password securely between launches.

In GNOME, things should work out of the box. It might be a bit trickier to get it working in other DEs: see this ArchWiki entry for detailed explanations on how to automatically start the daemon with your session.

Bear special attention to the fact that to enable automatic login, you might have to use the same password for your user account and for the keyring, and that the keyring might need to be set as default.

See this comment for more details!

Only works with premium accounts!

• playback control (play/pause, prev/next, seeking, shuffle, repeat (none, all, song))
• selection mode: easily browse and select mutliple tracks to queue them
• browse your saved albums and playlists
• search albums and artists
• view an artist's releases
• view users' playlists
• view album info
• credentials management with Secret Service
• MPRIS integration
• playlist management (creation and edition)
• liked tracks

Contributions are welcome! If you wish, add yourself to the AUTHORS files when submitting your contribution.

For any large feature/change, please open an issue first to discuss implementation and design decisions.

Translations are managed using gettext and are available in the po/ subdirectory.

Please use POEditor to submit translations.

If you feel like it, you are welcome to open a PR to be added to the TRANSLATORS file!

An overview of the directories and their responsibilities:

See doc/Design.md for a deeper explanation of the data flow and architecture.

You can install the required development dependencies by running:

./scripts/setup-dev.sh

Pre-requisite: install the org.freedesktop.Sdk.Extension.rust-stable SDK extension with flatpak. Builder might do this for you automatically, but it will install an older version; make sure the version installed matches the version of the Freedesktop SDK GNOME uses.

Open the project in GNOME Builder and make the flatpak/dev.diegovsky.Riff.snapshots.json configuration active. Then build :)

You build and install with meson:

meson setup target -Dbuildtype=debug -Doffline=false --prefix="$HOME/.local"
ninja install -C target
# to run test/linter/etc
meson test -C target  --verbose

This will install a .desktop file among other things, and the riff executable will be put in .local/bin (you might want to add it to your path).

To build an optimized release build, use -Dbuildtype=release instead.

When adding new msgids, don't forget to regenerate/update the potfiles.

ninja riff-pot -C target
ninja riff-update-po -C target

We are now using POEditor and the wonderful poeditor-sync tool.

poeditor pull

Using flatpak-cargo-generator.py:

ninja cargo-sources.json -C target

Set the RUST_LOG env variable to the appropriate level.

Debug builds (flatpak) are available from the master branch on Github (see the riff-snaphots action).

Riff caches images and HTTP responses in ~/.cache/riff.

Ruff uses isahc, which uses libcurl, therefore you can set the https_proxy env variable to help with debugging. In debug mode, Riff skips SSL certificate verification.