Browse Source

Update readme and add publishing notes

Sasha Hilton 4 years ago
parent
commit
9e2cfe321e
3 changed files with 16 additions and 1 deletions
  1. 1 1
      Cargo.toml
  2. 9 0
      PUBLISHING.md
  3. 6 0
      README.md

+ 1 - 1
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"

+ 9 - 0
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.

+ 6 - 0
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.