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++11 compiler and Qt is supported, but only Linux, Windows (x64) and macOS (arm64) are regularly being tested, so if an issue occurs on your favorite 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.

Platform	Package	Maintainer
Arch (or Arch-based)		kraxarn
NetBSD		pin
FreeBSD		ehaupt
Void Linux		abenson
NixOS		karthikiyengar
openSUSE		KaratekHD
Ubuntu		kraxarn
Alpine Linux		ptrcnull
Windows		brian6932

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.

Configuring

• open https://developer.spotify.com/dashboard/
• create a new application
• goto edit settings in the app overview
• add http://localhost:8888 in Redirect URIs section

• launch Spotify-qt and copy/paste Client ID and Client Secret, you should be able to login

Building yourself

Make sure you have Qt (5.9+/6.0+) with SVG support, CMake (3.5+) and various build tools like make, g++ and git. Keep in mind that the master 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
mkdir build
cd build
cmake ..
make
./spotify-qt