Skip to content

kraxarn/spotify-qt

Repository files navigation

spotify-qt with dark theme

Linux Build Windows Build macOS Build

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) AUR kraxarn
NetBSD pkgsrc pin
FreeBSD FreeBSD Ports ehaupt
Void Linux Void Linux abenson
NixOS nixpkgs unstable karthikiyengar
openSUSE openSUSE Multimedia:Apps Tumbleweed package KaratekHD
Alpine Linux Alpine Linux Edge ptrcnull
Windows Scoop extras 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.

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 (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