Skip to content

viktorija/lastfm

 
 

Repository files navigation

Inflatable Last.fm .NET SDK

Project logo

Code licence Build status ![Gitter](https://badges.gitter.im/Join Chat.svg)

Project Goals

  • To provide complete .NET bindings for the Last.fm REST API
  • To build useful components for Last.fm applications
  • To be the very best, like no-one ever was

Contributing

Input is always welcome! Raise an issue on GitHub, or send a message to the Gitter chatroom if you need help with the library.

If you're interested in contributing code or documentation, this short introduction to the library will help you get started.

Quickstart

Installing the SDK

NuGet - production code

Install the NuGet package. Search for Inflatable.Lastfm in the NuGet package browser.

NuGet - prerelease code

There is a NuGet package built for every commit to master. Add https://ci.appveyor.com/nuget/lastfm to your NuGet package sources, and install the IF.Lastfm.Core prerelease package.

From source

Clone this repo and reference IF.Lastfm.Core in your application. Your IDE needs to support C# 6 and portable libraries - Visual Studio 2015 Community or better.

Using the SDK

First, sign up for Last.fm API access if you haven't already.

Create a LastfmClient:

var client = new LastfmClient("apikey", "apisecret");

Get information about an album:

var response = client.Album.GetInfoAsync("Grimes", "Visions");

LastAlbum visions = response.Content;

For methods that return several items, you can iterate over the response:

var pageResponse = await client.Artist.GetTopTracksAsync("Ben Frost", page: 5, itemsPerPage: 100);

var trackNames = pageResponse.Select(track => track.Name);

Several API methods require user authentication. Once you have your user's Last.fm username and password, you can authenticate your instance of LastfmClient:

var response = await client.Auth.GetSessionTokenAsync("username", "pass");

// or load an existing session
UserSession cachedSession;
var succesful = client.Auth.LoadSession(cachedSession);

Authenticated methods then work like any other

if (client.Auth.HasAuthenticated) {
	var response = await client.Track.LoveAsync("Ibi Dreams of Pavement (A Better Day)", "Broken Social Scene");
}

Documentation

Platform Compatibility

There are two packages of this library. If you need support for Windows Phone 7, or another .NET platform, it's probably easy enough. Raise an issue or send a PR.


.Net Standard 1.1

Versions 1.0.x target netstandard1.1. Development is on the master branch.

Dependencies

  • Newtonsoft.Json 9.0.1 =<
  • System.Net.Http 4.3.0 =<

Platforms

Check this table for supported platforms.


PCL Profile 259

Versions 0.3.x target portable-win8+net45+wp8+wpa81 Development is on the profile259 branch.

Dependencies

  • Newtonsoft.Json 6.0.5 =<
  • Microsoft.Net.Http 2.2.8 =<

Platforms

The library is compatible with:

  • .NET 4.5 (including Mono)
  • Windows 8.0 =<
  • Windows Phone 8.1 =<
  • Windows Phone Silverlight 8 =<
  • Xamarin.Android and Xamarin.iOS

Credits

Maintained by @rikkilt. Thanks to all contributors!

About

Portable .Net library for Last.fm

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.2%
  • PowerShell 0.8%