An unofficial Spotify client using Qt as a simpler, lighter alternative to the official client. Please note that you need an actual Spotify client running, for example librespot, which can be configured from within the app.

[!NOTE] Controlling playback requires Spotify Premium.

Contributions are very welcome!

Goals

• Fast, light on resources, and small file size.
• Portable, and supporting as many platforms and architectures as possible.
• Customizable.

Non-goals

• Having the same features as the official client.

Supported platforms

Any system with a C++17 compiler and Qt 6 is supported, but only Linux (x86-64 and aarch64) is regularly being tested, so if an issue occurs on your preferred platform, please report it!

Installing

spotify-qt is available from some package managers. If there are any package issues, or the version is out of date, contact the respective package maintainers, not me, unless I'm the package maintainer. If you want to maintain the package on a system not in the list below, you are very much free to, just please open an issue, or get in contact with me, so I can add it to the list.

If you're running some other Linux distribution, macOS, or Windows, you can instead download portable binaries from the release page. If you want to try out new features, you can download unstable builds automatically built every day from spotify-qt-nightly.

Questions?

Check the FAQ on the wiki, or the discussions!

You can also check out the roadmap, or issues, for planned features and known bugs.

Building yourself

Make sure you have Qt (6.0+) with SVG support, CMake (3.16+) and various build tools like make/ninja, g++ and git. Keep in mind that the develop branch is unstable at all times. Therefore, it's recommended to use the stable branch, which is updated after each new stable release, only including important bug fixes, unless you want to try out new features.

git clone --branch stable https://github.com/kraxarn/spotify-qt.git
cd spotify-qt
cmake -S . -B build -D CMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build --parallel
./build/spotify-qt