mirror for docker/* tags

Paul Lietar c3c258dfaf Bump protobuf-macros version and use the simpler string literal syntax 9 rokov pred
cache 85c1925f8d Fixes compilation errors 9 rokov pred
capi 5a9b139a7f Intern returned C strings to avoid leaking them. 9 rokov pred
docs dfabbe5aa5 Add Blob based authentication 9 rokov pred
protocol 3c29d744a9 Use the protobuf_build crate to simplify build process. 9 rokov pred
src c3c258dfaf Bump protobuf-macros version and use the simpler string literal syntax 9 rokov pred
.gitignore 9b924d1c47 Add README with build and run instructions. 9 rokov pred
.travis.yml cf2e9bb7c3 Make dns-sd opt in rather than opt out. 9 rokov pred
Cargo.lock c3c258dfaf Bump protobuf-macros version and use the simpler string literal syntax 9 rokov pred
Cargo.toml cf2e9bb7c3 Make dns-sd opt in rather than opt out. 9 rokov pred
LICENSE a993b60ffa Initial commit. 10 rokov pred
README.md f3d56d0afe Update the README to reflect the new build dependencies. 9 rokov pred
build.rs 7401fde7fc Update dependencies 9 rokov pred

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

Building librespot requires rust nightly. It will not work on rust stable or beta.

It also requires a C and C++ toolchain, with libprotoc and portaudio.

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

sudo apt-get install build-essential portaudio19-dev libprotoc-dev

On OS X, using homebrew :

brew install portaudio protobuf

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

cargo build

Usage

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

target/debug/librespot --appkey APPKEY --username USERNAME --cache CACHEDIR --name DEVICENAME

Discovery mode

librespot can be run in discovery mode, in which case no password is required at startup. dns-sd or avahi's compatibility layer is required for this. On debian/ubuntu this is the libavahi-compat-libdnssd-dev package. It come preinstalled on OS X.

It must be enabled at build time :

cargo build --features discovery

When running librespot simply omit the --username argument.

Facebook Accounts

If you connect using a facebook account, librespot will not show up among the devices in the Spotify app. What you need to do is apply for a device password and use that to sign in instead.

Disclaimer

Using this code to connect to Spotify's API is probably forbidden by them, and might result in you application key getting banned. Use at you 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.