Skip to content
Rockstar is a wrapper for the audioscrobbler v2.0 (last.fm) web services. This gem includes scrobbling with the new api.
Ruby
Pull request Compare This branch is 196 commits ahead, 2 commits behind jnunemaker:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples
lib
test
.gitignore
.travis.yml
Gemfile
Gemfile.lock
History.txt
MIT-LICENSE
Manifest
README.md
Rakefile
VERSION
rockstar.gemspec

README.md

Rockstar Build Status Gem Version

Rockstar is a wrapper for the last.fm audioscrobbler web services (http://www.last.fm/api/). This gem is based on the scrobbler gem by John Nunemaker and was updated to use the 2.0 version of the last.fm api

Below is just a sampling of how easy this lib is to use.

Please initialize your api key and secret before using the api:

Rockstar.lastfm = YAML.load_file('lastfm.yml')

Here is an example lastfm.yml:

api_key: "API"
api_secret: "SECRET"

If you want to use the api in an rails app, you could add an initializer in config/initializers/lastm.rb and load a config/lastfm.yml file.

rails_root = ENV['RAILS_ROOT'] || File.dirname(__FILE__) + '/../..'
Rockstar.lastfm =  YAML.load_file(rails_root + '/config/lastfm.yml')

Alternatively you can provide a hash with the api key and secret:

Rockstar.lastfm = {:api_key => "API", :api_secret => "SECRET"}

Users

user = Rockstar::User.new('jnunemaker')

puts "#{user.username}'s Recent Tracks"
puts "=" * (user.username.length + 16)
user.recent_tracks.each { |t| puts t.name }

puts
puts

puts "#{user.username}'s Top Tracks"
puts "=" * (user.username.length + 13)
user.top_tracks.each { |t| puts "(#{t.playcount}) #{t.name}" }

Albums

album = Rockstar::Album.new('Carrie Underwood', 'Some Hearts', :include_info => true)

puts "Album: #{album.name}"
puts "Artist: #{album.artist}"
puts "URL: #{album.url}"
puts "Release Date: #{album.release_date.strftime('%m/%d/%Y')}"

Artists

If you want to load all informations about an artist or any other object, you have to add :include_info => true .

artist = Rockstar::Artist.new('Carrie Underwood', :include_info => true)

puts artist.url

puts 'Top Tracks'
puts "=" * 10
artist.top_tracks.each { |t| puts "(#{t.name}" }

puts

puts 'Similar Artists'
puts "=" * 15
artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }

Tags

tag = Rockstar::Tag.new('country')

puts 'Top Albums'
tag.top_albums.each { |a| puts "(#{a.count}) #{a.name} by #{a.artist}" }

puts

puts 'Top Tracks'
tag.top_tracks.each { |t| puts "(#{t.count}) #{t.name} by #{t.artist}" }

Geo

geo = Rockstar::Geo.new

# Get events for a lat/long
geo.events(:lat => 50.0, :long => 12.3).each{|e| p "#{e.title} at #{e.venue.name}"}

# Get events for a location
geo.events(:location => 'london').each{|e| p "#{e.title} at #{e.venue.name}"}

# To get a list of possible locations use
geo.metros("germany").each{|m| p m.name}

# Retrieve list of top tracks by country
geo.toptracks('united kingdom', 10).each{|t| p "#{t.name} by #{t.artist}"}

# Retrieve list of top artists by country
geo.topartists('united kingdom', 10).each{|a| p "artist #{a.name} with #{a.listenercount} listeners"}

Library

# Get artists and albums for user
library = Rockstar::Library.new

puts 'Artists'
library.artists(false, :user => 'jnunemaker').each { |a| puts a.name }

puts 'Albums'
library.albums(false, :user => 'jnunemaker').each { |a| puts a.name }

# Get it with Rockstar::User
user = Rockstar::User.new('jnunemaker')

puts 'Artists'
user.artists.each { |a| puts a.name }

puts 'Albums'
user.albums.each { |a| puts a.name }

Get rights to access the user data for scrobbing, now playing, events etc...

a = Rockstar::Auth.new
token = a.token

puts
puts "Please open http://www.last.fm/api/auth/?api_key=#{Rockstar.lastfm_api_key}&token=#{token}"
puts
puts "Press enter when done."

gets

session = a.session(token)

You can store the session.key somewhere and use it from now on to identify the user. More details can be found in Rockstar::Auth or examples/scrobble.rb

Tracks

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
puts 'Fans'
puts "=" * 4
track.fans.each { |u| puts "(#{u.weight}) #{u.username}" }

track.love(session.key)

Scrobbling

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
track.scrobble(Time.now, session.key)

Now Playing Submission

track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
track.updateNowPlaying(Time.now, session.key)

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 (c) 2007-2011 John Nunemaker, Bodo "Bitboxer" Tasche, Nick "zapnap" Plante. See LICENSE for details.

Acknowledgements

Thanks to putpat.tv for sponsering the work on the rockstar gem.

Something went wrong with that request. Please try again.