qblake / ruby-lastfm

A Ruby interface for Last.fm Web Services

ruby-lastfm <img src=“https://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 Rubies¶ ↑

• 1.9.3

• 2.0.0

• 2.1.0

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.getTopTags

• artist.getTopTracks

• artist.search

Auth¶ ↑

• auth.getMobileSession

• auth.getToken

• auth.getSession

Event¶ ↑

• event.getInfo

Radio¶ ↑

• radio.getPlaylist

Tag¶ ↑

• tag.getTopArtists

• tag.getTopTracks

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.getRecommendedEvents

• user.getRecommendedArtists

• 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

• chart.getHypedTracks

• chart.getLovedTracks

• chart.getTopArtists

• chart.getTopTags

• chart.getTopTracks

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.