https://github.com/inflatablefriends/lastfm
Portable .Net library for Last.fm
https://github.com/inflatablefriends/lastfm
c-sharp hacktoberfest lastfm netstandard nuget pcl-library portable
Last synced: 3 months ago
JSON representation
Portable .Net library for Last.fm
- Host: GitHub
- URL: https://github.com/inflatablefriends/lastfm
- Owner: inflatablefriends
- License: other
- Created: 2013-06-08T15:59:14.000Z (about 13 years ago)
- Default Branch: next
- Last Pushed: 2023-10-05T03:46:08.000Z (almost 3 years ago)
- Last Synced: 2026-03-27T03:25:03.164Z (4 months ago)
- Topics: c-sharp, hacktoberfest, lastfm, netstandard, nuget, pcl-library, portable
- Language: C#
- Homepage:
- Size: 23.4 MB
- Stars: 99
- Watchers: 11
- Forks: 60
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Inflatable Last.fm .NET SDK
[](LICENCE.md)
## Maintenence help wanted
Hi there! The maintainer of this library @rikkit is now mostly a TypeScript + React dev, and has been for the last several years. Since this is a .Net library, the maintainer will probably not be able to keep it up-to-date to the latest .Net standards. If you spot something wrong, please file and issue or better yet, a pull request. Thanks!
## 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](https://github.com/inflatablefriends/lastfm/issues), or send a message to [the Gitter chatroom](https://gitter.im/inflatablefriends/lastfm) if you need help with the library.
If you're interested in contributing code or documentation, [this short introduction to the library](doc/contributing.md) will help you get started.
## Quickstart
### Installing
#### NuGet
Install [Inflatable.Lastfm](
https://www.nuget.org/packages/Inflatable.Lastfm/) from NuGet.
#### NuGet - prerelease code
1. Install the [.NET Core SDK](https://docs.microsoft.com/en-us/dotnet/core/install/sdk)
2. Clone this repo and checkout to the commit you need
3. Run `dotnet pack`
4. Reference the built NuGet package file in your project
### Examples
First, [sign up for Last.fm API](http://last.fm/api) access if you haven't already.
Create a LastfmClient:
```c#
var client = new LastfmClient("apikey", "apisecret");
```
Get information about an album:
```c#
var response = await client.Album.GetInfoAsync("Grimes", "Visions");
LastAlbum visions = response.Content;
```
For methods that return several items, you can iterate over the response:
```c#
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:
```c#
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
```c#
if (client.Auth.HasAuthenticated) {
var response = await client.Track.LoveAsync("Ibi Dreams of Pavement (A Better Day)", "Broken Social Scene");
}
```
## Documentation
- [Api method progress report](PROGRESS.md)
- [Contributing](doc/contributing.md)
- [Scrobbling](doc/scrobbling.md)
- [Dependency Injection](doc/dependency-injection.md)
- [Example Windows Phone app](https://github.com/inflatablefriends/lastfm-samples)
## Platform Compatibility
The main package targets ```netstandard1.1```. Development is on the ```master``` branch.
### Dependencies
- Newtonsoft.Json 9.0.1 =<
- System.Net.Http 4.3.0 =<
### Supported platforms
Check [this table](https://docs.microsoft.com/en-us/dotnet/articles/standard/library#net-platforms-support) for supported platforms.
### Other platforms
If you need support for a .NET platform that doesn't support .Net Standard 1.1, first see if the feature you need is available in v0.3 or earlier - that version targeted PCL profile 259, and so is compatible with e.g. Windows 8.0 and Windows Phone 7.
If you need a feature for these older platforms, please raise an issue.
## Credits
Maintained by [@rikkilt](http://twitter.com/rikkilt).
Thanks to [all contributors](https://github.com/inflatablefriends/lastfm/graphs/contributors)!