librespot-java is a port of librespot, originally written in Rust, which has evolved into the most up-to-date open-source Spotify client.
We (the librespot-org organization and me) DO NOT encourage piracy and DO NOT support any form of downloader/recorder designed with the help of this repository and in general anything that goes against the Spotify ToS. If you're brave enough to put at risk this entire project, just don't publish it. This is meant to provide support for all those devices that are not officially supported by Spotify.
This repository is based on librespot-java and includes modifications required for NTify.
All changes from the upstream project are kept transparent in this fork.
This client is pretty much capable of playing anything that's available on Spotify. Its main features are:
- Tracks and podcasts/episodes playback
- Stations and dailymixes support
- Local content caching
- Zeroconf (Spotify Connect)
- Gapless playback
- Mixed playlists (cuepoints and transitions)
- Execute commands for various events
- Supports custom sinks and decoders
Actively developed and up-to-date with the latest internal API
The lib module provides all the necessary components and tools to interact with Spotify. More here.
The player module provides the full player experience. You can use it from Spotify Connect, and it operates in full headless mode. More here.
The compiled Java protobuf definitions aren't versioned, therefore, if you want to open the project inside your IDE, you'll need to run mvn compile first to ensure that all the necessary files are created. If the build fails due to missing protoc you can install it manually and use the -DprotocExecutable=/path/to/protoc flag.
The com.spotify package is reserved for the generated files.
The application uses sl4j with a custom logging implementation from NTify.
- All the developers of librespot which started this project in Rust
- All the contributors of this project for testing and fixing stuff
that provided a free license for their Java Profiler
