ruby-lastfm <img src=“secure.travis-ci.org/youpy/ruby-lastfm.png?rvm=1.9.3” />

A Ruby interface for Last.fm Web Services v2.0

Synopsis

require 'lastfm'

lastfm = Lastfm.new(api_key, api_secret)
token = lastfm.auth.get_token

# open 'http://www.last.fm/api/auth/?api_key=xxxxxxxxxxx&token=xxxxxxxx' and grant the application

lastfm.session = lastfm.auth.get_session(:token => token)['key']

lastfm.track.love(:artist => 'Hujiko Pro', :track => 'acid acid 7riddim')
lastfm.track.scrobble(:artist => 'Hujiko Pro', :track => 'acid acid 7riddim')
lastfm.track.update_now_playing(:artist => 'Hujiko Pro', :track => 'acid acid 7riddim')

# deprecated style
lastfm.track.love('Hujiko Pro', 'acid acid 7riddim')

Supported API Methods

It supports methods which require authentication.

Album

• album.getInfo

Artist

• artist.getEvents

• artist.getInfo

• artist.getSimilar

• artist.getTags

• artist.getTopAlbums

• artist.getTopFans

• artist.getTopTracks

• artist.search

Auth

• auth.getMobileSession

• auth.getToken

• auth.getSession

Event

• event.getInfo

Tag

• tag.getTopArtists

Tasteometer

• tasteometer.compare

Track

• track.addTags

• track.ban

• track.getCorrection

• track.getInfo

• track.getSimilar

• track.getTags

• track.getTopFans

• track.getTopTags

• track.love

• track.removeTag

• track.scrobble

• track.search

• track.share

• track.updateNowPlaying

• track.unlove

User

• user.getFriends

• user.getInfo

• user.getLovedTracks

• user.getNeighbours

• user.getPersonalTags

• user.getRecentTracks

• user.getTopArtists

• user.getTopAlbums

• user.getTopTags

• user.getTopTracks

• user.getWeeklyAlbumList

• user.getWeeklyArtistList

• user.getWeeklyChartList

• user.getWeeklyTrackList

Geo

• geo.getEvents

Library

• library.getArtists

• library.getTracks

Chart

• chart.getHypedArtists

Installation

Archive Installation

rake install

Gem Installation

gem update --system
gem install gemcutter
gem tumble
gem install lastfm

Features/Problems

Comitters

see github.com/youpy/ruby-lastfm/contributors

Note on Patches/Pull Requests

• Fork the project.

• Make your feature addition or bug fix.

• Add tests for it. This is important so I don’t break it in a future version unintentionally.

• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

• Send me a pull request. Bonus points for topic branches.

Copyright

Copyright © 2010 youpy. See LICENSE for details.