Last.fm API Ruby client
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
Gemfile
LICENSE
README.md
Rakefile
lastfm.gemspec

README.md

Last.fm API Ruby Client

LastFM is a Ruby wrapper for Last.fm API.

Installation

Add the following line to your Gemfile and run bundle install:

gem 'lastfm-client', :git => 'http://github.com/pch/lastfm-client.git'

You also need to set up your API key and client name, e.g.:

LastFM.api_key     = "7234655fd87556209fa94ca6f5e7ad0a8b47f394"
LastFM.client_name = "My awesome app"

If you're using Rails, you can add the above lines to an initalizer file, e.g. config/initializers/lastfm.rb

Usage examples

LastFM::Album.get_info(:artist => "Red Hot Chili Peppers", :album => "Mother's Milk")
LastFM::Artist.get_top_fans(:artist => "Gorillaz")
LastFM::Geo.get_events(:location => "Warsaw")
LastFM::User.get_top_albums(:user => "some_user")

Authentication

For some methods Last.fm requires authentication, which is somewhat similar to oAuth:

class SessionsController < ApplicationController
  def new
    redirect_to LastFM.auth_url
  end

  def create
    token = params[:token]
    redirect_to root_path and return if !token || token == ""

    api_session = LastFM::Auth.get_session(:token => token, :api_sig => true)
    api_session = api_session["session"]

    user = User.find_by_username(api_session["name"])
    unless user
      # new user
      user = User.create(:username => api_session["name"])
    end

    session[:user_id]     = user.id
    session[:session_key] = api_session["key"]

    redirect_to root_path
  end
end