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:8888in 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