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

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

extern crate rustfm_scrobble;
use rustfm_scrobble::{Scrobble, Scrobbler};

let username = "last-fm-username";
let password = "last-fm-password";
let api_key = "client-api-key";
let api_secret = "client-api-secret";
 
let mut scrobbler = Scrobbler::new(api_key, api_secret);
scrobbler.authenticate_with_password(username, password);
 
let song = Scrobble::new("Example Artist", "Example Song", "Example Album");
scrobbler.scrobble(song);

In Use

rustfm-scrobble is used in several projects including polaris, connectr, rescrobbled and rb-scrobbler.

Status

The API is stable & backwards compatibility will be guaranteed for all 1.0 releases.

License

MIT license, see ./LICENSE.