No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
This gem is an updated version of jnunemakers scrobbler gem. Rockstar uses v2.0 of the last.fm api.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.0.0

Runtime

>= 0.4.86
>= 0.5.0
>= 0.10.0
 Project Readme

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.