rustfm-scrobble

rustfm-scrobble is a Last.fm Scrobble API 2.0 crate for Rust. It allows easy acccess to the "scrobble" and "now playing" notification endpoints through a simple Rust API. It can be used to record song-plays from music players, build analog scrobbling tools similar to VinylScrobbler or work with IoT Devices. It was initially built to implement a Spotify scrobbling service using the Spotify Connect Protocol when the Alexa Spotify client did not support scrobbling plays to Last.fm.

Features

• Scrobble songs to Last.fm ('scrobble' API endpoint)
• Publish now-playing song to Last.fm ('now playing' API endpoint)
• Batch scrobble support in Scrobbler::scrobble_batch and ScrobbleBatch
• Multiple authentication flows to gain permissions to publish to Last.fm user profile
  • Store a pre-authenticated session key & throw away secret data after initial authentication
• Simple error handling; each API operation returns a Result with a simple Error type on failure
• Unit tested

Install

Add rustfm-scrobble to your Cargo.toml.

[dependencies] rustfm-scrobble="1.0"

Usage

• API Documentation
• Code Examples
  • Example now-playing & scrobbling client
  • Example batch scrobbling client
  • cargo build --examples
  • ./target/debug/examples/example
• Build: cargo build
• Run Unit tests: cargo test

```rust extern crate rustfmscrobble; use rustfmscrobble::{Scrobble, Scrobbler};

let username = "last-fm-username"; let password = "last-fm-password"; let apikey = "client-api-key"; let apisecret = "client-api-secret";

let mut scrobbler = Scrobbler::new(apikey, apisecret); scrobbler.authenticatewithpassword(username, password);

let song = Scrobble::new("Example Artist", "Example Song", "Example Album"); scrobbler.scrobble(song); ```

Status

Version 1.0 has been released. The API is stable & backwards compatibility will be guaranteed for all 1.0 releases.

License

MIT license, see ./LICENSE.