Skip to content

librespot-org/librespot-java

Repository files navigation

librespot-java

Build Status Codacy Badge time tracker Maven Central

librespot-java is a port of librespot, originally written in Rust, which has evolved into the most up-to-date open-source Spotify client. Additionally, this implementation provides a useful API to request metadata or control the player, more here.

Disclaimer!

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.

Features

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)

The library

The lib module provides all the necessary components and tools to interact with Spotify. More here.

The player

The player module provides the full player experience. You can use it from Spotify Connect, and it operates in full headless mode. More here.

Protobuf generation

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.

Logging

The application uses Log4J for logging purposes, the configuration file is placed inside lib/src/main/resources, player/src/main/resources or api/src/main/resources depending on what you're working with. You can also toggle the log level with logLevel option in the configuration.

Related Projects

Special thanks

  • 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