2015-07-14 22:25:44 +00:00
|
|
|
# librespot
|
|
|
|
*librespot* is an open source client library for Spotify. It enables
|
|
|
|
applications to use Spotify's service, without using the official but
|
2016-01-20 13:36:58 +00:00
|
|
|
closed-source libspotify. Additionally, it will provide extra features
|
|
|
|
which are not available in the official library.
|
2015-07-14 22:25:44 +00:00
|
|
|
|
|
|
|
## Status
|
|
|
|
*librespot* is currently under development and is not fully functional yet. You
|
|
|
|
are however welcome to experiment with it.
|
|
|
|
|
|
|
|
## Building
|
2016-03-11 13:14:01 +00:00
|
|
|
Rust 1.7.0 or later is required to build librespot.
|
2015-07-14 22:25:44 +00:00
|
|
|
|
2016-11-21 02:48:17 +00:00
|
|
|
It also requires a C, with portaudio.
|
2015-07-14 22:25:44 +00:00
|
|
|
|
2016-01-20 13:36:58 +00:00
|
|
|
On debian / ubuntu, the following command will install these dependencies :
|
|
|
|
```shell
|
2016-11-21 02:48:17 +00:00
|
|
|
sudo apt-get install build-essential portaudio19-dev
|
2016-01-20 13:36:58 +00:00
|
|
|
```
|
2015-12-18 18:01:25 +00:00
|
|
|
|
2016-03-17 13:20:27 +00:00
|
|
|
On Fedora systems, the following command will install these dependencies :
|
|
|
|
```shell
|
2016-11-21 02:48:17 +00:00
|
|
|
sudo dnf install portaudio-devel make gcc
|
2016-03-17 13:20:27 +00:00
|
|
|
```
|
|
|
|
|
2016-01-20 13:36:58 +00:00
|
|
|
On OS X, using homebrew :
|
|
|
|
```shell
|
2016-11-21 02:48:17 +00:00
|
|
|
brew install portaudio
|
2016-01-20 13:36:58 +00:00
|
|
|
```
|
2016-01-16 00:21:27 +00:00
|
|
|
|
2015-07-14 22:25:44 +00:00
|
|
|
Once you've cloned this repository you can build *librespot* using `cargo`.
|
|
|
|
```shell
|
2016-02-25 22:30:49 +00:00
|
|
|
cargo build --release
|
2015-07-14 22:25:44 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
A sample program implementing a headless Spotify Connect receiver is provided.
|
|
|
|
Once you've built *librespot*, run it using :
|
|
|
|
```shell
|
2016-07-06 07:32:43 +00:00
|
|
|
target/release/librespot --username USERNAME --cache CACHEDIR --name DEVICENAME
|
2015-07-14 22:25:44 +00:00
|
|
|
```
|
|
|
|
|
2016-01-20 13:36:58 +00:00
|
|
|
## Discovery mode
|
|
|
|
*librespot* can be run in discovery mode, in which case no password is required at startup.
|
2016-05-07 11:55:59 +00:00
|
|
|
For that, simply omit the `--username` argument.
|
2016-01-20 13:36:58 +00:00
|
|
|
|
2016-03-20 16:16:11 +00:00
|
|
|
## 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.
|
|
|
|
|
|
|
|
```shell
|
|
|
|
cargo build --features portaudio-backend
|
|
|
|
target/release/librespot [...] --backend portaudio
|
|
|
|
```
|
|
|
|
|
|
|
|
The following backends are currently available :
|
2016-03-14 02:16:59 +00:00
|
|
|
- ALSA
|
2016-03-20 19:16:32 +00:00
|
|
|
- PortAudio
|
2016-03-21 15:39:48 +00:00
|
|
|
- PulseAudio
|
2016-03-20 16:16:11 +00:00
|
|
|
|
2015-07-14 22:25:44 +00:00
|
|
|
## Disclaimer
|
2016-07-06 07:32:43 +00:00
|
|
|
Using this code to connect to Spotify's API is probably forbidden by them.
|
|
|
|
Use at your own risk.
|
2015-07-14 22:25:44 +00:00
|
|
|
|
|
|
|
## 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.
|
|
|
|
|