mirror for docker/* tags

Paul Lietar d2161ff75f Use EasyBuf instead of copying buffers 7 ani în urmă
assets 6f85deadd9 don't run as root, drop privileges 7 ani în urmă
cache 85c1925f8d Fixes compilation errors 9 ani în urmă
docs 9e495d6fd7 Add AP fallback to protocol docs 7 ani în urmă
protocol ea94db00df Rebuild protobuf files 7 ani în urmă
src d2161ff75f Use EasyBuf instead of copying buffers 7 ani în urmă
.gitignore a42752af2f Update dependencies. 8 ani în urmă
.travis.yml baf2b65d7b Use rustls rather than openssl 7 ani în urmă
Cargo.lock 17482c236a Stop caching audio keys, reenable audio file cache 7 ani în urmă
Cargo.toml 17482c236a Stop caching audio keys, reenable audio file cache 7 ani în urmă
LICENSE a993b60ffa Initial commit. 9 ani în urmă
README.md e254bb7291 Remove support for Facebook authentication. 7 ani în urmă
build.rs f3ba3f4bd4 Update dependencies 7 ani în urmă

README.md

librespot

librespot is an open source client library for Spotify. It enables applications to use Spotify's service, without using the official but closed-source libspotify. Additionally, it will provide extra features which are not available in the official library.

Status

librespot is currently under development and is not fully functional yet. You are however welcome to experiment with it.

Building

Rust 1.7.0 or later is required to build librespot.

It also requires a C, with portaudio.

On debian / ubuntu, the following command will install these dependencies :

sudo apt-get install build-essential portaudio19-dev

On Fedora systems, the following command will install these dependencies :

sudo dnf install portaudio-devel make gcc

On OS X, using homebrew :

brew install portaudio

Once you've cloned this repository you can build librespot using cargo.

cargo build --release

Usage

A sample program implementing a headless Spotify Connect receiver is provided. Once you've built librespot, run it using :

target/release/librespot --username USERNAME --cache CACHEDIR --name DEVICENAME

Discovery mode

librespot can be run in discovery mode, in which case no password is required at startup. For that, simply omit the --username argument.

Audio Backends

librespot supports various audio backends. Multiple backends can be enabled at compile time by enabling the corresponding cargo feature. By default, only PortAudio is enabled.

A specific backend can selected at runtime using the --backend switch.

cargo build --features portaudio-backend
target/release/librespot [...] --backend portaudio

The following backends are currently available :

  • ALSA
  • PortAudio
  • PulseAudio

Development

When developing librespot, it is preferable to use Rust nightly, and build it using the following :

cargo build --no-default-features --features "nightly portaudio-backend"

This produces better compilation error messages than with the default configuration.

Disclaimer

Using this code to connect to Spotify's API is probably forbidden by them. Use at your own risk.

Contact

Come and hang out on gitter if you need help or want to offer some. https://gitter.im/sashahilton00/spotify-connect-resources

License

Everything in this repository is licensed under the MIT license.