=Scrobbler

Scrobbler is a wrapper for the audioscrobbler web services (http://www.audioscrobbler.net/data/webservices/).

Currently updating to use the 2.0 API. It is very much a work in progress.

Below is just a sampling of how easy this lib is to use, full documentation of all functions is available at http://rdoc.info/projects/xhochy/scrobbler

== Initialization

Scrobbler::Base.api_key = 'foo123'

== Users

user = Scrobbler::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 = Scrobbler::Album.new('Some Hearts', :artist => 'Carrie Underwood', :include_info => true)

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

==Artists

artist = Scrobbler::Artist.new('Carrie Underwood')

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

puts

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

==Geo

geo = Scrobbler::Geo.new()

puts 'Events' puts "=" * 10 geo.events(:location => 'Manchester').each { |e| puts "(#{e.id}) #{e.title}" }

puts

puts 'Top Artists' puts "=" * 10 geo.top_artists(:location => 'Manchester').each { |a| puts "(#{a.name}) #{a.playcount}" }

puts

puts 'Top Tracks' puts "=" * 10 geo.top_tracks(:location => 'Manchester').each { |t| puts "(#{a.name}) #{a.playcount}" }

==Tags

tag = Scrobbler::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}" }

==Tracks

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

== Simple Authentication (for Scrobbling)

work in progress...

== Scrobbling

work in progress...

== Now Playing Submission

work in progress...