diff --git a/Cargo.toml b/Cargo.toml index 1f992257..2751ac16 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -3,7 +3,7 @@ name = "librespot" version = "0.1.0" authors = ["Librespot Org"] license = "MIT" -description = "Open Source Spotify client library" +description = "An open source client library for Spotify, with support for Spotify Connect" keywords = ["spotify"] repository = "https://github.com/librespot-org/librespot" readme = "README.md" diff --git a/PUBLISHING.md b/PUBLISHING.md new file mode 100644 index 00000000..952a0b8c --- /dev/null +++ b/PUBLISHING.md @@ -0,0 +1,9 @@ +# Publishing + +Publishing librespot to crates.io is a slightly convoluted affair due to the various dependencies that each package has on other local packages. The order of publising that has been found to work is as follows: + +`protocol -> core -> audio -> metadata -> playback -> connect -> librespot` + +The `protocol` package needs to be published with `cargo publish --no-verify` due to the build script modifying the source during compile time. + +Publishing can be done using the command `cargo publish` in each of the directories of the respecive crate. \ No newline at end of file diff --git a/README.md b/README.md index e9cbf79e..62dc52e8 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,6 @@ [![Build Status](https://travis-ci.org/librespot-org/librespot.svg?branch=master)](https://travis-ci.org/librespot-org/librespot) [![Gitter chat](https://badges.gitter.im/librespot-org/librespot.png)](https://gitter.im/librespot-org/spotify-connect-resources) +[![Crates.io](https://img.shields.io/crates/v/librespot.svg)](https://crates.io/crates/librespot) Current maintainer is @awiouy folks. @@ -11,6 +12,11 @@ which are not available in the official library. _Note: librespot only works with Spotify Premium. This will remain the case for the forseeable future, as we are unlikely to work on implementing the features such as limited skips and adverts that would be required to make librespot compliant with free accounts._ +## Quick start +We're available on [crates.io](https://crates.io/crates/librespot) as the _librespot_ package. Simply run `cargo install librespot` to install librespot on your system. Check the wiki for more info and possible [usage options](https://github.com/librespot-org/librespot/wiki/Options). + +After installation, you can run librespot form the CLI using a command such as `librespot -n "Librespot Speaker" -b 192` to create a speaker called _Librespot Speaker_ serving 192kbps audio. + ## This fork As the origin by [plietar](https://github.com/plietar/) is no longer actively maintained, this organisation and repository have been set up so that the project may be maintained and upgraded in the future.